腳本之家服務(wù)器常用軟件

快捷導(dǎo)航

解讀Nginx變量字段大全

更新時(shí)間：2025年07月03日 08:36:15 作者：alden_ygq

這篇文章主要介紹了Nginx變量字段,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

一、請(qǐng)求信息變量
二、客戶端信息變量
三、服務(wù)器信息變量
四、響應(yīng)信息變量
五、時(shí)間相關(guān)變量
六、連接相關(guān)變量
七、Nginx 內(nèi)置變量
八、高級(jí)變量
九、自定義變量
使用示例
注意事項(xiàng)
總結(jié)

Nginx 的變量系統(tǒng)功能強(qiáng)大，能夠捕獲請(qǐng)求、響應(yīng)和服務(wù)器狀態(tài)的各種信息。

以下是常用的 Nginx 變量分類整理：

一、請(qǐng)求信息變量

變量名	描述
$host	請(qǐng)求中的主機(jī)名（如example.com），優(yōu)先使用請(qǐng)求行的主機(jī)名，否則使用 server_name。
$request_method	HTTP 請(qǐng)求方法（如GET、POST）。
$request_uri	完整的請(qǐng)求 URI（如/path?query=string）。
$uri	解碼后的請(qǐng)求 URI，可能在處理過(guò)程中被修改（如/path）。
$args	請(qǐng)求中的查詢字符串（如query=string）。
$query_string	同$args。
$request_body	請(qǐng)求體內(nèi)容，需在location中啟用proxy_pass或fastcgi_pass。
$content_type	請(qǐng)求的 Content-Type 頭（如application/json）。
$content_length	請(qǐng)求的 Content-Length 頭。
$request	記錄請(qǐng)求的URL和HTTP協(xié)議
$request_length	用于記錄客戶端請(qǐng)求的總大?。ㄒ宰止?jié)為單位）。這個(gè)變量包含了整個(gè) HTTP 請(qǐng)求的所有部分：請(qǐng)求行、請(qǐng)求頭和請(qǐng)求體。它在日志分析、流量監(jiān)控和安全防護(hù)等場(chǎng)景中非常有用。

二、客戶端信息變量

變量名	描述
$remote_addr	客戶端 IP 地址。
$remote_port	客戶端端口號(hào)。
$http_user_agent	客戶端 User-Agent 頭（如瀏覽器信息）。
$http_referer	客戶端 Referer 頭（來(lái)源頁(yè)面）。
$http_cookie	客戶端 Cookie 頭。

三、服務(wù)器信息變量

變量名	描述
$server_addr	服務(wù)器 IP 地址。
$server_port	服務(wù)器端口號(hào)。
$server_name	匹配請(qǐng)求的 server_name。
$scheme	請(qǐng)求協(xié)議（http或https）。
$server_protocol	請(qǐng)求協(xié)議版本（如HTTP/1.1）。

四、響應(yīng)信息變量

變量名	描述
$status	響應(yīng)狀態(tài)碼（如200、404）。
$body_bytes_sent	發(fā)送給客戶端的響應(yīng)體字節(jié)數(shù)（不包含響應(yīng)頭）。
$bytes_sent	用于記錄發(fā)送給客戶端的總字節(jié)數(shù)，包括響應(yīng)頭和響應(yīng)體。這個(gè)變量在日志記錄、流量統(tǒng)計(jì)和性能監(jiān)控中非常有用。
$sent_http_*	自定義響應(yīng)頭（如$sent_http_content_type）。

五、時(shí)間相關(guān)變量

變量名	描述
$request_time	請(qǐng)求處理時(shí)間（單位：秒，精確到毫秒）。
$msec	當(dāng)前時(shí)間（單位：秒，精確到毫秒）。
$time_iso8601	ISO 8601 格式的時(shí)間（如2023-01-01T12:00:00+08:00）。
$time_local	本地時(shí)間（如01/Jan/2023:12:00:00 +0800）。

六、連接相關(guān)變量

變量名	描述
$connection	連接序列號(hào)。
$connection_requests	當(dāng)前連接上的請(qǐng)求數(shù)量。
$keepalive_requests	持久連接上的請(qǐng)求數(shù)量。
$pipe	用于指示請(qǐng)求的處理方式是通過(guò)管道（piped）還是緩沖（buffered）。這個(gè)變量主要用于調(diào)試和性能分析，特別是在處理大文件或代理請(qǐng)求時(shí)。

七、Nginx 內(nèi)置變量

