首页/网络/协议速查/X-Real-IP 单一客户端 IP
HTTP 头与缓存70 条

X-Real-IP 单一客户端 IP

Nginx 生态常用字段:只放一个(最后认定的)客户端 IP,比 X-Forwarded-For 列表更好解析。

协议速查网络更新于 2026-10-12
名称X-Real-IP
作用传递单个真实客户端 IP
规范无 RFC(Nginx/fastcgi 生态约定)
对比XFF 是链,X-Real-IP 是单值——取决于最后一跳代理的写法

透传真实 IP

透传真实 IP
location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
后端同时拿到 X-Real-IP 与 XFF 时优先按团队约定取一;最稳做法是边缘节点统一「覆盖」而非「追加」,防止伪造段混入。

数据来源与参考

  • Nginx ngx_http_proxy_module(proxy_set_header)
  • fastcgi_params 默认配置惯例

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