X-Forwarded-For (XFF) 是一個 HTTP 請求標頭,用於識別通過代理連接到網絡服務器的客戶端的原始 IP 地址。如果沒有它,服務器只會看到最後一個代理的 IP。由於該標頭設計上會暴露客戶端的 IP,因此添加它的代理會將您的原始地址傳遞給目標網站。

每個鏈中的代理都會附加它接收到連接的 IP 地址。最左側的條目是聲稱的客戶端,最右側的是最近的代理,例如 X-Forwarded-For: 203.0.113.195, 198.51.100.178。

標準狀態和相關標頭

  • 事實標準: XFF 被廣泛使用,但在任何當前規範中都沒有定義。
  • Forwarded 標頭: 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 構建選項。

相關術語