Auto-sync: 2026-04-26 20:02

wiki/concepts/frp.md

@@ -0,0 +1,98 @@
+---
+title: "frp"
+type: concept
+tags: [networking, open-source, golang, tunneling, self-hosted]
+last_updated: 2026-04-03
+---
+
+## Aliases
+- Fast Reverse Proxy
+- fatedier/frp
+- frps
+- frpc
+
+## Definition
+frp（Fast Reverse Proxy）是一款开源的高性能内网穿透工具，由 Go 语言编写，通过客户端-服务端架构建立反向隧道，使处于 NAT 或防火墙后的内网服务可以被公网访问。包含两个核心组件：frps（服务端，运行在公网 VPS）和 frpc（客户端，运行在内网设备）。
+
+## Core Architecture
+```
+公网用户 → VPS:7000(frps) ←——— 反向隧道 ←——— frpc(内网设备)
+```
+
+## Key Components
+- **frps**（frp server）：运行在公网 VPS，监听 7000 端口（默认），接收 frpc 连接，管理端口映射
+- **frpc**（frp client）：运行在内网设备，主动连接 frps，建立反向隧道
+- **frps.ini / frps.toml**：frps 配置文件
+- **frpc.ini / frpc.toml**：frpc 配置文件
+
+## Supported Protocol Types
+| 类型 | 说明 | 适用场景 |
+|------|------|---------|
+| TCP | 原始 TCP 流量 | SSH、任意 TCP 端口 |
+| UDP | 原始 UDP 流量 | DNS、视频流 |
+| HTTP/HTTPS | 应用层代理 | Web 服务 |
+| STCP | 加密 TCP | 安全内网访问 |
+| SUDP | 加密 UDP | 安全数据传输 |
+| XTCP | P2P UDP | 穿越对称型 NAT |
+
+## Key Configuration Parameters
+**frps.ini**:
+```ini
+[common]
+bind_addr = 0.0.0.0
+bind_port = 7000
+token = <shared_secret>       # 认证 token
+dashboard_addr = 0.0.0.0
+dashboard_port = 7500
+dashboard_user = admin
+dashboard_pwd = <password>
+```
+
+**frpc.ini**:
+```ini
+[common]
+server_addr = <vps_ip>
+server_port = 7000
+token = <shared_secret>      # 必须与 frps 一致
+
+[service_name]
+type = tcp
+local_ip = 127.0.0.1
+local_port = <local_port>
+remote_port = <vps_port>    # VPS 暴露端口
+```
+
+## Version Used in This Wiki
+- **frp v0.65.0**（当前使用版本）
+- 配置文件格式：`frpc.ini` / `frps.ini`（TOML 格式为 v0.52+，本 Wiki 使用 INI 格式）
+
+## 在本 Wiki 中的应用
+- [[通过VPS+内网反向代理实现域名访问内网穿透]]：完整实践指南（frps + Caddy + 阿里云 DNS）
+- [[ubuntu-安装-frp-0-65-0-x86-64-操作笔记]]：Ubuntu frpc 客户端安装配置
+- [[mac-mini-安装-frp-0-65-0-arm64-操作笔记]]：Mac Mini ARM64 安装配置
+- [[家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]]：通过 frp 穿透 Grafana/Prometheus 端口
+
+## SSH 穿透注意事项
+SSH 穿透使用 `type = tcp`，不走 HTTP/HTTPS 代理层（Caddy 不参与）。SSH 连接命令：`ssh -p 60022 user@vps_domain`（`60022` 是 remote_port）。
+
+## Troubleshooting
+详见 [[通过VPS+内网反向代理实现域名访问内网穿透]] 故障排查章节：
+1. 确认 frps 监听端口 `ss -lntup | grep frps`
+2. 确认 token 与 frpc 一致 `journalctl -u frps -n 100`
+3. 确认防火墙放行 7000 端口
+4. telnet 诊断确认连接是否到达 frps
+5. 强制重启 frps + frpc
+
+## Related Concepts
+- [[内网穿透]]：frp 是实现内网穿透的工具
+- [[TCP隧道]]：frp 的 TCP 类型映射建立 TCP 隧道
+- [[反向代理]]：Caddy 通常在 frp 上层提供 HTTPS 访问
+
+## Related Entities
+- [[RackNerd]]：托管 frps 的 VPS 提供商
+- [[VPS]]：运行 frps 的公网服务器
+- [[阿里云 DNS]]：管理 frp 穿透所需的域名解析
+
+## References
+- GitHub: https://github.com/fatedier/frp
+- 文档: https://github.com/fatedier/frp#configuration