Nginx内置变量

最新推荐文章于 2025-11-22 21:27:12 发布

原创最新推荐文章于 2025-11-22 21:27:12 发布 · 1.1k 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#nginx #nginx内置变量

Nginx学习笔记专栏收录该内容

4 篇文章

订阅专栏

本文介绍了Nginx的内置变量，这些变量用于获取HTTP和TCP请求的相关信息，常用于日志记录和业务逻辑处理。文中列举了常见的内置变量如$scheme用于HTTP到HTTPS的重定向，$http_和$cookie_分别用于获取HTTP请求头和Cookie的值。

1 概述

在客户端发起http或tcp请求的过程中，Nginx提供了很多内置的变量来获取相应的HTTP和TCP的信息。Nginx的内置变量主要是用于日志的记录和分析，以及一些业务逻辑的处理等。

2 常见内置变量

Nginx的内置变量会随着版本的不断更新，具体可以参考官方的WIKI：Alphabetical index of variables

变量名	说明
$arg_`name`	URL请求中的参数，name是参数的名字
$args	URL请求中的所有参数
$content_length	HTTP请求信息里的"Content-Length"
$content_type	HTTP请求信息里的"Content-Type"
$cookie_`name`	name为Cookie的名字，可以得到Cookie的信息
$host	请求信息中的Host头域值，如果请求中没有Host行，则等于设置的服务器名
$http_`name`	HTTP请求信息中的header字段，name是字段key
$request_uri	请求的URI，带参数
$request_method	请求的方式，比如POST或GET
$scheme	请求的协议，例如HTTP或HTTPS
$uri	当前请求的URI，在请求过程中URI可能会被改变，例如在内部重定向或使用索引文件时

3 内置变量的实例

$scheme

使用该变量来实现HTTP请求重定向跳转到HTTPS请求：
（注意 if 与左括号是有空格的）

if ($scheme = 'http') {
	rewrite ^/(.*)$ https://$host/$1 redirect;
}

$http_`name`

获取http请求头的值：

upstream backend {
    server 192.168.244.1:8080;
	server 192.168.244.2:8080;
    server 192.168.244.3:8080;
    server 192.168.244.4:8080;
	hash $http_userid consistent;
}

$cookie_`name`

获取cookie的值：

upstream backend {
    server 192.168.128.1:8080 srun_id=123456;
    server 192.168.128.2:8080 srun_id=654321;
    jvm_route $cookie_jtzen9SID reverse;
	keepalive 32;
}