Nginx日志全是代理IP,怎样记录真实访客

接入 CDN 或负载均衡后,Nginx 日志里的来源都变成代理地址,是因为连接直接来自代理。要记录访客来源,需要让 Nginx 只接受可信代理提供的真实地址,同时保留原连接信息;直接把 X-Forwarded-For 第一项当作访客,会给伪造请求头留下机会。

先确认谁提供地址、通过哪个头传递

列清“访客→入口代理→内部代理→本站 Nginx”的实际路径,核对各跳 IP、是否有 IPv6,以及入口如何处理客户端自带的同名头。采用 X-Forwarded-For 时,入口应生成可靠的客户端地址,后续受控代理按约定传递或追加;不能相信未经检查的任意客户端输入。

从代理管理方的当前说明与配置中确认真实头名和回源地址范围。专用头、X-Real-IP、X-Forwarded-For 不能随意互换。本文只演示 HTTP 请求头,不覆盖 PROXY 协议配置。代理地址有变更时,可信清单也要同步核验。

先按实际Nginx实例与配置路径检查确认可执行文件和启动参数。下列命令仅适用于已确认的系统 nginx;原进程带 -c、-p 时,检查命令也要沿用相同参数,面板或容器使用对应入口:

nginx -V 2>&1
sudo nginx -T

检查编译参数是否包含 --with-http_realip_module,定位目标域名配置及原日志位置。模块未启用时先核对安装来源,不直接覆盖安装;整份配置只在受控终端查看。后文 JSON 日志写法需要 Nginx 1.11.8 或以后,实际部署应使用仍受维护的分支。

多级代理,从连接来源逐级判断

假设入口代理是 203.0.113.10,内部代理是 10.20.0.5。访客 198.51.100.23 经过它们,到达源站时 TCP 对端为 10.20.0.5,X-Forwarded-For 内容为:

198.51.100.23, 203.0.113.10

这些都是说明用地址,不是任何 CDN 的可用网段。保存配置备份后,在目标站点已有的 server 块中按实际清单调整;已存在同名指令时修改原位置:

set_real_ip_from 203.0.113.10;
set_real_ip_from 10.20.0.5;
real_ip_header X-Forwarded-For;
real_ip_recursive on;

set_real_ip_from列出能够提供正确地址的可信代理。不要填 0.0.0.0/0、::/0,也不能仅因为“属于内网”就信任整片私网。实际使用 IPv6 回源时,只补充核实过的 IPv6 节点或范围。

直接连接来源可信时,recursive 为 off 会取该头最后一个地址;设为 on 则沿列表从右向左跳过可信代理,取最后一个不可信地址。本例两跳都可信,结果为 198.51.100.23;只信任内部代理时,会停在 203.0.113.10。若 TCP 对端不可信,这个头不能替换客户端地址。

因此,开关不能补救缺失或错误的代理清单。取出的地址是可信接入链报告的来源,可能仍是访客的 NAT 或企业代理出口。

把访客地址和原连接地址同时留下

在实际 http 上下文中定义下面的格式,不把 log_format 塞进 server 或 location:

log_format baole_realip escape=json
  '{"time":"$time_iso8601","client":"$remote_addr",'
  '"peer":"$realip_remote_addr","uri":"$uri",'
  '"status":"$status","xff":"$http_x_forwarded_for"}';

再在目标站点 server 中增加诊断日志,路径换成实际可用位置:

access_log /var/log/nginx/site-a.realip.log baole_realip;

站点级 access_log 会覆盖上层继承设置;要同时保留原日志,需把原有日志配置明确保留在同级。若最终处理请求的 location 自带日志设置,也要核对其实际生效位置,避免以为新增日志覆盖了全部请求。

client是处理后的地址,peer保留原连接地址,xff只作为原始头证据,不直接用于身份判断。JSON 转义避免头里的引号或控制字符破坏日志结构。日志仅供必要人员读取,并纳入轮转;不用查询串、Cookie 或令牌辅助识别。

验收必须包括伪造头对照

先检查再加载。以下只适用于前面已经确认的系统服务;检查失败时不会执行重载:

sudo nginx -t && sudo systemctl reload nginx

从获准测试的客户端,选择已有的无写入测试路径,并确认该次请求会到达源站。将域名和路径替换后,经正常代理入口发送一次带假地址的请求:

curl -q --connect-timeout 5 --max-time 15 -sS -o /dev/null -H 'X-Forwarded-For: 192.0.2.66' 'https://example.com/healthz'

按时间和路径检查新日志:

sudo tail -n 30 /var/log/nginx/site-a.realip.log

本例 peer 应为内部代理,client 应为已核实的测试出口地址,不能变成伪造的 192.0.2.66。若请求被入口缓存直接回答或被拦截,没有源站记录,这次不能算验证通过。

还应在现有规则允许直连的测试环境中,以不在可信清单内的来源作对照;下面的源站 IP 也必须替换。该命令仅对示例域名直连,网络要求强制经过代理时不用它:

curl -q --noproxy example.com --resolve example.com:443:203.0.113.20 --connect-timeout 5 --max-time 15 -sS -o /dev/null -H 'X-Forwarded-For: 192.0.2.66' 'https://example.com/healthz'

成功到达时,client 应保留这个不可信直连来源,与 peer 一致。源站本来只准代理回源时,应保持拒绝,在隔离环境完成对照,不为测试临时放开公网。两种请求都保留证书校验,不加 -k。

realip 会改变 $remote_addr,因此还要验收依赖它的限流、allow/deny 和后端转发。出现误判时恢复本次配置,检查后重载;不能仅看到日志里出现“公网 IP”就结束。后续按日志定位方法保留必要证据,再结束临时详细记录。