服务器与大带宽专家 · 持牌IDC/CDN/ISP服务商
简米科技官网JIANMI TECH
资讯 2026-11-20 简米科技 4,675 字 11 分钟阅读

服务器如何准确获取客户端真实IP地址?真实IP获取方法有哪些?

导读服务器想拿到客户端真实IP,核心就一句话:让每一层代理把来源地址写进标准头部,再让最里层的服务只信任自家边缘节点传来的那段值,做不到这两点,日志里永远是负载均衡的内网地址,为什么服务器读到的IP往往是“假的”客户端和你的服务之间,通常隔着好几层东西,TCP 连接只记录“最近一跳”的地址,剩下的信息全靠应用层头部……

服务器想拿到客户端真实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_protocol
  • real_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 处理,再把结果透传给容器,容器内只做读取不做采信。

分享本文
本文为 简米科技官网 原创,已由运维技术专家审核。转载请注明来源:原文链接
售前咨询 服务热线 售后 邮箱