这里列出常用的 Nginx 全局变量,也可以点击 实时查看 浏览。

服务器相关

变量名备注示例
nginx_version当前运行的 Nginx 版本号1.11.2
server_port服务器端口8080
server_addr服务器端地址127.0.0.1
server_name服务器名称127.0.0.1
server_protocol服务器的HTTP版本HTTP/1.0
statusHTTP 响应代码200
time_iso8601服务器时间的 ISO 8610 格式2018-09-02T15:14:27+08:00
time_local服务器时间(LOG Format 格式)02/Sep/2018:15:14:27 +0800
document_root当前请求的文档根目录或别名/home/xiaowu/github/echo.xuexb.com
request_filename当前连接请求的文件路径,由 root 或 alias 指令与 URI 请求生成/home/xiaowu/github/echo.xuexb.com/api/dump/path
request_completion如果请求成功,值为”OK”,如果请求未完成或者请求不是一个范围请求的最后一部分,则为空
pid工作进程的PID1234
msec当前的Unix时间戳1535872750.954
limit_rate用于设置响应的速度限制0
pipe如果请求来自管道通信,值为“p”,否则为“.”.
connection_requestsTCP连接当前的请求数量1
connectionTCP 连接的序列号363861
realpath_root当前请求的文档根目录或别名的真实路径,会将所有符号连接转换为真实路径/home/xiaowu/github/echo.xuexb.com
hostname主机名bj01

客户端相关

变量名备注示例
http_accept浏览器支持的 MIME 类型text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
http_accept_encoding浏览器支持的压缩编码gzip, deflate, br
http_accept_language浏览器支持的语言zh-CN,zh;q=0.9,en;q=0.8
http_cache_control浏览器缓存max-age=0
http_connection客户端与服务连接类型
http_cookie浏览器请求 cookiea=1; b=2
http_host浏览器请求 hostecho.xuexb.com
http_referer浏览器来源https://echo.xuexb.com/
http_upgrade_insecure_requests是一个请求首部,用来向服务器端发送信号,表示客户端优先选择加密及带有身份验证的响应,并且它可以成功处理 upgrade-insecure-requests CSP 指令1
http_user_agent用户设备标识Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36
http_x_requested_with异步请求标识true
http_x_forwarded_for反向代理原 IP198.13.61.105

链接相关

变量名备注示例
scheme请求使用的 WEB 协议http
uri请求中的当前 URI(不带请求参数),可以不同于浏览器传递的 $request_uri 的值,它可以通过内部重定向,或者使用 index 指令进行修改/api/dump/path
document_uri同 $uri/api/dump/path
request_uri这个变量等于包含一些客户端请求参数的原始 URI ,它无法修改/api/dump/path?a=1&%E4%B8%AD%E6%96%87=%E5%A5%BD%E7%9A%84
request_methodHTTP 请求方法GET
request_time处理客户端请求使用的时间,从读取客户端的第一个字节开始计时0.000
request_length请求的长度(包括请求地址、请求头和请求主体)678
args请求参数a=1&%E4%B8%AD%E6%96%87=%E5%A5%BD%E7%9A%84
query_string同 $args
is_args请求中是否有参数,有则为 ? 否则为空?
arg_参数名请求中具体的参数$arg_a  1
https如果开启了 SSL 安全模式,则为 on 否则为空on