现象:日志里的访客 IP 全变成内网地址
加了一层 Nginx 反向代理之后,业务后台的登录记录、访问日志、IP 限流全部失效,客户端 IP 一栏统一显示 127.0.0.1,容器里跑的话则是 172.17.0.1。同一套代码不经反代直接访问时,IP 是正常的。
原因:上游只看到"最后一跳"的地址
TCP 连接是 Nginx 和 PHP 之间建立的,所以 REMOTE_ADDR 天然就是 Nginx 的地址,跟真实访客无关。真实 IP 需要反代层主动写进请求头,再由程序读取。链路上任何一环没做这件事,IP 就会丢:
- Nginx 没配置
proxy_set_header,请求头根本没传过去; - 程序只读
REMOTE_ADDR,没有读X-Forwarded-For; - 经过 CDN 或多层代理,XFF 变成一个逗号分隔的列表,代码却把整串当成一个 IP。
解决步骤
第一步,在反代层补齐请求头,四个头一起给,缺 Host 还会引起跳转地址错误:
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
第二步,在程序里读第一个地址,XFF 是 客户端, 代理1, 代理2 的顺序,最左边才是访客:
$ip = $_SERVER['HTTP_X_FORWARDED_FOR'] ?? '';
$ip = trim(explode(',', $ip)[0]);
第三步,框架层直接开开关。Spring Boot 加 server.forward-headers-strategy=framework,Django 设置 USE_X_FORWARDED_HOST 并配置可信代理,比手写取值更安全。
第四步,让 Nginx 自己的日志和限流也认真实 IP,否则 limit_req 会把所有请求算到代理头上:
set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;
real_ip_recursive on;
小结
反代场景下 IP 必须靠请求头传递。补头、读头、可信代理三件事都做到,日志和限流才准。注意只信任自己控制的代理网段,否则客户端可以自己伪造 XFF 绕过限流。
验证时可以手工带上头请求一次,看后端打印出来的值是否符合预期:
curl -H "X-Forwarded-For: 1.2.3.4" https://你的域名/ip-test
另外,Nginx 的 access_log 格式如果还写着 $remote_addr,即便程序读到了真实 IP,日志里依然是代理地址。改成 $http_x_forwarded_for 或者先做 real_ip 处理,统计报表才对得上。
