ZSFrp 文档
隧道管理

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二进制格式,推荐

1787034241733.png

仅 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

相关文档

On this page