NGINX未填充X-Forwarded-For字段问题排查求助

你配置了NGINX的real_ip相关指令，但PHP的$_SERVER数组中未出现预期的X-Forwarded-For相关内容，结合你的配置和输出信息，以下是可能的原因及解决办法：

1. real_ip模块的核心作用是替换REMOTE_ADDR，而非传递X-Forwarded-For到PHP #

NGINX的real_ip系列指令并非用来将X-Forwarded-For头直接传给PHP，它的逻辑是：

• 当请求来自set_real_ip_from指定的信任IP时，会读取real_ip_header定义的头（这里是X-Forwarded-For），将REMOTE_ADDR替换为该头中的真实客户端IP。
• 若请求未携带X-Forwarded-For头（比如直接从浏览器访问NGINX，无前置代理/CDN），real_ip模块不会触发，REMOTE_ADDR会保持为请求的来源IP（即你配置的192.168.78.1）。

2. 需手动配置NGINX传递X-Forwarded-For到PHP #

默认情况下，NGINX不会自动将X-Forwarded-For头传递给PHP-FPM。要让PHP获取到这个头，需在站点配置的location ~ \.php$块中添加对应的fastcgi_param指令：

location ~ \.php$ {
    # 保留原有fastcgi配置
    fastcgi_param HTTP_X_FORWARDED_FOR $http_x_forwarded_for;
}

添加后重启NGINX，PHP的$_SERVER['HTTP_X_FORWARDED_FOR']即可读取到请求中的X-Forwarded-For头内容。

3. 当前请求未携带X-Forwarded-For头 #

从你的$_SERVER输出看，仅存在空值的HTTP_X_FORWARDED字段，无HTTP_X_FORWARDED_FOR，说明当前请求并未发送X-Forwarded-For头：

• 若你的架构是浏览器直接访问NGINX，无前置代理/CDN，浏览器不会主动发送该头，此时real_ip配置无效，因为没有可读取的目标头。
• 若有前置代理，需确认前置代理是否正确发送了X-Forwarded-For头，而非类似的X-Forwarded头（你输出中出现的空字段可能与此有关）。

4. NGINX未加载real_ip模块 #

如果NGINX编译时未加入--with-http_realip_module，你配置的set_real_ip_from等指令会被忽略，无法生效。可通过以下命令检查：

nginx -V 2>&1 | grep http_realip_module

若输出无--with-http_realip_module，需重新编译NGINX并添加该模块，或安装包含该模块的NGINX版本。

内容的提问来源于stack exchange，提问作者Patrik Laszlo