Nginx 内置变量介绍
Nginx 内置了许多无需声明就可以使用的变量,想要使用这些变量,只需在变量名前加个 $
即可,比如引用 host 变量的方式为 $host
。
Nginx 常用的内置变量
变量名 | 变量描述 |
---|---|
arg_{name} | URL 中某个具体参数的值 |
args | 全部 URL 参数 |
content_length | HTTP 请求中标识包体长度的 Content-Length 头部的值 |
content_type | 标识请求包体类型的 Content-Type 头部的值 |
uri | 请求的 URI(不包含?后的参数) |
request_uri | 请求的 URI(包含?后的参数) |
scheme | 协议名:HTTP 或者 HTTPS |
request_method | 请求的方式:GET、POST |
request_length | 所有请求内容的大小,包括请求行,头部,包体等 |
remote_user | 由 HTTP Basic Authentication 协议传入的用户名 |
request | 原始的 url 请求,含有方法和协议版本 |
request_time | 请求处理的耗时时间 |
server_name | 匹配上的请求 server_name |
request_completion | 若请求处理完则返回 OK,否则为空 |
request_id | 以16进制输出的请求标识 ID,随即生成 |
status | 请求的状态,成功是200 |
time_local | 本地的标准时间 |
pid | 所属 worker 进程的 ID |
hostname | 系统主机名 |
nginx_version | 当前运行的 nginx 版本号 |
host | 发起请求的客户端的 host |
remote_addr | 发起请求的客户端的 ip 地址 |
remote_port | 发起请求的客户端的端口 |
proxy_protocol_addr | 若使用了 proxy_protocol 协议则返回协议中的地址 |
proxy_protocol_port | 若使用了 proxy_protocol 协议则返回协议中的端口 |
server_addr | 服务器端地址(本端地址 |
server_port | 服务器端端口 |
body_bytes_sent | 记录发送给客户端的请求体大小 |
http_referer | 记录从那个页面链接访问过来的 |
http_user_agent | 记录请求的用户代理 |