Nginx配置proxy_pass后返回404的問題及解決
項目場景
需求
開發(fā)一個平臺系統(tǒng),前端需要調(diào)用多個來自不同服務(wù)器的接口,為了滿足該需求,需要通過Nginx去轉(zhuǎn)發(fā)代理不同的接口地址,防止跨域,實現(xiàn)多接口的調(diào)用。
在一次生產(chǎn)涉及多次轉(zhuǎn)發(fā)的配置中, 需求是下面的圖:

問題描述
問題
在配置好了 proxy_pass 之后,請求 https://smartaitest.com/aitools 直接返回 404,沒有什么其他的異常。
但是我們直接請求后端 http://ai-ttxt.com/ 是正常響應(yīng)的。
看日志請求也是轉(zhuǎn)發(fā)到了 http://ai-ttxt.com/。但是轉(zhuǎn)發(fā)后的請求響應(yīng)就是404.

在配置nginx接口轉(zhuǎn)發(fā)代理的過程中發(fā)現(xiàn)兩種不同狀況
- 當轉(zhuǎn)發(fā)的地址為 ip 時可正常訪問。
- 當轉(zhuǎn)發(fā)的地址為 域名 時報錯為404。
問題原因
我們的默認的 Nginx的 proxy_set_header 配置是
proxy_set_header Host $host;
當我們是這個的設(shè)置的時候,當?shù)谝粚?Nginx(Nginx1)代理后,我們請求的域名是 www.djx.com(假設(shè)域名) ,從這個請求的 header 獲取到的 host 的值是 www.djx.com, 我們通過 配置將 host 的值設(shè)置為轉(zhuǎn)發(fā) 的Host 值,但是請求的域名 , 也就是 header 里面的是 host 字段 , 請求的域名和 header 里面的 Host 的不一致導(dǎo)致的。

總結(jié)一下 出現(xiàn)兩種情況的原因:
- 當轉(zhuǎn)發(fā)的地址為 ip 時可正常訪問。
- 當轉(zhuǎn)發(fā)的地址為 域名 時報錯為404。
1.當使用 proxy_pass 將請求轉(zhuǎn)發(fā)到 IP 地址時,Nginx 會將請求的 Host 頭信息保持不變地傳遞給后端服務(wù)器。
2.但是當 proxy_pass 設(shè)置為域名時,默認情況下,Nginx 會將請求的 Host 頭信息設(shè)置為當前請求的域名。
這就意味著,如果你使用 proxy_pass 設(shè)置為域名時,Nginx 會將請求的 Host頭信息設(shè)置為當前請求的域名,而不是你指定的域名。這可能會導(dǎo)致后端服務(wù)器無法正確識別請求的來源,從而返回 404 錯誤。
最終造成代理轉(zhuǎn)發(fā)訪問404的問題出現(xiàn)
解決方案
修改Nginx的 proxy_set_header 配置
proxy_set_header Host $proxy_host;
修改前的nginx.conf 配置
server {
listen 99;
server_name _;
client_max_body_size 100m;
access_log /var/log/nginx/access-front.log main;
error_log /var/log/nginx/error-front.log notice;
location /aitools {
alias /opt/html/dist;
index index.html index.htm;
try_files $uri $uri/ /aitools/index.html; #aitools為路由 而不是目錄
}
location /aitools/vapi/ {
proxy_pass http://ai-ttxt.com/; # 替換為實際的后端服務(wù)器地址
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
修改后的配置
server {
listen 99;
server_name _;
client_max_body_size 100m;
access_log /var/log/nginx/access-front.log main;
error_log /var/log/nginx/error-front.log notice;
location /aitools {
alias /opt/html/dist;
index index.html index.htm;
try_files $uri $uri/ /aitools/index.html; #aitools為路由 而不是目錄
}
location /aitools/vapi/ {
proxy_pass http://ai-ttxt.com/; # 替換為實際的后端服務(wù)器地址
proxy_set_header Host $proxy_host; #(需要修改的地方)
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
注意:轉(zhuǎn)發(fā)的接口為 域名沒有其他路徑時,proxy_pass http://ai-ttxt.com/ 的接口地址后最好要將末尾的 /代理進去
proxy_set_header Host $host; 和 proxy_set_header Host $proxy_host; 的區(qū)別
proxy_set_header Host $host; 和 proxy_set_header Host $proxy_host; 在 Nginx 配置中用于設(shè)置代理請求的 Host 頭信息:
- $host 變量: $host 變量表示客戶端發(fā)送請求時的 Host 頭信息,即請求的目標域名。它是 Nginx 內(nèi)置的變量,表示當前請求的主機名。
- $proxy_host 變量: $proxy_host 變量表示 Nginx 代理請求時使用的目標服務(wù)器的主機名或 IP 地址。它是 Nginx 內(nèi)置的變量,表示當前請求中被代理的服務(wù)器的主機名或 IP 地址。
因此,區(qū)別主要在于這兩個變量表示的含義:
- proxy_set_header Host $host; 將請求的 Host 頭信息設(shè)置為客戶端發(fā)送請求時的目標域名。這通常用于將請求的 Host 頭信息傳遞給后端服務(wù)器,以確保后端服務(wù)器能夠正確處理請求。
- proxy_set_header Host $proxy_host; 將請求的 Host 頭信息設(shè)置為 Nginx 代理請求時使用的目標服務(wù)器的主機名或 IP 地址。這通常用于在代理請求時設(shè)置一個自定義的 Host 頭信息,而不是直接使用客戶端發(fā)送的 Host 頭信息。
總結(jié)
以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。
相關(guān)文章
Mac環(huán)境Nginx配置和訪問本地靜態(tài)資源的實現(xiàn)
這篇文章主要介紹了Mac環(huán)境Nginx配置和訪問本地靜態(tài)資源的實現(xiàn),文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-09-09
Nginx 服務(wù)器開啟status頁面檢測服務(wù)狀態(tài)的方法
這篇文章主要介紹了Nginx 服務(wù)器開啟status頁面檢測服務(wù)狀態(tài)的方法,本文給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友參考下吧2024-01-01
詳解nginx同一端口監(jiān)聽多個域名和同時監(jiān)聽http與https
這篇文章主要介紹了詳解nginx同一端口監(jiān)聽多個域名和同時監(jiān)聽http與https的相關(guān)資料,需要的朋友可以參考下2017-05-05

