變量是編程語(yǔ)言的自然組成部分。變量是在 Perl、C/C++、Bourne shell、Perl 等語(yǔ)言中保存各種值的容器。值可以是像“hello world”這樣的字符串，像 3.14 這樣的數(shù)字，甚至是復(fù)雜的東西，比如在這些語(yǔ)言中對(duì)數(shù)組或哈希表的引用。
然而，對(duì)于 Nginx 配置語(yǔ)言，變量只能保存一種類(lèi)型的值，即字符串。但有一個(gè)有趣的例外：第三方模塊 ngx_array_var 擴(kuò)展的 Nginx 變量包含數(shù)組。
假設(shè)我們的 nginx.conf 配置文件，其中包含以下行：
set $a "hello world";
在這里，我們通過(guò)來(lái)自標(biāo)準(zhǔn) nginx_rewrite 模塊的 set 配置指令為變量“$a”賦值。在這里，我們將字符串值“hello world”分配給“$a”。
從上面的例子中，我們可以看到 Nginx變 量名前面帶了一個(gè)美元符號(hào)（$）。因此，每當(dāng)我們想在配置文件中添加對(duì) nginx 變量的引用時(shí)，我們必須添加一個(gè)美元 ($) 前綴。
讓我們看另一個(gè)簡(jiǎn)單的例子，
set $a hello; set $b "$a, $a";
讓我們看看 Nginx 中的變量列表：
多變的描述
| 變量 | 描述 |
| $ancient_browser | 如果瀏覽器被識(shí)別為古瀏覽器，則此變量用于等于由 ancient_browser_value 指令設(shè)置的值。 |
| $arg_name | 請(qǐng)求行中參數(shù)的名稱(chēng)。 |
| $args | 請(qǐng)求行上的參數(shù)列表。 |
| $binary_remote_addr (ngx_http_core_module) | 二進(jìn)制形式的客戶(hù)端地址。IP4 地址的值長(zhǎng)度始終為 4 個(gè)字節(jié)，IPv6 地址的值長(zhǎng)度始終為 16 個(gè)字節(jié)。 |
| $binary_remote_addr (ngx_stream_core_module) | 二進(jìn)制形式的客戶(hù)端地址。IP4 地址的值長(zhǎng)度始終為 4 個(gè)字節(jié)，IPv6 地址的值長(zhǎng)度始終為 16 個(gè)字節(jié)。 |
| $body_bytes_sent | 發(fā)送到客戶(hù)端的字節(jié)數(shù)，不計(jì)算響應(yīng)頭。 |
| $bytes_received | 從客戶(hù)端接收的字節(jié)數(shù)。 |
| $bytes_sent (ngx_http_core_module) | 發(fā)送到客戶(hù)端的字節(jié)數(shù)。 |
| $bytes_sent (ngx_http_log_module) | 發(fā)送到客戶(hù)端的字節(jié)數(shù)。 |
| $bytes_sent (ngx_stream_core_module) | 發(fā)送到客戶(hù)端的字節(jié)數(shù)。 |
| $connection (ngx_http_core_module) | 連接序列號(hào) |
| $connection (ngx_http_log_module) | 連接序列號(hào) |
| $connection (ngx_stream_core_module) | 連接序列號(hào) |
| $connection_requests (ngx_http_core_module) | 當(dāng)前通過(guò)連接發(fā)出的請(qǐng)求數(shù)。 |
| $connection_requests (ngx_http_log_module) | 當(dāng)前通過(guò)連接發(fā)出的請(qǐng)求數(shù)。 |
| $connections_active | 與活動(dòng)連接值相同 |
| $connections_reading | 與讀取值相同 |
| $connections_waiting | 與等待值相同 |
| $connections_writing | 與寫(xiě)入值相同。 |
| $content_length | “內(nèi)容長(zhǎng)度”請(qǐng)求頭字段。 |
| $content_type | “內(nèi)容類(lèi)型”請(qǐng)求頭域 |
| $cookie_name | 餅干的名字 |
| $date_gmt | GMT（格林威治標(biāo)準(zhǔn)時(shí)間）的當(dāng)前時(shí)間。要設(shè)置格式，請(qǐng)使用帶有timefmt參數(shù)的config命令。 |
| $date_local | 本地時(shí)區(qū)的當(dāng)前時(shí)間。要設(shè)置格式，請(qǐng)使用帶有timefmt參數(shù)的config命令。 |
| $document_root | 當(dāng)前請(qǐng)求的 root 或 alias 指令的值。 |
| $document_uri | 它與 $uri 相同。 |
| $fastcgi_path_info | 使用 fastcgi_split_path_info 指令時(shí)，$fastcgi_script_name 變量等于該指令設(shè)置的第一個(gè)捕獲的值。以及由 fastcgi_split_path_info 指令設(shè)置的第二次捕獲的值。此變量用于設(shè)置 PATH_INFO 參數(shù)。 |
| $fastcgi_script_name | 請(qǐng)求 URI（統(tǒng)一資源標(biāo)識(shí)符），或者，如果 URI 以斜杠結(jié)尾，則請(qǐng)求 URI 并附加由 fastcgi_index 指令配置的索引文件名。 |
| $geoip_area_code (ngx_http_geoip_module) | 電話(huà)區(qū)號(hào)（僅限美國(guó)）。此變量可能包含一些過(guò)時(shí)的信息，因?yàn)橄鄳?yīng)的數(shù)據(jù)庫(kù)字段已被棄用。 |
| $geoip_area_code (ngx_stream_geoip_module) | 電話(huà)區(qū)號(hào)（僅限美國(guó)）。此變量可能包含過(guò)時(shí)的信息，因?yàn)椴煌扑]使用相應(yīng)的數(shù)據(jù)庫(kù)字段。 |
| $geoip_city (ngx_http_geoip_module) | 城市名稱(chēng)，例如“華盛頓”、“莫斯科”。 |
| $geoip_city (ngx_stream_geoip_module) | 城市名稱(chēng)，例如“華盛頓”、“莫斯科”。 |
| $geoip_city_continent_code (ngx_http_geoip_module) | 兩個(gè)字母的大陸代碼。例如，“NA”、“EU”。 |
| $geoip_city_continent_code (ngx_stream_geoip_module) | 兩個(gè)字母的大陸代碼。例如，“NA”、“EU”。 |
| $geoip_city_country_code (ngx_http_geoip_module) | 兩個(gè)字母的大陸代碼。例如，“NA”、“EU”。 |
| $geoip_city_country_code (ngx_http_geoip_module) | 兩個(gè)字母的國(guó)家/地區(qū)代碼。例如，“RU”、“美國(guó)”。 |
| $geoip_city_country_code (ngx_stream_geoip_module) | 兩個(gè)字母的國(guó)家/地區(qū)代碼。例如，“RU”、“美國(guó)”。 |
| $geoip_city_country_code3 (ngx_http_geoip_module) | 三個(gè)字母的國(guó)家/地區(qū)代碼。例如，“俄羅斯”、“美國(guó)”。 |
| $geoip_city_country_code3 (ngx_stream_geoip_module) | 三個(gè)字母的國(guó)家/地區(qū)代碼。例如，“俄羅斯”、“美國(guó)”。 |
| $geoip_city_country_name (ngx_http_geoip_module) | 國(guó)家名稱(chēng)。例如，“印度”、“美國(guó)”。 |
| $geoip_city_country_name (ngx_stream_geoip_module) | 國(guó)家名稱(chēng)。例如，“印度”、“美國(guó)”。 |
| $geoip_country_code (ngx_http_geoip_module) | 兩個(gè)字母的國(guó)家/地區(qū)代碼。例如，“RU”、“美國(guó)”。 |
| $geoip_country_code (ngx_stream_geoip_module) | 兩個(gè)字母的國(guó)家/地區(qū)代碼。例如，“RU”、“美國(guó)”。 |
| $geoip_country_code3 (ngx_http_geoip_module) | 三個(gè)字母的國(guó)家/地區(qū)代碼。例如，“俄羅斯”、“美國(guó)”。 |
| $geoip_country_code3 (ngx_stream_geoip_module) | 三個(gè)字母的國(guó)家/地區(qū)代碼。例如，“俄羅斯”、“美國(guó)”。 |
| $geoip_country_name (ngx_http_geoip_module) | 國(guó)家名稱(chēng)。例如，“印度”、“美國(guó)”。 |
| $geoip_country_name (ngx_stream_geoip_module) | 國(guó)家名稱(chēng)。例如，“印度”、“美國(guó)”。 |
| $geoip_dma_code (ngx_http_geoip_module) | 根據(jù) Google AdWords API 中的地理定位，它是美國(guó)的 DMA（指定市場(chǎng)區(qū)域）代碼或地鐵代碼。 |
| $geoip_dma_code (ngx_stream_geoip_module) | 根據(jù) Google AdWords API 中的地理定位，它是美國(guó)的 DMA（指定市場(chǎng)區(qū)域）代碼或地鐵代碼。 |
| $geoip_latitude (ngx_http_geoip_module) | 緯度。 |
| $geoip_latitude (ngx_stream_geoip_module) | 緯度。 |
| $geoip_longitude (ngx_http_geoip_module) | 經(jīng)度 |
| $geoip_longitude (ngx_stream_geoip_module) | 經(jīng)度 |
| $geoip_org (ngx_http_geoip_module) | 組織名稱(chēng)。例如“加州大學(xué)”。 |
| $geoip_org (ngx_stream_geoip_module) | 組織名稱(chēng)。例如“加州大學(xué)”。 |
| $geoip_postal_code (ngx_http_geoip_module) | 郵政編碼。 |
| $geoip_postal_code (ngx_stream_geoip_module) | 郵政編碼。 |
| $geoip_region (ngx_http_geoip_module) | 地區(qū)名稱(chēng)（省、地區(qū)、州、聯(lián)邦土地、領(lǐng)土），例如，莫斯科市，DC。 |
| $geoip_region (ngx_stream_geoip_module) | 地區(qū)名稱(chēng)（省、地區(qū)、州、聯(lián)邦土地、領(lǐng)土），例如，莫斯科市，DC。 |
| $geoip_region_name (ngx_http_geoip_module) | 國(guó)家/地區(qū)名稱(chēng)（（省、地區(qū)、州、聯(lián)邦土地、領(lǐng)土），例如“莫斯科市”、“哥倫比亞特區(qū)”。 |
| $geoip_region_name (ngx_stream_geoip_module) | 國(guó)家/地區(qū)名稱(chēng)（（省、地區(qū)、州、聯(lián)邦土地、領(lǐng)土），例如“莫斯科市”、“哥倫比亞特區(qū)”。 |
| $gzip_ratio | 它是實(shí)現(xiàn)的壓縮率，計(jì)算為原始響應(yīng)大小和壓縮響應(yīng)大小之間的比率。 |
| $host | 來(lái)自請(qǐng)求行的主機(jī)名，來(lái)自主機(jī)請(qǐng)求頭字段的主機(jī)名，或匹配請(qǐng)求的服務(wù)器名。 |
| $hostname (ngx_http_core_module) | 主機(jī)名。 |
| $hostname（ngx_stream_core_module） | 主機(jī)名。 |
| $http2 | 協(xié)商協(xié)議標(biāo)識(shí)符：h2 表示基于 TLS 的 HTTP/2，h2c 表示基于明文 TCP 的 HTTP/2，否則為空字符串。 |
| $http_name | 它是任意的請(qǐng)求頭字段：變量名的最后一部分是字段名，它被轉(zhuǎn)換為小寫(xiě)，破折號(hào)被下劃線(xiàn)代替。 |
| $https | 如果連接在 SSL 模式下運(yùn)行，則它為“on”，否則為空字符串。 |
| $invalid_referer | 如果認(rèn)為“Referer”請(qǐng)求頭字段值有效，則字符串為空，否則為 1。 |
| $is_args | “？” 如果請(qǐng)求行有參數(shù)，否則為空字符串。 |
| $jwt_claim_name | 它返回指定 JWT（JSON Web 令牌）聲明的值。 |
| $jwt_header_name | 返回指定 JOSE（JavaScript 對(duì)象簽名和加密）標(biāo)頭的值。 |
| $limit_rate | 設(shè)置此變量可啟用響應(yīng)率限制。 |
| $memcached_key | 定義從 memcached 服務(wù)器獲取響應(yīng)的鍵。 |
| $modern_browser | 如果瀏覽器被識(shí)別為現(xiàn)代瀏覽器，則等于由 modern_browser_value 指令設(shè)置的值。 |
| $msec（ngx_http_core_module） | 當(dāng)前時(shí)間（以秒為單位），分辨率為 ms（毫秒）。 |
| $msec（ngx_http_log_module） | 以秒為單位的時(shí)間，日志寫(xiě)入時(shí)的毫秒分辨率。 |
| $msec（ngx_stream_core_module） | 當(dāng)前時(shí)間（以秒為單位），分辨率為 ms（毫秒）。 |
| $msie | 如果瀏覽器被識(shí)別為任何版本的 MSIE (Microsoft Internet Explorer)，則等于 1。 |
| $nginx_version (ngx_http_core_module) | 顯示nginx版本 |
| $nginx_version (ngx_stream_core_module) | Nginx 版本。 |
| $pid (ngx_http_core_module) | 工作進(jìn)程的PID（進(jìn)程ID）。 |
| $pid (ngx_stream_core_module) | 工作進(jìn)程的PID（進(jìn)程ID）。 |
| $pipe (ngx_http_core_module) | “p”如果請(qǐng)求是流水線(xiàn)的，“。” 否則。 |
| $pipe (ngx_http_log_module) | “p”如果請(qǐng)求是流水線(xiàn)的，“。” 否則。 |
| $protocol | 用于與客戶(hù)端通信的協(xié)議：UDP 或 TCP。 |
| $proxy_add_x_forwarded_for | 附加了 $remote_addr 變量的“X-Forwarded-For”客戶(hù)端請(qǐng)求標(biāo)頭字段，用逗號(hào)分隔。如果客戶(hù)端請(qǐng)求標(biāo)頭中不存在“X-Forwarded-For”字段，則 $proxy_add_x_forwarded_for 變量等于 $remote_addr 變量。 |
| $proxy_host | proxy_pass 指令中指定的代理服務(wù)器的名稱(chēng)和端口。 |
| $proxy_port | proxy_pass 指令中指定的代理服務(wù)器的端口，或協(xié)議的默認(rèn)端口。 |
| $proxy_protocol_addr (ngx_http_core_module) | 來(lái)自 PROXY 協(xié)議標(biāo)頭的客戶(hù)端地址，否則為空字符串。必須先啟用 PROXY 協(xié)議。這可以通過(guò)在 listen 指令中設(shè)置代理協(xié)議參數(shù)來(lái)完成。 |
| $proxy_protocol_addr (ngx_stream_core_module) | 來(lái)自 PROXY 協(xié)議標(biāo)頭的客戶(hù)端地址，否則為空字符串。必須先啟用 PROXY 協(xié)議。這可以通過(guò)在 listen 指令中設(shè)置代理協(xié)議參數(shù)來(lái)完成。 |
| $proxy_protocol_port (ngx_http_core_module) | 來(lái)自 PROXY 協(xié)議標(biāo)頭的客戶(hù)端地址，否則為空字符串。必須先啟用 PROXY 協(xié)議。這可以通過(guò)在 listen 指令中設(shè)置代理協(xié)議參數(shù)來(lái)完成。 |
| $proxy_protocol_port (ngx_stream_core_module) | 來(lái)自 PROXY 協(xié)議標(biāo)頭的客戶(hù)端地址，否則為空字符串。必須先啟用 PROXY 協(xié)議。這可以通過(guò)在 listen 指令中設(shè)置代理協(xié)議參數(shù)來(lái)完成。 |
| $query_string | 與 $args 相同 |
| $realip_remote_addr (ngx_http_realip_module) | 它用于保留原始客戶(hù)端地址。 |
| $realip_remote_addr (ngx_stream_realip_module) | 它用于保留原始客戶(hù)端地址。 |
| $realip_remote_port (ngx_http_realip_module) | 它用于保留原始客戶(hù)端地址。 |
| $realip_remote_port (ngx_stream_realip_module) | 它用于保留原始客戶(hù)端地址。 |
| $realpath_root | 與當(dāng)前請(qǐng)求的別名或根指令值相對(duì)應(yīng)的絕對(duì)路徑名，所有符號(hào)鏈接都解析為實(shí)際路徑。 |
| $remote_addr (ngx_http_core_module) | 客戶(hù)地址 |
| $remote_addr (ngx_stream_core_module) | 客戶(hù)地址 |
| $remote_port (ngx_http_core_module) | 客戶(hù)端端口 |
| $remote_port (ngx_stream_core_module) | 客戶(hù)端端口 |
| $remote_user | 基本身份驗(yàn)證提供的用戶(hù)名。 |
| $request | 完整的原始請(qǐng)求行。 |
| $request_body | 當(dāng)請(qǐng)求正文被讀取到 memory_buffer 時(shí)，該變量的值在由 proxy_pass 和 scgi_pass 指令處理的位置中可用。 |
| $request_body_file | 帶有請(qǐng)求正文的臨時(shí)文件的名稱(chēng)。 |
| $request_completion | 如果請(qǐng)求已完成，則值為“OK”，否則為空字符串。 |
| $request_filename | 當(dāng)前請(qǐng)求的文件路徑，基于根或別名指令，以及請(qǐng)求 URI。 |
| $request_id | 從 16 個(gè)隨機(jī)字節(jié)生成的唯一請(qǐng)求標(biāo)識(shí)符，以十六進(jìn)制表示。 |
| $request_length (ngx_http_core_module) | 請(qǐng)求長(zhǎng)度（請(qǐng)求行、請(qǐng)求正文和標(biāo)頭）。 |
| $request_length (ngx_http_log_module) | 請(qǐng)求長(zhǎng)度（請(qǐng)求行、請(qǐng)求正文和標(biāo)頭）。 |
| $request_method | 請(qǐng)求方法。通常是“GET”或“POST”。 |
| $request_time (ngx_http_core_module) | 以毫秒為單位的請(qǐng)求處理時(shí)間；從客戶(hù)端讀取第一個(gè)字節(jié)以來(lái)經(jīng)過(guò)的時(shí)間。 |
| $request_time (ngx_http_log_module) | 以毫秒為單位的請(qǐng)求處理時(shí)間；從客戶(hù)端讀取第一個(gè)字節(jié)到最后一個(gè)字節(jié)發(fā)送到客戶(hù)端后寫(xiě)入日志之間經(jīng)過(guò)的時(shí)間。 |
| $request_uri | 帶有參數(shù)的完整原始請(qǐng)求 URI（統(tǒng)一資源標(biāo)識(shí)符）。 |
| $scheme | 請(qǐng)求方案可能是 http 或 https |
| $secure_link | 顯示鏈接檢查的狀態(tài)，其值取決于所選的操作模式。 |
| $secure_link_expires | 請(qǐng)求中傳遞的鏈接的生命周期； |
| $sent_http_name | 它是任意的響應(yīng)頭域；變量名的最后一部分是轉(zhuǎn)換為小寫(xiě)的字段名稱(chēng)，破折號(hào)由下劃線(xiàn)代替。 |
| $sent_trailer_name | 響應(yīng)結(jié)束時(shí)發(fā)送的任意字段；變量名的最后一部分是轉(zhuǎn)換為小寫(xiě)的字段名稱(chēng)，破折號(hào)由下劃線(xiàn)代替。 |
| $server_addr (ngx_http_core_module) | 接受請(qǐng)求的服務(wù)器地址。計(jì)算這個(gè)變量的值需要一個(gè)系統(tǒng)調(diào)用。 |
| $server_addr (ngx_stream_core_module) | 接受請(qǐng)求的服務(wù)器地址。計(jì)算這個(gè)變量的值需要一個(gè)系統(tǒng)調(diào)用。 |
| $server_name | 接受請(qǐng)求的服務(wù)器名稱(chēng)。 |
| $server_port (ngx_http_core_module) | 接受請(qǐng)求的服務(wù)器端口。 |
| $server_port (ngx_stream_core_module) | 接受連接的服務(wù)器端口。 |
| $server_protocol | 它是一個(gè)請(qǐng)求協(xié)議，通常是 HTTP/1.0、HTTP/1.1 或 HTTP/2.0。 |
| $session_log_binary_id | 二進(jìn)制形式的當(dāng)前會(huì)話(huà) ID。 |
| $session_log_id | 當(dāng)前會(huì)話(huà) ID。 |
| $session_time | 以毫秒為單位的會(huì)話(huà)持續(xù)時(shí)間，精度為毫秒。 |
| $slice_range | HTTP 字節(jié)范圍格式的當(dāng)前切片范圍。例如字節(jié)=0-1048575 |
| $spdy | SPDY（發(fā)音為快速）連接的 SPDY 協(xié)議版本，否則為空字符串。 |
| $spdy_request_priority | 請(qǐng)求 SPDY（發(fā)音為快速）連接的優(yōu)先級(jí)，否則為空字符串。 |
| $ssl_cipher (ngx_http_ssl_module) | 返回用于已建立的 SSL（安全套接字層）連接的密碼字符串。 |
| $ssl_cipher (ngx_stream_ssl_module) | 返回用于已建立的 SSL（安全套接字層）連接的密碼字符串。 |
| $ssl_ciphers (ngx_http_ssl_module) | 它將返回客戶(hù)端支持的密碼列表。這里，已知密碼按名稱(chēng)列出，未知密碼以十六進(jìn)制顯示，例如，AES128-SHA:AES256-SHA:0x00ff |
| $ssl_ciphers (ngx_stream_ssl_module) | 它將返回客戶(hù)端支持的密碼列表。這里，已知密碼按名稱(chēng)列出，未知密碼以十六進(jìn)制顯示，例如，AES128-SHA:AES256-SHA:0x00ff |
| $ssl_client_cert (ngx_http_ssl_module) | 它會(huì)返回在PEM（增強(qiáng)保密郵件）的客戶(hù)端證書(shū)建立SSL連接，其中每行除了1日前面添加制表符。 |
| $ssl_client_cert (ngx_stream_ssl_module) | 它會(huì)返回在PEM（增強(qiáng)保密郵件）的客戶(hù)端證書(shū)建立SSL連接，其中每行除了1日前面添加制表符。 |
| $ssl_client_escaped_cert | 它將為已建立的 SSL 連接返回 PEM（隱私增強(qiáng)郵件）中的客戶(hù)端證書(shū) |
| $ssl_client_fingerprint (ngx_http_ssl_module) | 它將為已建立的 SSL 連接返回客戶(hù)端證書(shū)的 SHA1（安全哈希算法）指紋。 |
| $ssl_client_fingerprint (ngx_stream_ssl_module) | 它將為已建立的 SSL 連接返回客戶(hù)端證書(shū)的 SHA1（安全哈希算法）指紋。 |
| $ssl_client_i_dn (ngx_http_ssl_module) | 根據(jù) RFC 2253，為已建立的 SSL 連接返回客戶(hù)端證書(shū)的“頒發(fā)者 DN”（其中 DN 是專(zhuān)有名稱(chēng)）字符串。 |
| $ssl_client_i_dn (ngx_stream_ssl_module) | 根據(jù) RFC 2253，為已建立的 SSL 連接返回客戶(hù)端證書(shū)的“頒發(fā)者 DN”（其中 DN 是專(zhuān)有名稱(chēng)）字符串。 |
| $ssl_client_i_dn_legacy | 返回已建立 SSL 連接的客戶(hù)端證書(shū)的“頒發(fā)者 DN”（其中 DN 是專(zhuān)有名稱(chēng)）字符串。 |
| $ssl_client_raw_cert (ngx_http_ssl_module) | 它將為已建立的 SSL 連接返回 PEM（隱私增強(qiáng)郵件）格式的客戶(hù)端證書(shū)。 |
| $ssl_client_raw_cert (ngx_stream_ssl_module) | 它將為已建立的 SSL 連接返回 PEM（隱私增強(qiáng)郵件）格式的客戶(hù)端證書(shū)。 |
| $ssl_client_s_dn (ngx_http_ssl_module) | 根據(jù) RFC2253，為已建立的 SSL 連接返回客戶(hù)端證書(shū)的“主題 DN”（其中 DN 是專(zhuān)有名稱(chēng)）字符串。 |
| $ssl_client_s_dn (ngx_stream_ssl_module) | 根據(jù) RFC2253，為已建立的 SSL 連接返回客戶(hù)端證書(shū)的“主題 DN”（其中 DN 是專(zhuān)有名稱(chēng)）字符串。 |
| $ssl_client_s_dn_legacy | 返回已建立 SSL 連接的客戶(hù)端證書(shū)的“主題 DN”（其中 DN 是專(zhuān)有名稱(chēng)）字符串。 |
| $ssl_client_serial (ngx_http_ssl_module) | 它將返回已建立 SSL 連接的客戶(hù)端證書(shū)的序列號(hào)。 |
| $ssl_client_serial (ngx_stream_ssl_module) | 它將返回已建立 SSL 連接的客戶(hù)端證書(shū)的序列號(hào)。 |
| $ssl_client_v_end (ngx_http_ssl_module) | 它將返回客戶(hù)端證書(shū)的結(jié)束日期。 |
| $ssl_client_v_end (ngx_stream_ssl_module) | 它將返回客戶(hù)端證書(shū)的結(jié)束日期。 |
| $ssl_client_v_remain (ngx_http_ssl_module) | 它將返回客戶(hù)端證書(shū)到期前的天數(shù)。 |
| $ssl_client_v_remain (ngx_stream_ssl_module) | 它將返回客戶(hù)端證書(shū)到期前的天數(shù)。 |
| $ssl_client_v_start (ngx_http_ssl_module) | 它將返回客戶(hù)端證書(shū)的開(kāi)始日期。 |
| $ssl_client_v_start (ngx_stream_ssl_module) | 它將返回客戶(hù)端證書(shū)的開(kāi)始日期。 |
| $ssl_client_verify (ngx_http_ssl_module) | 如果證書(shū)不存在，它將返回客戶(hù)端證書(shū)驗(yàn)證的結(jié)果：“SUCCESS”、“FAILD:reason”和“NONE”。 |
| $ssl_client_verify (ngx_stream_ssl_module) | 如果證書(shū)不存在，它將返回客戶(hù)端證書(shū)驗(yàn)證的結(jié)果：“SUCCESS”、“FAILD:reason”和“NONE”。 |
| $ssl_curves (ngx_http_ssl_module) | 返回客戶(hù)端支持的曲線(xiàn)列表。所有已知曲線(xiàn)均按名稱(chēng)列出，未知曲線(xiàn)以十六進(jìn)制顯示，例如：0x001d:prime256v1:secp521r1:secp384r1 |
| $ssl_curves (ngx_stream_ssl_module) | 返回客戶(hù)端支持的曲線(xiàn)列表。所有已知曲線(xiàn)均按名稱(chēng)列出，未知曲線(xiàn)以十六進(jìn)制顯示，例如：0x001d:prime256v1:secp521r1:secp384r1 |
| $ssl_early_data | 如果使用 TLS 1.3 早期數(shù)據(jù)并且握手未完成，它將返回 1，否則返回空。 |
| $ssl_preread_alpn_protocols | 它返回客戶(hù)端通過(guò) ALPN 發(fā)布的協(xié)議列表，值之間用逗號(hào)分隔。 |
| $ssl_preread_protocol | 客戶(hù)端支持的最高 SSL（安全套接字層）協(xié)議版本。 |
| $ssl_preread_server_name | 返回通過(guò) SNI（服務(wù)器名稱(chēng)指示）請(qǐng)求的服務(wù)器的名稱(chēng)。 |
| $ssl_protocol (ngx_http_ssl_module) | 它將返回已建立的 SSL 連接的協(xié)議。 |
| $ssl_protocol (ngx_stream_ssl_module) | 它將返回已建立的 SSL 連接的協(xié)議。 |
| $ssl_server_name (ngx_http_ssl_module) | 返回通過(guò) SNI（服務(wù)器名稱(chēng)指示）請(qǐng)求的服務(wù)器的名稱(chēng)。 |
| $ssl_server_name (ngx_stream_ssl_module) | 返回通過(guò) SNI（服務(wù)器名稱(chēng)指示）請(qǐng)求的服務(wù)器的名稱(chēng)。 |
| $ssl_session_id (ngx_http_ssl_module) | 它將返回已建立的 SSL 連接的會(huì)話(huà)標(biāo)識(shí)符。 |
| $ssl_session_id (ngx_stream_ssl_module) | 它將返回已建立的 SSL 連接的會(huì)話(huà)標(biāo)識(shí)符。 |
| $ssl_session_reused (ngx_http_ssl_module) | 如果 SSL 會(huì)話(huà)被重用，則返回“r”或“。” 否則。 |
| $ssl_session_reused (ngx_stream_ssl_module) | 如果 SSL 會(huì)話(huà)被重用，則返回“r”或“。” 否則。 |
| $status (ngx_http_core_module) | 響應(yīng)狀態(tài)。 |
| $status (ngx_http_log_module) | 響應(yīng)狀態(tài)。 |
| $status (ngx_stream_core_module) | 會(huì)話(huà)狀態(tài)，可以是以下之一： 200：會(huì)話(huà)成功完成。400：無(wú)法解析客戶(hù)端的數(shù)據(jù)。403：禁止訪(fǎng)問(wèn)。500內(nèi)部服務(wù)器錯(cuò)誤。502錯(cuò)誤的網(wǎng)關(guān)。503服務(wù)不可用。 |
| $tcpinfo_rtt | 顯示有關(guān)客戶(hù)端 TCP 連接的信息，在支持TCP_INFO套接字選項(xiàng)的系統(tǒng)上可用。 |
| $tcpinfo_rttvar | 顯示有關(guān)客戶(hù)端 TCP 連接的信息，在支持TCP_INFO套接字選項(xiàng)的系統(tǒng)上可用。 |
| $tcpinfo_snd_cwnd | 顯示有關(guān)客戶(hù)端 TCP 連接的信息，在支持TCP_INFO套接字選項(xiàng)的系統(tǒng)上可用。 |
| $tcpinfo_rcv_space | 顯示有關(guān)客戶(hù)端 TCP 連接的信息，在支持TCP_INFO套接字選項(xiàng)的系統(tǒng)上可用。 |
| $time_iso8601 (ngx_http_core_module) | 以 ISO 8601 標(biāo)準(zhǔn)格式顯示當(dāng)?shù)貢r(shí)間。 |
| $time_iso8601 (ngx_http_log_module) | 以 ISO 8601 標(biāo)準(zhǔn)格式顯示當(dāng)?shù)貢r(shí)間。 |
| $time_iso8601 (ngx_stream_core_module) | 以 ISO 8601 標(biāo)準(zhǔn)格式顯示當(dāng)?shù)貢r(shí)間。 |
| $time_local (ngx_http_core_module) | 以普通日志格式顯示當(dāng)?shù)貢r(shí)間 |
| $time_local (ngx_http_log_module) | 以普通日志格式顯示當(dāng)?shù)貢r(shí)間。 |
| $time_local (ngx_stream_core_module) | 以普通日志格式顯示當(dāng)?shù)貢r(shí)間。 |
| $uid_got | cookie 的名稱(chēng)和收到的客戶(hù)端標(biāo)識(shí)符。 |
| $uid_reset | 如果變量設(shè)置為 ?non-empty' 字符串意味著不是 ?0'，那么客戶(hù)端標(biāo)識(shí)符將被重置。特殊值日志還會(huì)導(dǎo)致將有關(guān)重置標(biāo)識(shí)符的消息輸出到 error_log。 |
| $uid_set | cookie 的名稱(chēng)和發(fā)送的客戶(hù)端標(biāo)識(shí)符。 |
| $upstream_addr (ngx_http_upstream_module) | 它將保留 IP 地址和端口，或到上游服務(wù)器的 UNIX 域套接字的路徑。如果在請(qǐng)求處理期間聯(lián)系了多個(gè)服務(wù)器，則它們的地址用逗號(hào)分隔。 |
| $upstream_addr (ngx_stream_upstream_module) | 它將保留 IP 地址和端口，或到上游服務(wù)器的 UNIX 域套接字的路徑。如果在請(qǐng)求處理期間聯(lián)系了多個(gè)服務(wù)器，則它們的地址用逗號(hào)分隔。 |
| $upstream_bytes_received (ngx_http_upstream_module) | 從上游流服務(wù)器接收的字節(jié)數(shù)。來(lái)自多個(gè)連接的值由逗號(hào) (,) 和冒號(hào) (:) 分隔，就像 $upstream_addr 變量中的地址一樣。 |
| $upstream_bytes_received (ngx_stream_upstream_module) | 從上游流服務(wù)器接收的字節(jié)數(shù)。來(lái)自多個(gè)連接的值由逗號(hào) (,) 和冒號(hào) (:) 分隔，就像$upstream_addr變量中的地址一樣。 |
| $upstream_bytes_sent (ngx_http_upstream_module) | 發(fā)送到上游流服務(wù)器的字節(jié)數(shù)。來(lái)自多個(gè)連接的值由逗號(hào) (,) 和冒號(hào) (:) 分隔，就像$upstream_addr變量中的地址一樣。 |
| $upstream_bytes_sent (ngx_stream_upstream_module) | 發(fā)送到上游流服務(wù)器的字節(jié)數(shù)。來(lái)自多個(gè)連接的值由逗號(hào) (,) 和冒號(hào) (:) 分隔，就像$upstream_addr變量中的地址一樣。 |
| $upstream_cache_status | 它將保持訪(fǎng)問(wèn)響應(yīng)緩存的狀態(tài)。狀態(tài)可以是“BYPASS”、“MISS”、“EXPIRED”、“STALE”、“REVALIDATED”、“UPDATING”或“HIT”。 |
| $upstream_connect_time (ngx_http_upstream_module) | 用于保持與上游服務(wù)器（1.9.1）建立連接所花費(fèi)的時(shí)間；時(shí)間以秒為單位，分辨率為毫秒。在 SSL 的情況下，增加了握手所花費(fèi)的時(shí)間。多個(gè)連接的時(shí)間用逗號(hào) (,) 和冒號(hào) (:) 分隔，就像 $upstream_addr 變量中的地址一樣。 |
| $upstream_connect_time (ngx_stream_upstream_module) | 保持連接上游服務(wù)器的時(shí)間；時(shí)間以秒為單位，精度為毫秒。多個(gè)連接的時(shí)間用逗號(hào) (,) 分隔，如 $upstream_addr 變量中的地址。 |
| $upstream_cookie_name | 上游服務(wù)器在 Set-Cookie 響應(yīng)頭字段中發(fā)送的具有定義名稱(chēng)的 Cookie。僅保存來(lái)自最后一個(gè)服務(wù)器響應(yīng)的 cookie。 |
| $upstream_first_byte_time | 接收第一個(gè)數(shù)據(jù)字節(jié)的時(shí)間。時(shí)間以秒為單位，分辨率為毫秒。多個(gè)連接的時(shí)間用逗號(hào) (,) 分隔，如 $upstream_addr 變量中的地址。 |
| $upstream_header_time | 它用于保持從上游服務(wù)器接收標(biāo)頭所花費(fèi)的時(shí)間。多個(gè)連接的時(shí)間用逗號(hào) (,) 和冒號(hào) (:) 分隔，就像 $upstream_addr 變量中的地址一樣。 |
| $upstream_http_name | 保留服務(wù)器響應(yīng)頭字段。 |
| $upstream_queue_time | 用于保持請(qǐng)求在上游隊(duì)列中花費(fèi)的時(shí)間；時(shí)間以秒為單位，精度為毫秒。多個(gè)連接的時(shí)間用逗號(hào) (,) 和冒號(hào) (:) 分隔，就像 $upstream_addr 變量中的地址一樣。 |
| $upstream_response_length | 它用于保持從上游服務(wù)器獲得的響應(yīng)的長(zhǎng)度。長(zhǎng)度以字節(jié)為單位。多個(gè)響應(yīng)的長(zhǎng)度由逗號(hào) (,) 和冒號(hào) (:) 分隔，如 $upstream_addr 變量中的地址。 |
| $upstream_response_time | 它用于保持從上游服務(wù)器接收響應(yīng)所花費(fèi)的時(shí)間；時(shí)間以秒為單位，精度為毫秒。多個(gè)連接的時(shí)間用逗號(hào) (,) 和冒號(hào) (:) 分隔，就像 $upstream_addr 變量中的地址一樣。 |
| $upstream_session_time | 以毫秒為單位的會(huì)話(huà)持續(xù)時(shí)間。多個(gè)連接的時(shí)間用逗號(hào) (,) 分隔，如 $upstream_addr 變量中的地址。 |
| $upstream_status | 它用于保存從上游服務(wù)器獲得的響應(yīng)的狀態(tài)碼。多個(gè)響應(yīng)的狀態(tài)代碼由逗號(hào) (,) 和冒號(hào) (:) 分隔，類(lèi)似于 $upstream_addr 變量中的地址。如果無(wú)法選擇服務(wù)器，則該變量會(huì)保留 502（錯(cuò)誤網(wǎng)關(guān)）狀態(tài)代碼。 |
| $upstream_trailer_name | 它用于保持字段遠(yuǎn)離從上游服務(wù)器獲得的響應(yīng)的末尾。 |
| $uri | 請(qǐng)求中的當(dāng)前 URI，已標(biāo)準(zhǔn)化。我們可以在請(qǐng)求處理期間更改 $uri 的值，例如在進(jìn)行內(nèi)部重定向或使用索引文件時(shí)。 |