反代后应用把所有访客识别成同一个 IP:真实 IP 与信任代理怎么配

14次阅读
没有评论

典型症状:应用挂在 nginx 反代后面跑,打开访问日志一看,所有访客的 IP 都是 127.0.0.1 或者同一个地址。限流不敢开(一开就把所有人拦了)、封禁没法封(一封封掉整个代理)、日志归因完全失真。

站里两篇旧文(自建RustDesk服务后,怎么补上账号、地址簿和 API 后台?、自托管思维导图 Wmind 部署指南:Docker 半小时跑起来,桌面端断网可用)的 nginx 配置里都出现过 X-Forwarded-For,能干活,但为什么有时候传过去的还是不对、什么时候该信它、信哪一段——这篇把整条链路讲透,顺便贴一个我自己服务器上的真实检查结果。

一、先搞清三层结构和两个变量

访客(真实 IP) → nginx(反代) → 应用(后端)

nginx 转发请求时,有两个和 IP 有关的变量容易混:

  • $remote_addr:nginx 眼里「直接连上来的那个 IP」。只有一层代理、访客直连时,它就是真实访客 IP;有 CDN 或上级代理时,它就是 CDN/代理的 IP
  • $http_x_forwarded_for:请求头里的 X-Forwarded-For,是沿途每一跳追加的 IP 链,格式类似 访客IP, 中间代理IP, ...

nginx 反代时常规配法(本站公共反代配置 proxy.conf 就是这么写的):

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

$proxy_add_x_forwarded_for 的意思是:把 nginx 收到的 XFF 追上自己的 $remote_addr 再传给后端。链路就是这样一跳一跳接起来的。

应用为什么会把所有人看成同一个 IP?两个常见原因:

  1. 应用直接记「连接对端 IP」——后端和 nginx 之间是本机回环或内网,于是每条记录都是 127.0.0.1 / 内网地址
  2. 应用确实读了 XFF,但前面还有一层(CDN、另一台代理),nginx 传过去的「访客 IP」其实已经是代理的 IP,而且这条链可以伪造——不设防地取 XFF 最左边的值,攻击者随手就能塞一个假 IP 进来

二、正确姿势:nginx realip 模块 + 信任清单

nginx 自带 realip 模块(编译参数 --with-http_realip_module),作用是:从可信代理的 XFF 链里还原真实客户端 IP,还原后直接替换 $remote_addr。这样后端、日志、限流全部自动拿对值,应用一行代码都不用改。

# 声明哪些来源是可信代理(按你的实际链路填)
set_real_ip_from 173.245.48.0/20;    # 例:CDN 网段
set_real_ip_from 10.0.0.0/8;         # 例:内网代理
real_ip_header X-Forwarded-For;      # 从这个头还原
real_ip_recursive on;                # 从右往左剔除可信代理,取第一个不可信 IP

三个关键点:

  1. set_real_ip_from 是信任清单,不是摆设。没配它,realip 模块等于白装;配多了(把不可信来源也放进来),等于给伪造 IP 开门
  2. real_ip_recursive on 配合信任清单从右往左找:把链上所有可信代理逐个剔掉,剩下第一个不可信的 IP 就是访客。不开 recursive 只会取紧邻那一跳
  3. 只有 CDN / 上级代理的 IP 段才进清单。访客直连的 nginx(单层结构)根本不需要 realip,$remote_addr 本来就是对的

应用侧如果拿不到 nginx 配置权(托管环境),退而求其次:取 XFF 从右往左跳过已知代理后的第一个 IP,同样别信最左边。

三、本机检查实录:模块装了,但信任清单没配

我按这套标准检查了自己的服务器(nginx -V + 全量 grep 配置),结果很典型:

  • nginx -V 输出里有 --with-http_realip_module → 模块在
  • 全站配置 grep set_real_ip_from / real_ip_header → 零命中 → 清单没配
  • 反代配置里 X-Real-IP / X-Forwarded-For 传得规规矩矩,日志格式记的是 $remote_addr

也就是说:单层直连时一切正常;哪天前面加了 CDN 或上级代理,日志立刻会把代理 IP 当访客——模块都编译好了,就差三行信任配置。这也是我想说的重点:「装了」和「配了」是两回事,和备份要演练一个道理,IP 链路也要真验一次。

四、怎么验证真的生效

配完别想当然,两条实测:

# 1. 模拟一个带 XFF 的请求,看后端应用日志记到的是什么
curl -H "X-Forwarded-For: 1.2.3.4" https://你的应用.example.com/

# 2. 看 nginx 访问日志里 $remote_addr 是否变成预期值
tail -f /path/to/access.log

判定标准:可信代理之外伪造的 XFF(比如上面手写的 1.2.3.4)不应该出现在日志里——它应该在 recursive 剔除后被真实链路覆盖。伪造值进了日志,说明信任清单配宽了。

小结

  • 看到全站同 IP:先分清是「应用记了连接对端」还是「链路上多了你不知道的代理」
  • 修法:set_real_ip_from(只加可信代理段)+ real_ip_header + real_ip_recursive on
  • 应用侧拿不到配置权时:XFF 从右往左取第一个不可信 IP
  • 配完必须 curl + 日志双验证,伪造 IP 进了日志 = 清单配宽了

你站里的反代后面,日志里的 IP 是真的吗?留言报一下你的链路有几层、现在日志记的是谁。

正文完
 0
Ticifer
版权声明:本站原创文章,由 Ticifer 于2026-11-18发表,共计2241字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
腾讯轻量一键开服,热卖套餐配置低至32元/月起
推广 · 腾讯云轻量服务器,一键开服,热卖套餐低至 32 元/月起
评论(没有评论)