變量名	描述
$arg_*	獲取請(qǐng)求參數(shù)（如$arg_name獲取?name=value中的value）。
$cookie_*	獲取 Cookie 值（如$cookie_session）。
$http_*	獲取任意請(qǐng)求頭（如$http_accept）。
$sent_http_*	設(shè)置響應(yīng)頭（如add_header Cache-Control $sent_http_cache_control）。

八、高級(jí)變量

變量名	描述
$upstream_addr	上游服務(wù)器地址（如代理后端的 IP: 端口）。
$upstream_response_time	上游服務(wù)器響應(yīng)時(shí)間（多個(gè)上游時(shí)用逗號(hào)分隔）。
$uri_filename	URI 中的文件名部分（如/path/file.txt中的file.txt）。
$request_id	生成唯一請(qǐng)求 ID（用于日志追蹤）。
$upstream_connect_time	Nginx與后游服務(wù)器建立連接所消耗的時(shí)間，其中包含連接握手的時(shí)間，單位為秒。
$upstream_header_time	接收到后端服務(wù)器響應(yīng)頭花費(fèi)的時(shí)間。
$upstream_queue_time	請(qǐng)求保留在upstream隊(duì)列中的時(shí)間。隊(duì)列:如果在處理請(qǐng)求時(shí)無(wú)法立即選擇upstream服務(wù)器，則該請(qǐng)求將被放入隊(duì)列中。如果隊(duì)列已滿，或者在timeout參數(shù)指定的時(shí)間段內(nèi)無(wú)法選擇將請(qǐng)求傳遞給的服務(wù)器，則會(huì)將502（錯(cuò)誤網(wǎng)關(guān)）錯(cuò)誤返回給客戶端。
$http_x_forwarded_for	用于獲取客戶端的真實(shí) IP 地址。在經(jīng)過(guò)代理服務(wù)器（如負(fù)載均衡器、CDN）轉(zhuǎn)發(fā)的請(qǐng)求中，客戶端的原始 IP 會(huì)被記錄在 X-Forwarded-For 請(qǐng)求頭中，而非 $remote_addr（它記錄的是直接連接到 Nginx 的客戶端或代理服務(wù)器的 IP）。
$remote_user	用于獲取通過(guò) HTTP 基礎(chǔ)認(rèn)證（Basic Authentication）驗(yàn)證的用戶名。它在需要用戶身份驗(yàn)證的場(chǎng)景中非常有用，但在使用時(shí)需要注意其生效條件和安全問(wèn)題。
$http_authorization	用于獲取客戶端發(fā)送的 Authorization 請(qǐng)求頭。這個(gè)變量在處理身份驗(yàn)證（如 Basic Auth、Bearer Token、OAuth 等）時(shí)非常重要。

九、自定義變量

通過(guò)set指令定義：

set $my_var "custom_value";

使用示例

在配置中引用變量：

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

access_log /var/log/nginx/access.log main;

location /proxy {
    proxy_pass http://backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

注意事項(xiàng)

變量生效范圍：部分變量（如$request_body）僅在特定模塊或指令中可用。
性能影響：過(guò)度使用復(fù)雜變量（如正則表達(dá)式變量）可能影響性能。
變量嵌套：某些情況下變量嵌套（如$http_$variable）可能不生效，需用map指令處理。

如需查看完整官方文檔，可訪問(wèn)：Nginx Variables

總結(jié)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

您可能感興趣的文章:

欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

解讀Nginx變量字段大全

目錄

一、請(qǐng)求信息變量

二、客戶端信息變量

三、服務(wù)器信息變量

四、響應(yīng)信息變量

五、時(shí)間相關(guān)變量

六、連接相關(guān)變量

七、Nginx 內(nèi)置變量

八、高級(jí)變量

九、自定義變量

使用示例

注意事項(xiàng)

總結(jié)

相關(guān)文章

最新評(píng)論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

解讀Nginx變量字段大全

目錄

一、請(qǐng)求信息變量

二、客戶端信息變量

三、服務(wù)器信息變量

四、響應(yīng)信息變量

五、時(shí)間相關(guān)變量

六、連接相關(guān)變量

七、Nginx 內(nèi)置變量

八、高級(jí)變量

九、自定義變量

使用示例

注意事項(xiàng)

總結(jié)

相關(guān)文章

最新評(píng)論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

一、請(qǐng)求信息變量

二、客戶端信息變量

四、響應(yīng)信息變量

五、時(shí)間相關(guān)變量

六、連接相關(guān)變量

七、Nginx 內(nèi)置變量

八、高級(jí)變量