nginx变量

请求行中，名称为 name 的参数的值。比如，当请求行是"GET /nginx/varindex/?from=rss HTTP/1.1"时， arg_ name 的值是空字符串

如果请求行中包含参数，那么$is_args的值是"?"，否则是空字符串

请求行中的全部参数（也就是查询字符串）。比如，当请求行是"GET /nginx/varindex/?a=b&c=d HTTP/1.1"时， args的值是空字符串

名称为 name 的cookie的值

完整的原始的请求行。比如："GET /b/../a?a=b HTTP/1.1"（uri不会被规范化）

用来获取任意请求头的值。

HTTP header的命名方式是：每个单词的首字母大写，其余字母小写，单词之间用中划线（"-"）连接。比如，User-Agent、Content-Type、X-Forwarded-For等。

请求头名称和 name 之间的转换方式是：将请求头名称转换成小写形式，并将中划线（"-"）替换成下划线（"_"），比如：$http_x_forwarded_for

请求的长度，包含请求行、请求头和请求体

请求方法，比如GET或POST

完整的原始的URI（带参数）

请求模式，http或https

"Content-Length"请求头的值

"Content-Type"请求头的值

应用于当前请求的root或alias指令的值

规范化后的URI。所谓的规范化是指：将 以"%XX"形式编码的文本进行解码 之后，解决对相对地址"."和".."的引用，并将多个相邻的"/"压缩成一个。

请求处理期间，$uri的值可能发生改变，比如在发生内部重定向或者使用index文件的时候

Nginx按照下面的优先级顺序，设置$host的值：

一般情况下，请求行中只会包含 Request URI ，也就是 URI 和 QUERY STRING ，不会包含 host name。但是，当使用Nginx做HTTP正向代理服务器的时候，请求行中会包含host name

在客户端传递来的X-Forwarded-For请求头后面追加 remote_addr。

比如，客户端传递来的XFF请求头是：192.168.1.1, 192.168.1.2； proxy_add_x_forwarded_for等于192.168.1.1, 192.168.1.2, 192.168.1.3

应用于当前请求的root或alias指令的值所对应的绝对路径，所有的符号连接都会被解析成真实路径

请求协议，通常是"HTTP/1.0"、"HTTP/1.1"、"HTTP/2.0"

当前请求对应的资源的路径。

该变量的值是基于root（或alias）指令的值，以及请求的URI计算出来的。比如，当root指令的值是/data/w3，URI是/images/logo.jpg时，该变量等于/data/w3/images/logo.jpg

下发给客户端的字节数（不包含响应头）

从 接收到请求的第一个字节 到 把响应的最后一个字节发送给客户端，所经历的时间。单位是秒，精确到毫秒

用于获取下发给客户端的任意响应头的值。响应头名称和 name 之间的转换方式是：将响应头名称转换成小写形式，并将中划线（"-"）替换成下划线（"_"）

下发给客户端的响应码

二进制形式的客户端地址。对于IPV4地址，该值的长度是4字节，对于IPV6地址该值的长度是16字节

连接的序号

在开启keepalive的情况下，客户端可以使用一条连接发起多个请求，该变量用于记录通过一条连接发起的请求数

本地时区的当前时间

GMT格式的当前时间

运行Nginx的主机的主机名，比如：vm 0 16_centos

当前的时间戳，精确到毫秒。比如，1551609371.088

Nginx的版本号

Worker进程的PID

在proxy_pass指令中指定的被代理服务的名称（可能是upstream的名称）

在proxy_pass指令中指定的被代理服务的端口。如果在proxy_pass指令中未指定端口，那么该变量等于协议的默认端口

客户端地址

客户端端口

在开启basic authentication的时候，客户端所使用的用户名

接收请求的虚拟主机的地址

接收请求的虚拟主机的端口

接收请求的虚拟主机的名称

ISO 8601标准格式的本地时间

通用日志格式的本地时间

保存upstream server的ip地址和端口，或Unix套接字的路径。在请求处理期间，如果请求被代理到多个upstream server，那么它们的地址之间用","分隔，比如："192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock"。当发生（由error_page等发起的）从一个server group到另外一个server group的内部重定向时，不同的server group之间用":"分隔，比如："192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80"。如果server group中没有可用的server，那么该变量的值是server group的名字

从upstream server接收到的字节数。来自于多个连接的值，像$upstream_addr中的地址一样，用","和":"分隔

发送到upstream server的字节数。来自多个连接的值，像$upstream_addr中的地址一样，用","和":"分隔

该变量用来显示缓存的使用情况。其值是：

