X-Forwarded-For (XFF) 是一个 HTTP 请求头,用于识别通过代理连接到 Web 服务器的客户端的原始 IP 地址。如果没有它,服务器只能看到最后一个代理的 IP。由于该头部设计上暴露了客户端的 IP,因此添加该头部的代理会将您的原始地址传递给目标网站。
链中的每个代理都会附加它接收连接时的 IP 地址。最左侧的条目是声称的客户端,最右侧的是最近的代理,例如 X-Forwarded-For: 203.0.113.195, 198.51.100.178。
标准状态和相关头部
- 事实上的标准: XFF 被广泛使用,但在任何当前规范中都没有定义。
- 转发头部: RFC 7239 定义了一个标准
Forwarded头部,用于相同的信息,但在实践中使用得较少。 - 伴随头部:
X-Forwarded-Host、X-Forwarded-Proto和Via传递相关的代理详细信息。 - 负载均衡器: 一些负载均衡器允许您将客户端 IP 附加到 XFF,保持不变地传递或删除它。
信任与欺骗
客户端可以发送伪造的 X-Forwarded-For 头部,因此只有由受信任的代理添加的地址才是可靠的。使用 XFF 进行速率限制或访问控制的服务器应从右侧读取列表,跳过已知的受信任代理,并将最左侧的值视为不可信。如果服务器也可以直接从互联网访问,则列表中的任何部分都不能被信任。
X-Forwarded-For 的用途
位于代理或负载均衡器后面的服务器仅记录该设备的 IP 地址。XFF 使其能够恢复客户端的地址,以便进行调试、统计和位置相关内容。
在 NGINX 中读取 X-Forwarded-For
NGINX 的 realip 模块用来自 X-Forwarded-For 等头部的地址替换客户端地址。
set_real_ip_from: 列出已知发送正确值的受信任地址。real_ip_header X-Forwarded-For;: 告诉 NGINX 读取哪个头部。real_ip_recursive on;: 使用头部中最后一个不受信任的地址,而不是整体的最后一个地址。
该模块默认未构建。它需要 --with-http_realip_module 构建选项。