隧道管理
Proxy Protocol
Proxy Protocol(PP) 让后端服务(Nginx、自建 TCP 服务等)获取 真实客户端 IP,而不是节点或 frp 的地址。默认 关闭 即可满足绝大多数场景。
Proxy Protocol(PP) 让后端服务(Nginx、自建 TCP 服务等)获取 真实客户端 IP,而不是节点或 frp 的地址。默认 关闭 即可满足绝大多数场景。
何时开启
| 场景 | 建议 |
|---|---|
| 游戏开服(MC 等) | 关闭 |
| 个人 SSH / RDP | 关闭 |
| Nginx 需记录访客 IP | 视配置选 v2 |
| 程序文档要求 PP | 按文档选 v1 或 v2 |
选项说明
| 值 | 说明 |
|---|---|
| 关闭 | 默认,后端看到节点侧地址 |
| v1 | 文本格式,兼容较老软件 |
| v2 | 二进制格式,推荐 |

仅 TCP/UDP
HTTP/HTTPS 隧道通过 X-Forwarded-For 等头传递 IP,不使用 Proxy Protocol 字段。
工作原理(简述)
开启 PP 后,连接建立时会在数据前附加 PP 头;不支持 PP 的服务会协议错乱、直接连不上。
Nginx 示例(v2)
server {
listen 8080 proxy_protocol;
set_real_ip_from 127.0.0.0/8;
real_ip_header proxy_protocol;
# ...
}隧道选 v2,listen 需带 proxy_protocol。修改后重启 Nginx 与 frpc。
排障
| 现象 | 处理 |
|---|---|
| 开启后立即连不上 | 先 关闭 PP 验证;确认后端支持 |
| Nginx 仍显示 127.0.0.1 | 检查 set_real_ip_from 与 real_ip_header |
| 改 PP 后无效 | 停止再启动隧道 / 重启 frpc |