nginx 常用变量
2022-01-04 本文已影响0人
ly93
- 官方文档
http://nginx.org/en/docs/http/ngx_http_core_module.html#variables
- 常用变量列表:
| 变量名称 | 描述 |
|---|---|
| $arg_name | 请求行中的参数name |
| $args | 请求行中的参数 |
| $binary_remote_addr | 二进制形式的客户端地址 |
| $body_bytes_sent | 发送到客户端的字节数，不包含响应标头 |
| $bytes_sent | 发送到客户端的总字节数 |
| $connection | 连接序列号 |
| $connection_requests | 当前通过连接发出的请求数量 |
| $connection_time | 连接时间（以秒为单位，毫秒级分辨率 ）（1.19.10） |
| $content_length | "内容长度"请求标头字段 |
| $content_type | "内容类型"请求标头字段 |
| $cookie_name | cookie名称 |
| $document_root | 当前请求的root或alias指令的值 |
| $document_uri | 同$uri |
| $host | 按以下优先顺序排列：请求行中的主机名，或"Host"请求标头字段中的主机名，或与请求匹配的服务器名称 |
| $hostname | 主机名 |
| $http_name | 任意请求标头字段;变量名称的最后一部分是转换为小写的字段名称，短划线由下划线替换 |
| $https | ""（如果连接在 SSL 模式下运行），否则为空字符串on |
| $is_args | ""（如果请求行有参数），否则为空字符串? |
| $limit_rate | 设置此变量可启用响应速率限制;请参见limit_rate |
| $msec | 日志写入时间，单位为秒，精度是毫秒 |
| $nginx_version | nginx版本 |
| $pid | 进程ID |
| $pipe | 如果请求是通过http流水线发送，则其值为"p"，否则为“." |
| $proxy_protocol_addr | 代理服务器的客户端地址，如果是直接访问，该值为空字符串 |
| $proxy_protocol_port | 代理服务器的客户端端口 |
| $proxy_protocol_server_addr | 代理协议标头中的服务器地址 |
| $proxy_protocol_server_port | 代理协议标头中的服务器端口 |
| $query_string | 同$args |
| $realpath_root | 当前请求的文档根目录或别名的真实路径，会将所有符号连接转换为真实路径 |
| $remote_addr | 客户端地址 |
| $remote_port | 客户端端口 |
| $remote_user | 基本身份验证随附的用户名 |
| $request | 完整的原始请求行 |
| $request_body | 客户端的请求body体 |
| $request_body_file | 将客户端请求body体保存在临时文件中。文件处理结束后，此文件需删除。 |
| $request_completion | 如果请求成功，值为"OK"，如果请求未完成或者请求不是一个范围请求的最后一部分，则为空 |
| $request_filename | 当前连接请求的文件路径，由root或alias指令与URI请求生成 |
| $request_id | 从 16 个十六进制随机字节生成的唯一请求标识符 |
| $request_length | 请求长度（包括请求行、标头和请求正文） |
| $request_method | HTTP请求方法，通常为"GET"或"POST" |
| $request_time | 处理客户端请求使用的时间,单位为秒，精度毫秒； 从读入客户端的第一个字节开始，直到把最后一个字符发送给客户端后进行日志写入为止。 |
| $request_uri | 客户端请求参数的原始URI，它无法修改，请查看$uri更改或重写URI，不包含主机名， |
| $scheme | 请求使用的Web协议，"http" 或 "https" |
| $sent_http_name | 任意响应标头字段;变量名称的最后一部分是转换为小写的字段名称，短划线由下划线替换 |
| $sent_trailer_name | 在响应末尾发送的任意字段 （1.13.2）;变量名称的最后一部分是转换为小写的字段名称，短划线由下划线替换 |
| $server_addr | 接受请求的服务器的地址 |
| $server_name | 接受请求的服务器的名称 |
| $server_port | 接受请求的服务器的端口 |
| $server_protocol | 服务器的HTTP版本，通常为 "HTTP/1.0" 或 "HTTP/1.1" |
| $status | 响应码 |
| $time_iso8601 | ISO 8601 标准格式的本地时间 ,eg: "2017-05-24T18:31:27+08:00" |
| $time_local | 通用日志格式中的本地时间 .eg: "24/May/2017:18:31:27 +0800" |
| $uri | 请求中的当前 URI |
| $http_host | 请求地址，即浏览器中你输入的地址（IP或域名） |
| $http_referer | url跳转来源,用来记录从那个页面链接访问过来的 |
| $http_user_agent | 用户终端浏览器等信息 |
| $http_x_forwarded_for | 代理服务器的地址 |
| $upstream_addr | 请求的上游服务器 |
| $upstream_connect_time | 上游服务握手时间 |
| $upstream_header_time | 接收上游header所花费的时间 |
| $upstream_response_time | 接收上游body体所花费的时间 |
| $upstream_response_length | 上游响应长度 |
| $upstream_cache_status | 缓存命中/未命中(如果适用) |
