Nginx中常用的内置变量

Nginx 1255℃

1. 从请求行中解析到的变量

以访问http://invo.com/nginx-var/request-line?a=1&b=2得到的结果为例,invo.com为测试的虚拟主机

变量 含义 示例
$request 整个请求行 GET /nginx-var/request-line?a=1&b=2 HTTP/1.1
$request_method 请求方法(如GET、POST) GET
$request_uri 完整的请求URI /nginx-var/request-line?a=1&b=2
$uri URI,除去查询字符串 /nginx-var/request-line
$document_uri 同$uri /nginx-var/request-line
$args 查询字符串 a=1&b=2
$query_string 同$args a=1&b=2
$server_protocol 请求协议(如HTTP/1.0 HTTP/1.1) HTTP/1.1
$arg_name 请求行中name参数的值 $arg_a = 1 , $arg_b = 2

说明: 这些变量在配置文件中通常配合try_files指令和rewrite指令使用。

2. 从请求头中解析到的变量

用Firefox的HttpRequester插件,添加Cookie为CA=abc;CB=123,Referer为http://invo.com的请求头,
以访问地址http://invo.com/nginx-var/header-var得到的结果为例。

变量 含义 示例
$host 按如下顺序获得:

请求行中的host、请求头中的Host、

配置文件中匹配到的server_name

invo.com
$remote_addr 客户端ip地址 127.0.0.1
$remote_port 客户端端口 4204
$http_user_agent 用户代理(“User-Agent”请求头的值) Mozilla/5.0 (Windows NT 6.1; rv:50.0)

Gecko/20100101 Firefox/50.0

$http_cookie “Cookie”请求头的值 CA=abc;CB=123
$cookie_name Cookie中名为name的值 $cookie_CA=abc, $cookie_CB=123
$http_referer “Http-Referer”请求头的值 http://invo.com

说明: $host、$remote_addr、$http_user_agent、$http_referer在配置文件中经常用到,可以根据这些变量来决定如何处理请求。以上变量也经常用在log_format指令中,这些变量的值将记录在日志文件,用于分析日志。有一次特意查看了下日志文件,发现同一个客户端每次请求服务器的端口($remote_port)会变化,推断公司网络的类型为对称型NAT。

3. 其它内置变量

变量 含义 示例
$body_bytes_sent 发给客户端的数据大小,以字节计,不包括http报头
$bytes_sent 发给客户端的数据大小,以字节计
$status http响应状态码
$request_time 请求处理时间
$upstream_response_time 从与upstream建立连接到收到最后一个字节所经历的时间(nginx做反向代理服务器时可用)
$upstream_connect_time 与upstream建立连接所消耗的时间(nginx做反向代理服务器时可用)

说明:以上变量通常用于日志配置中,用于统计流量和监视服务器性能。

转载请注明:零五宝典 » Nginx中常用的内置变量