当下企业服务、云原生架构中,反向代理(如Nginx、CDN)已成为流量入口的标配,随之而来的“用户真实IP获取”“日志溯源”问题,成为运维、开发团队的核心关注点。很多人在排查异常请求、统计用户来源时,会发现Nginx默认日志里的IP全是代理节点地址,这就不得不提到X-Forwarded-For(简称XFF)头的配置。

X-Forwarded-For是HTTP协议中用于标识请求发起端真实IP的标准请求头,当请求经过多层反向代理(如CDN→负载均衡→Nginx)时,每一层代理都会将上一层的IP追加到XFF头中,最终形成一个IP序列(格式为“客户端真实IP, 第一层代理IP, 第二层代理IP”)。Nginx日志中记录XFF头,本质是捕获这个IP序列,还原请求的完整链路,而非仅显示最后一层代理的IP,这对溯源恶意请求、统计地域流量至关重要。
配置Nginx记录XFF头需分两步,确保安全且准确: 第一步,定义自定义日志格式。在Nginx配置文件(通常为nginx.conf或conf.d/下的站点配置)的http块中,添加包含XFF头的日志格式: nginx http {
log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"';
} 第二步,绑定日志格式到站点。在server块中指定使用该格式记录访问日志: nginx server { listen 80; server_name example.com;
access_log /var/log/nginx/example.com.access.log main;
} 配置后需执行`nginx -t`验证语法,再`nginx -s reload`生效。
XFF头存在被伪造的风险(攻击者可自行构造XFF头传入恶意IP),因此需限制可信代理:在http块中添加`set_real_ip_from`指定可信代理IP段,`real_ip_header X-Forwarded-For`告知Nginx从XFF头中提取真实客户端IP,`real_ip_recursive on`则让Nginx从XFF序列中过滤出第一个非代理的有效IP,避免日志中出现伪造IP。
1. 问:Nginx日志中$http_x_forwarded_for为空是什么原因? 答:若请求未经过反向代理,或代理未正确传递XFF头,会导致该值为空;若代理配置了过滤XFF头的规则,也会出现此情况。 2. 问:XFF头中的多个IP哪个是真实客户端IP? 答:默认情况下,XFF序列的第一个IP为真实客户端IP,但需结合`real_ip_recursive`配置过滤可信代理,避免伪造IP干扰。 3. 问:除了Nginx,其他Web服务器(如Apache)能记录XFF头吗? 答:可以,Apache可通过自定义日志格式(如`%{X-Forwarded-For}i`)实现类似记录,配置逻辑与Nginx类似。