ginx: 最常見的 2 種 http to https 跳轉(zhuǎn)場景

建議點擊 查看原文 查看最新內(nèi)容。

原文鏈接: https://typonotes.com/posts/2023/08/28/nginx-http-https-redirect-scenarios/

1. Nginx 上層無代理， 用戶直接訪問

這種方式比較簡單。

1. 我們對 http 和 https 都具有控權(quán)。
2. 用戶是直接訪問 Nginx 服務(wù)器。

所以可以直接通過在 http server 上配置到 301 跳轉(zhuǎn) 到 https 服務(wù)器即可。

# http server
server {
 listen 80;
 server_name _;
 return 301 https://$host$request_uri;
}

# https server
server {
 listen 443 ssl http2;
 server_name www.example.com;

 # ... other
}

通常， 我個人習(xí)慣將兩個配置寫在同一個文件中。更具體的配置邏輯都放在 https server 中。

2. Nginx 上層有代理

這種情況， 稍微麻煩一點。

1. 最重要的， 用戶并不直接訪問我們的 Nginx Server， 而是通過上層代理 Proxy 代理。
2. 實際提供 HTTPS 服務(wù)的其實是上層 Proxy， 且 我們并沒有管理權(quán)限。
3. 因此， Proxy 在訪問 Nginx Server 的時候， 始終使用 HTTP 協(xié)議。

這種情況下， 我們直接使用 Nginx 提供的 內(nèi)置變量 scheme 就行不通了。

# 錯誤配置
server {
 listen 80;
 server_name _;

 if ($scheme = "http"){
 return 301 https://$host$request_uri; 
 }
}

使用上述配置， 無論用戶通過任何協(xié)議請求， Nginx Server 拿到的都是 http， 即 條件恒等。結(jié)果就是永遠在跳轉(zhuǎn)， 直到重定向次數(shù)過多而報錯。

解決方案就是 使用 Proxy 提供的 Header 進行判斷。不同的 Proxy 提供的 Header 名稱可能不一樣，需要具體分析。

# 可用配置
server {
 listen 80;
 server_name _;

 # ... other

 if ($http_x_forward_scheme = "http"){
 return 301 https://$host$request_uri; 
 }
}

注意: 這里的 http_x_forward_scheme 對應(yīng)的就是 請求頭 中的 X-Forward-Scheme。具體規(guī)則參考 3. Nginx 獲取 Http Header 規(guī)則

3. Nginx 獲取 Http Header 規(guī)則

Nginx 默認提供了獲取 HTTP Header 的方法， 參考文檔 Nginx 各種頭技巧^[1]。

這里做一個總結(jié),

3.1 HTTP Header 轉(zhuǎn) Nginx 變量

默認情況下 變量名遵守以下規(guī)則：

1. 將 Header 名稱 **所有大寫變小些， 所有 - 變 _**，
2. 并 以 http_ 開頭
3. Header 名稱不支持 下劃線

## 正確
Server-Version => http_server_version
X-Forward-Scheme => http_x_forward_scheme
X-Customize-Header => http_x_customize_header

## 錯誤
Server_Verver (x)

如果要支持 Header 名稱下劃線， 需要 額外開啟 語法 underscores_in_headers^[2]

Syntax: underscores_in_headers on | off;
Default: underscores_in_headers off;
Context: http, server

server {
 underscores_in_headers on;
}

開啟之后， 即可使用。

Server_Version => http_server_version

3.2 Header 變量的常規(guī)操作

1. 判斷 header 是否存在

server {
 if ( $x_customize_header ){
 # statement
 }
}

2. 判斷 header 值是否預(yù)期， 參考 nginx if 語法。

server {
 if ( $x_customize_header = "vscode-client/v1.2" ){
 # statement
 }
}

參考文檔

1. Heroku Routing Header: https://devcenter.heroku.com/articles/http-routing
2. Nginx 各種頭技巧: https://liqiang.io/post/nginx-redirect-with-request-header-3c575166
3. Nginx配置：讀取自定義header + 撰寫AND條件 + 修改響應(yīng)體 + 域名重定向: https://segmentfault.com/a/1190000020852253
4. Nginx If-Condition: https://blog.xinac.cn/archives/nginx%E9%85%8D%E7%BD%AE%E4%B8%ADifelse%E7%9A%84%E5%AE%9E%E7%8E%B0%E6%96%B9%E6%B3%95.html
5. Nginx if-is-evil: https://www.nginx.com/resources/wiki/start/topics/depth/ifisevil/
6. Nginx Creating-Nginx-Rewrite-Rules: https://www.nginx.com/blog/creating-nginx-rewrite-rules/
7. Nginx 中的 If 判斷: https://www.ucloud.cn/yun/40533.html

互相吹捧， 共同進步

加我好友， 備注 技術(shù)群 加群一起學(xué)習(xí) Golang, Devops, Docker/K8s。

參考資料