3.5 KiB
3.5 KiB
title, type, tags, last_updated
| title | type | tags | last_updated | |||||
|---|---|---|---|---|---|---|---|---|
| frp | concept |
|
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:
[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:
[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+内网反向代理实现域名访问内网穿透 故障排查章节：
- 确认 frps 监听端口
ss -lntup | grep frps - 确认 token 与 frpc 一致
journalctl -u frps -n 100 - 确认防火墙放行 7000 端口
- telnet 诊断确认连接是否到达 frps
- 强制重启 frps + frpc