反向代理后面拿不到真实 IP 的排查思路
从链路逐跳确认,别急着改后端:先看每一层看到的来源地址是谁。
应用日志里全是 127.0.0.1 或反代的地址,风控、限流、审计全部失真。问题通常不在应用,而在代理链上没有正确传递和信任来源地址。
先画出链路
客户端 → CDN/隧道 → 本地反代 → 应用。每一层都要回答:它看到的对端是谁,它往下传了什么头。
bash
# 在每一层看请求头
curl -H 'X-Forwarded-For: 203.0.113.10' http://127.0.0.1/debug先在反代加一个临时调试端点,返回 $remote_addr 与 $http_x_forwarded_for,比猜快。
nginx 的两种改法
方式一:realip 模块(推荐,$remote_addr 会被替换)
nginx
set_real_ip_from 127.0.0.1; # 只信任本地反代
set_real_ip_from 10.0.0.0/24; # 或隧道出口网段
real_ip_header X-Forwarded-For;
real_ip_recursive on;方式二:手动透传
nginx
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;方式一改的是 nginx 自己看到的地址,方式二只是把头传给后端。两者可以同时用,但不要重复叠加。
信任边界
X-Forwarded-For 是客户端可以伪造的头。只有来自可信代理的请求才可以采信,所以 set_real_ip_from 必须精确,不能写 0.0.0.0/0。
多层代理时,XFF 会变成“客户端, 代理1, 代理2”。用 real_ip_recursive on 从右往左跳过可信地址,取第一个不可信的地址。
多层代理最容易多传一段
每一层都 $proxy_add_x_forwarded_for 是正确做法;但某一层如果直接覆盖成自己的地址,真实 IP 就丢了。检查每一层的配置,而不是只看最后一层。
应用侧
后端要按框架的方式读取可信头,并把代理网段加入信任列表。否则要么读到伪造地址,要么完全不认。
验收
从外网访问,看应用日志里的地址是不是自己的出口 IP;再从内网访问,确认不会被误判为代理地址。两条都对,才算改完。
小结
真实 IP 的问题本质是“信任边界”。先确认每一层看到什么,再决定信任谁、传什么头。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-01-15。