Nginx 的內(nèi)置變量是其配置靈活性的核心，它們提供了豐富的客戶端請(qǐng)求和服務(wù)器狀態(tài)信息。下述表格匯總了這些變量，并附帶了實(shí)用的分類(lèi)和說(shuō)明，方便快速查閱和使用。

1. Nginx 內(nèi)置變量速查表

2. 核心變量詳解與應(yīng)用場(chǎng)景

了解這些變量的典型用法，能幫助你更好地配置Nginx。

• 精確控制：$uri 與 $request_uri
  • $uri反映的是當(dāng)前請(qǐng)求經(jīng)過(guò)Nginx內(nèi)部處理（如重寫(xiě)規(guī)則）后的URI，不帶參數(shù)。它常用于內(nèi)部重定向或作為其他指令的輸入。
  • $request_uri則是客戶端發(fā)來(lái)的原始請(qǐng)求，包含所有參數(shù)，且是只讀的。在構(gòu)建反向代理請(qǐng)求時(shí)，如果你希望原封不動(dòng)地將客戶端請(qǐng)求傳遞給后端，通常會(huì)使用 $request_uri。
• 獲取客戶端真實(shí)IP：$remote_addr 與 $http_x_forwarded_for
  • 當(dāng)客戶端與Nginx服務(wù)器之間沒(méi)有代理時(shí)，$remote_addr就是客戶端的真實(shí)IP。
  • 當(dāng)存在反向代理（如CDN、負(fù)載均衡器）時(shí)，$remote_addr會(huì)是最后一個(gè)代理服務(wù)器的IP。此時(shí)，代理服務(wù)器通常會(huì)將客戶端的原始IP放在 X-Forwarded-For請(qǐng)求頭中，這個(gè)值可以通過(guò) $http_x_forwarded_for變量獲取 。處理多級(jí)代理時(shí)，這個(gè)變量可能包含一個(gè)IP列表。
• 靈活獲取請(qǐng)求頭：$http_name
  • 這是一個(gè)通用變量，name可以替換為任何請(qǐng)求頭字段名的小寫(xiě)字母和下劃線形式。例如，獲取 Accept-Language頭，使用 $http_accept_language。這為根據(jù)請(qǐng)求頭信息做差異化處理提供了極大靈活性。

3. 實(shí)際應(yīng)用舉例

下面通過(guò)幾個(gè)常見(jiàn)場(chǎng)景展示這些變量的用法。

記錄詳細(xì)日志

你可以在 log_format中組合使用變量，記錄更豐富的信息。例如，記錄客戶端IP、用戶代理、請(qǐng)求處理時(shí)間和響應(yīng)狀態(tài)：

log_format main '$remote_addr - $remote_user [$time_local] '
               '"$request" $status $body_bytes_sent '
               '"$http_referer" "$http_user_agent" '
               '$request_time';

訪問(wèn)控制與重定向

根據(jù)參數(shù)重寫(xiě)URL：

if ($arg_version = "v2") {
    rewrite ^/api/(.*)$ /v2/api/$1 last;
}

基于原始IP進(jìn)行訪問(wèn)限制（注意：需確保代理服務(wù)器正確設(shè)置了 X-Forwarded-For）：

# 允許來(lái)自192.168.1.100和10.0.0.0/8網(wǎng)段的請(qǐng)求
if ($http_x_forwarded_for !~* "^(192\.168\.1\.100|10\..*)") {
    return 403;
}

代理配置

在反向代理設(shè)置中，常使用變量向后端傳遞原始請(qǐng)求信息：

location /api/ {
    proxy_pass http://backend_server;
    # 將原始Host頭傳遞給后端
    proxy_set_header Host $host;
    # 傳遞客戶端真實(shí)IP
    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;
}

4. 注意事項(xiàng)

• 變量使用場(chǎng)景：并非所有變量都可以在所有配置指令中使用，具體需參考Nginx官方文檔。
• 條件判斷：在Nginx配置中，尤其是在 if指令中使用變量進(jìn)行字符串匹配或條件判斷時(shí)，需要特別注意Nginx的匹配規(guī)則，有時(shí)可能需要使用 ~*（不區(qū)分大小寫(xiě)匹配）或 ~（區(qū)分大小寫(xiě)匹配）等操作符 。
• 變量性能：大部分內(nèi)置變量開(kāi)銷(xiāo)很小，但頻繁在復(fù)雜邏輯或高并發(fā)場(chǎng)景下使用某些涉及字符串處理的變量仍需注意。

到此這篇關(guān)于Nginx內(nèi)置變量應(yīng)用場(chǎng)景分析的文章就介紹到這了,更多相關(guān)nginx內(nèi)置變量?jī)?nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論