[nginx] nginx的常用内置变量

常用内置变量 , 有时候在使用nginx排查问题 , 或者进行各种操作的时候 , 都有用处

以下仅列出一些常用变量，更多变量请到nginx官网查阅

http://nginx.org/en/docs/varindex.html

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

以访问http://localhost:80/nginx/varindex?a=1&b=2得到的结果GET /nginx/varindex?a=1&b=2 HTTP/1.1 为例(可以在access.log日志中看到访问结果)

arg_name请求行中的参数，arg_a=1,

is_args请求行中是否包含参数，若包含，则is_args=?，否则为空字符串

args请求行中的全部参数，args=a=1&b=2，若无参数则为空字符串

$request 完整的原始的请求行,GET /nginx/varindex?a=1&b=2 HTTP/1.1

$request_method 请求方法，如GET、POST

$request_uri 完整的原始请求URI，访问的URL除去域名(或IP)和port,如/nginx/varindex?a=1&b=2

document_uri/uri请求规范化以后的URI,可能与

$server_protocol 请求的协议版本，如HTTP/1.0

以上变量在配置文件中通常配合try_files指令和rewrite指令使用 复制代码

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

复制代码 $host 请求头的值，以下顺序获得：请求行中的host、请求头中的Host、配置文件中匹配到的server_name

$remote_addr 客户端ip地址

$remote_port 客户端端口

$remote_user 基本身份验证随附的用户名

$http_cookie Cookie请求头的值

$http_user_agent 用户代理

$cookie_name Cookie中名为name的值

$http_referer Http-Referer请求头的值 复制代码

3. 其他变量

复制代码 $cookie_name 名为name的cookie

$protocol 与客户端通信的协议： TCP或UDP（1.11.4）

$hostname 运行nginx的服务器主机名

$server_name 接受请求的服务器主机名

$body_bytes_sent 发送给客户端的字节数

$connection_requests 通过连接发出的当前请求数

$limit_rate 用于设置响应的速度限制

$time_local 通用日志格式的本地时间

$status 响应状态返回码

$request_time 请求处理时间

proxy_add_x_fowarded_for在客户端传递来的X-Forwarded-For请求头后面追加remote_addr（用逗号分隔）如果客户端没有传递X-Forwarded-For请求头，那么该变量等于

$msec 以毫秒为单位的当前时间

$scheme 请求模式，http或https

$nginx_version Nginx版本

$pid 工作进程的PID

通过日志打印这些数据