首页/运维/正文

反向代理后面拿不到真实 IP 的排查思路

从链路逐跳确认,别急着改后端:先看每一层看到的来源地址是谁。

运维排障手册2026-01-15约 2 分钟469 字

应用日志里全是 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。