Nginx 作為反向代理時設置的請求頭

更新時間：2026年02月09日 09:53:39 作者：思靜魚

本文主要介紹了Nginx 作為反向代理時設置的請求頭,主要是三個參數(shù)在Nginx作為反向代理時的作用,分別是Host、X-Real-IP和X-Forwarded-For,這些參數(shù)用于將真實的客戶端信息傳遞給后端應用,以確保后端能夠獲取到正確的客戶端信息,避免誤判和安全問題

		location /api {
                        proxy_pass  http://172.28.3.106:8094;
                        proxy_redirect              http:// https://;
                        proxy_set_header            Host $host:$server_port;
                        proxy_set_header            X-real-ip $remote_addr;
                        proxy_set_header            X-Forwarded-For $proxy_add_x_forwarded_for;
                }

proxy_set_header Host $host:$server_port;

含義：把客戶端請求時的 Host 頭信息 傳給后端。
$host：請求的域名（可能來自 Host 頭，也可能是請求的 IP）。
$server_port：Nginx 接收請求時監(jiān)聽的端口號。
作用：后端應用拿到的 Host 頭和用戶訪問的保持一致，避免后端誤判。

?? 例子：
用戶訪問

http://example.com:8080/api/user

Nginx 轉(zhuǎn)發(fā)時會帶上：

Host: example.com:8080

proxy_set_header X-Real-IP $remote_addr;

含義：告訴后端應用，真實客戶端的 IP 地址。
$remote_addr：Nginx 接收到請求時，客戶端的源 IP。
作用：讓后端知道用戶的真實 IP，而不是只看到 Nginx 的 IP。

?? 例子：
如果用戶 IP 是 203.0.113.5，那么后端會收到：

X-Real-IP: 203.0.113.5

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

含義：傳遞請求經(jīng)過的 代理鏈路中的客戶端 IP 列表。
$proxy_add_x_forwarded_for：會在已有的 X-Forwarded-For 頭后面追加 $remote_addr。
作用：
- 如果請求直接來自客戶端 → 就是客戶端 IP。
- 如果請求經(jīng)過多個代理 → 會形成一個 IP 列表，最后一個就是最近的客戶端。

?? 例子：
用戶 203.0.113.5 → 代理1(Nginx1) → 代理2(Nginx2) → 后端。
后端收到的頭可能是：

X-Forwarded-For: 203.0.113.5, 10.0.0.1, 10.0.0.2

（第一個 IP 永遠是真實用戶的公網(wǎng) IP）

總結

Header 配置	作用	典型用途
Host $host:$server_port	保留客戶端訪問的域名和端口	后端根據(jù)域名/端口做路由或多租戶
X-Real-IP $remote_addr	傳遞客戶端真實 IP	后端日志、風控、限流
X-Forwarded-For $proxy_add_x_forwarded_for	傳遞完整代理鏈路上的客戶端 IP 列表	追蹤用戶來源、防攻擊分析

在實際項目里，Spring Boot 里要拿到 真實客戶端 IP，通常要優(yōu)先?。?/p>