Nginx 反代后程序拿到的客户端 IP 全是 127.0.0.1 怎么解决

现象:日志里的访客 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 处理,统计报表才对得上。

您可以还会对下面的文章感兴趣: