服务器想拿到客户端真实IP,核心就一句话:让每一层代理把来源地址写进标准头部,再让最里层的服务只信任自家边缘节点传来的那段值。做不到这两点,日志里永远是负载均衡的内网地址。
为什么服务器读到的IP往往是“假的”
客户端和你的服务之间,通常隔着好几层东西,TCP 连接只记录“最近一跳”的地址,剩下的信息全靠应用层头部传递。
TCP 层只能看到对端
当用户直连时,$remote_addr(Nginx)或 request.getRemoteAddr()(Java)拿到的确实是用户公网 IP,但只要前面挂了一台反向代理,这个值就变成了代理的内网地址,0.3.17。
常见的几层遮蔽
- 浏览器 → CDN 边缘节点:TCP 对端是 CDN
- CDN → 云负载均衡 SLB/CLB:TCP 对端是 SLB
- SLB → Nginx 反向代理:TCP 对端是 Nginx
- Nginx → 容器内的应用:TCP 对端可能是 Docker 网桥地址
17.0.1
链路越长,remote_addr 越不可信,而 X-Forwarded-For 会随每一跳追加一个地址。
X-Forwarded-For 长什么样
格式是逗号分隔的列表,越往左越靠近真实客户端:
X-Forwarded-For: 203.0.113.45, 10.0.3.17, 172.17.0.1
行业共识认为,最左边是原始客户端,右边依次是经过的代理,问题在于,最左边那段是客户端自己可以伪造的。
nginx如何获取客户端真实IP地址:从配置到验证
这是运维同学问得最多的一类问题,答案不复杂,但要配到位。
第一步:确认代理层数
在内网机器上执行:
curl -H "X-Forwarded-For: 1.1.1.1" http://内网地址/debug
或用 tcpdump -i any -n port 80 抓一次真实请求,看入站包的源地址到底是哪台机器,搞不清有几层代理,后面全是猜。
第二步:启用 realip 模块
确认编译时带了该模块:
nginx -V 2>&1 | grep -o with-http_realip_module
在 http 或 server 块中加入:
set_real_ip_from 10.0.0.0/8; set_real_ip_from 172.16.0.0/12; set_real_ip_from 192.168.0.0/16; real_ip_header X-Forwarded-For; real_ip_recursive on;
三个参数的含义要分清:
set_real_ip_from:声明哪些来源地址是可信代理,只有从这些地址来的请求,头部才被采信real_ip_header:指定用哪个头部取地址,也可以填X-Real-IP或proxy_protocolreal_ip_recursive on:从右往左跳过所有可信代理,取第一个不可信地址
配好后,$remote_addr 会被改写成真实客户端 IP,原始对端地址保留在 $realip_remote_addr。
第三步:日志同时留三份
log_format main '$remote_addr | $realip_remote_addr | $http_x_forwarded_for'
' | $request_time | $request';
只记 $remote_addr 会丢掉链路信息,只记 $http_x_forwarded_for 又可能被伪造,三份一起留,排查和审计都够用。
第四步:应用层同步
Nginx 透传之后,应用框架还得认这个头部,否则 getRemoteAddr() 依旧是内网地址。
Tomcat 在 server.xml 的 Host 里加 Valve:
<Valve className="org.apache.catalina.valves.RemoteIpValve"
remoteIpHeader="X-Forwarded-For"
protocolHeader="X-Forwarded-Proto"
internalProxies="10\.\d+\.\d+\.\d+|172\.(1[6-9]|2\d|3[01])\.\d+\.\d+" />
Spring Boot 项目可以直接在 application.yml 里写:
server: forward-headers-strategy: native
Python 侧用 Werkzeug 的 ProxyFix 中间件,Go 则在中间件里自行解析并覆盖 RemoteAddr。
CDN后面服务器怎么获取真实IP:回源头部的差异
不同 CDN 和代理打出的头部并不统一,直接照抄别人的配置,很容易取到空值。
| 接入产品 | 主要头部 | 说明 |
|---|---|---|
| Nginx 反向代理 | X-Forwarded-For、X-Real-IP | 默认都在,X-Real-IP 只有一个地址 |
| 简米云 SLB 七层 | X-Forwarded-For | 四层 TCP 监听不透传,需开 proxy protocol |
| 酷番云 CLB 七层 | X-Forwarded-For | 与 SLB 行为接近 |
| Cloudflare | CF-Connecting-IP | 优先级高于 XFF |
| 通用标准 | Forwarded(RFC 7239) | 格式为 for=203.0.113.45,兼容性一般 |
实操建议:解析顺序写成“专用头部 → X-Forwarded-For → X-Real-IP”,哪层有值用哪层,别硬编码单一字段。
四层负载均衡还有一条路:开启 PROXY Protocol,它在 TCP 握手前插入一段二进制头,把真实源地址带过来,Nginx 侧用 proxy_protocol 接收:
listen 80 proxy_protocol; set_real_ip_from 10.0.0.0/8; real_ip_header proxy_protocol;
代价是这条链路必须全程支持,中间夹一台不认的设备就会直接连不上。
负载均衡和反向代理获取真实IP有什么区别
很多人把这两者混为一谈,实际差别不小,配错了就是白忙。
四层方案:地址在协议里传
LVS 的 DR 模式、云厂商的四层 TCP 监听,工作在传输层,看不懂 HTTP 头部,它们的做法是:
- 保持源地址转发,或
- 额外封装 PROXY Protocol
优势是性能高,劣势是 HTTPS 卸载和头部改写做不了。
七层方案:地址在头部里传
Nginx、七层 SLB、API 网关这类,会解析 HTTP 报文,主动追加 X-Forwarded-For,灵活,但必须配合 set_real_ip_from 白名单才有意义。
| 维度 | 四层负载均衡 | 七层反向代理 |
|---|---|---|
| 取址方式 | 源地址或 PROXY Protocol | X-Forwarded-For 等头部 |
| 是否可伪造 | 较难 | 头部可被客户端伪造 |
| 改造成本 | 需全链路支持 | 单点配置即可 |
| 适用场景 | 高并发 TCP 转发 | Web 业务、需要灰度与鉴权 |
拿到IP之后,还得做可信校验
只配 real_ip_recursive on 而不设白名单,等于把决定权交给客户端,攻击者随手发一个 X-Forwarded-For: 1.2.3.4,你的风控就失效了。
从右往左取,不要从左往右
正确做法是维护一份可信代理 IP 段列表,从 XFF 最右侧开始往左扫,跳过可信段,遇到的第一个非可信地址才是客户端。
String[] xff = header.split(",");
for (int i = xff.length - 1; i >= 0; i--) {
String ip = xff[i].trim();
if (!trustedProxies.contains(ip)) {
return ip;
}
}
return remoteAddr; // 全部可信,回落到对端地址
反转列表后从左取,是网上流传最广的错误写法,等于直接采用攻击者提供的值。
白名单要跟着架构变
云环境里 SLB 的回源地址段会调整,容器重建后 Pod IP 也会变,业内专家指出,把可信段做成配置文件并定期核对,比写死在代码里稳妥得多,Kubernetes 场景可以用 podCIDR 配合 NetworkPolicy 一起管。
别忽视 IPv6
0.113.45 之外,2408:xxxx::1 这类地址同样会出现在头部里,正则里只匹配 IPv4,取出来就是空字符串,日志会出现大片空白。
云上部署的地域与成本差异
同一套配置,放在不同云厂商、不同地域,细节会有偏差。
- 国内地域的 CDN 一般默认回源带 XFF,海外节点有的只带
CF-Connecting-IP - 部分厂商的四层监听需要单独提工单开启源地址透传
- 安全组和 WAF 的串联顺序会影响头部是否被清洗
成本方面,七层负载均衡和 CDN 透传真实 IP 通常不单独收费,账单大头在 CDN 流量和 WAF 按量计费上,企业级 WAF 若开启“源站保护”模式,回源头部会被重写,需要单独确认规则,这类咨询在实施前问清楚,能省掉一轮返工。
服务器获取客户端真实IP地址的常见疑问
Q1:为什么配了 realip 模块,日志里还是内网地址?
多数情况是 set_real_ip_from 没覆盖到实际代理的网段,或者 real_ip_header 写的头部代理根本没传,先在 Nginx 加一行 add_header X-Debug-XFF $http_x_forwarded_for always; 看请求到底带了什么。
Q2:X-Forwarded-For 和 X-Real-IP 该用哪个?
单层代理用 X-Real-IP 更简单,多层链路必须用 X-Forwarded-For,两者同时存在时,先校验 XFF 的可信段,再考虑回落。
Q3:客户端伪造 XFF 会造成什么后果?
如果服务端不做白名单校验,伪造值会进入日志、限流、风控和审计系统,轻则统计数据失真,重则绕过基于 IP 的访问控制,把内网接口暴露出去。
Q4:容器环境下取到的为什么总是 172.17.0.1?
这是 Docker 默认网桥的网关地址,请求先经过宿主机 NAT 才进容器,需要在 Ingress 或宿主机侧完成 realip 处理,再把结果透传给容器,容器内只做读取不做采信。