FastCGI下需用fastcgi_param传真实IP：先用realip模块修正$remote_addr（配置set_real_ip_from、real_ip_header），再在location中设fastcgi_param REMOTE_ADDR $remote_addr等参数，PHP层需适配读取。
FastCGI 场景下还原客户端真实 IP，和 proxy_pass 的 HTTP 反向代理逻辑不同：Nginx 不是用 proxy_set_header，而是通过 fastcgi_param 指令把真实 IP 作为 FastCGI 参数传给 PHP-FPM 或其他 FastCGI 后端。
确认 $remote_addr 已是真实客户端 IP
这是前提。如果 Nginx 前面有 CDN、SLB 或 WAF，$remote_addr 默认是那个中间节点的 IP，不是用户真实 IP。必须先用 realip 模块修正：
- 在
http或server块中添加可信代理段，例如：set_real_ip_from 192.168.0.0/16;set_real_ip_from 203.205.0.0/16;（填你实际的 CDN 或负载均衡出口网段） - 指定从哪个头提取真实 IP：
real_ip_header X-Forwarded-For;或更安全的real_ip_header X-Real-IP; - 开启递归解析：
real_ip_recursive on;
配置生效后，$remote_addr 和 $realip_remote_addr 就会变成用户真实 IP，后续所有 fastcgi_param 才能基于它正确赋值。
用 fastcgi_param 透传真实 IP 到 PHP-FPM
在 location ~ \.php$ 块中，替换或补充默认的 FastCGI 参数：
-
fastcgi_param REMOTE_ADDR $remote_addr;
—— 直接覆盖默认的 REMOTE_ADDR（原为 Nginx 本机地址），让 PHP 的$_SERVER['REMOTE_ADDR']读到真实 IP -
fastcgi_param HTTP_X_REAL_IP $remote_addr;
—— 同时设一个自定义头，便于应用层双重校验（如 Laravel、WordPress 插件常用） -
fastcgi_param HTTP_X_FORWARDED_FOR $proxy_add_x_forwarded_for;
—— 若需保留完整链路，注意这里仍用$proxy_add_x_forwarded_for（它兼容已有头并追加）
⚠️ 不要写成 fastcgi_param REMOTE_ADDR $http_x_forwarded_for —— 这会把逗号分隔的字符串直接塞进 REMOTE_ADDR，导致 PHP 解析异常。
PHP 应用层需主动适配
Nginx 只负责传参，PHP 默认仍信任 REMOTE_ADDR。但若你已用 fastcgi_param REMOTE_ADDR $remote_addr 正确覆盖，大多数框架可直接使用 $_SERVER['REMOTE_ADDR']。
- WordPress：启用
WP_HTTP_HOST或插件（如 “Real IP”）时，会优先读HTTP_X_REAL_IP，建议保持该参数存在 - Laravel：默认不自动识别代理头，需在
TrustProxies中配置：protected $proxies = '**';并确保HTTP_X_FORWARDED_FOR或HTTP_X_REAL_IP已传入 - 自定义脚本：推荐优先读
$_SERVER['HTTP_X_REAL_IP']（经 realip 模块校验过），其次 fallback 到$_SERVER['REMOTE_ADDR']
验证与日志辅助
快速验证是否生效：
- 在 PHP 脚本里临时输出：
var_dump($_SERVER['REMOTE_ADDR'], $_SERVER['HTTP_X_REAL_IP']); - 检查 Nginx access_log 是否记录真实 IP：
确保 log_format 中用了$remote_addr，且 realip 配置已加载（可通过nginx -t和nginx -V | grep http_realip_module确认模块启用） - 若看到
127.0.0.1或内网 IP，说明set_real_ip_from没覆盖到上游代理 IP 段，需补全