建立到upstream server的连接所花费的时间。单位是秒，精确到毫秒。对于SSL连接，该时间也包含SSL握手所花费的时间。建立多个连接所花费的时间之间，像$upstream_addr中的地址一样，用","和":"分隔

upstream server返回的"Set-Cookie"响应头中的，名称 name 的cookie的值。只有最后一个server返回的响应中的cookie会被保存

从upstream server接收响应头所花费的时间。单位是秒，精确到毫秒。多个响应所花费的时间之间，像$upstream_addr中的地址一样，用","和":"分隔

用于获取upstream server返回的任意响应头的值。

响应头名称和 name 之间的转换方式是：将响应头名称转换成小写形式，并将中划线替换成下划线。

只有最后一个server的响应头会被保存

保存从upstream server获取到的响应的长度。单位是字节。多个响应的长度之间，像$upstream_addr中的地址一样，用","和":"分隔

保存从upstream server接收响应所花费的时间。单位是秒，精确到毫秒。多个响应所花费的时间之间，像$upstream_addr中的地址一样，用","和":"分隔

保存从upstream server获取到的响应的状态码。多个响应的状态码之间，像$upstream_addr中的地址一样，用","和":"分隔

host变量的值按照如下优先级获得：

我们知道，HTTP是一个文本协议，建立在一个可靠的传输层协议之上。这个传输层协议要是可靠的，面向连接的。由于TCP的普及程度，让它成了HTTP下层协议事现上的标准。但我们要知道，HTTP并不仅限于建立在TCP之上。只要是可靠的，面向连接的传输层协议，都可以用来传输HTTP。下面所说的HTTP，都是指搭载在TCP之上的HTTP。

一个HTTP请求过程是这样的，客户端先与服务器建立起TCP连接，然后再与服务器端进行请求和回复的收发。请求包含请求行、请求头和请求体，其中，根据请求方法的不同，请求体是可选的。

在发送请求行之前，客户端与服务器已经建立了连接。所以此时请求行中并不需要有服务器的信息。我们用telnet测试, 例如:

这就是一个完整的HTTP请求行。虽然请求行中不需要有服务器的信息，但仍然可以在请求行中包含服务器的信息。例如：

两者一比较，就很容易理解什么叫请求行中的host了。第一个请求行中，就没有host，第二种请求行中，就带了host，为 www.test.info 。

一个请求，请求行下面就是一些列的请求头。这些请求头，在HTTP/1.0中，都是可选的，且HTTP/1.0不支持Host请求头； 而在HTTP/1.1中，Host请求头部必须存在 ,否则会返回400 Bad Request

我们看个例子, 使用telnet 连接:

但是HTTP/1.0是不支持Host头部的,所以请求,不需要带这个Host,我们也测试一下:

可以看到没有返回400， 而是返回了404，说明这个请求还是来到nginx处理，命中了其中一个配置的"虚拟主机", 我到nginx下面看access_log，看到日志写在了第一个的nginx虚拟主机配置的日志文件下面，说明http1.0情况下，没有带host头部，请求默认来到了nginx 第一个虚拟主机下处理。

server name是指在Nginx配置文件中，在server块中，用server_name指令设置的值。一个server可以多次使用server_name指令，来实现俗称的“虚拟主机”。例如：

关于虚拟主机的确定方法，还是引用Nginx的官方文档：

这就解释了上面的HTTP1.0请求，不带Host头，默认来到了第一个配置的server处理了。

然后我测试一下把 www.test.info 这个域名设成默认的主机default_server，看请求能不能正常来到 www.test.info 这个server来处理。

nginx 配置修改：

再次请求：

实际测试，正常，default_server确实起作用了。

http_host 则是读取请求头header里面的key，所有请求头里面的key再nginx里面都可以通过小写和下划线来让nginx读取。例如header里面的Host就能转成 http_user_agent。

所以，只要是header的请求头都可以这样被nginx读取， 我们测试一下：

当然这个几个头部能在response显示是因为在nginx加了add_header控制的：

$http_header的应用：当我们一个项目部署在两个服务器下面，然后在另外一个服务器搭建nginx反响代理，反响代理把请求转发给两个服务器的时候，他们的日志记录的是反向代理的ip， 而不是真正请求的用户IP， 这时就可以通过配置proxy_set_header 把真实IP设置给一个X-forwarded-For 或者 X-Real-IP 转给后端服务器，然后后端服务器读取通过http_x_real_ip来读取真实IP， 记录到access_log下面

日志的格式把第一个IP换成刚才转发过来的头部X-Real-IP就可以记录用户IP了：

关于nginx中的host变量

What's the difference of http_host in Nginx

---