0%

nginx全局变量

1. 服务器相关

变量名备注示例
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当前连接请求的文件路径,由 rootalias指令与 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

2. 客户端相关

变量名示例备注
hostecho.xuexb.com优先级如下:HTTP请求行的主机名>”HOST”请求头字段>符合请求的服务器名
hostnamebj01主机名
remote_port58500客户端端口
remote_user用于HTTP基础认证服务的用户名
requestGET /api/dump/path?a=1&%E4%B8%AD%E6%96%87=%E5%A5%BD%E7%9A%84%23123 HTTP/1.0代表客户端的请求地址
remote_addr127.0.0.1客户端地址
request_body客户端的请求主体, 此变量可在location中使用,将请求主体通过proxy_pass, fastcgi_pass, uwsgi_pass, 和 scgi_pass传递给下一级的代理服务器
request_body_file将客户端请求主体保存在临时文件中文件处理结束后,此文件需删除如果需要之一开启此功能,需要设置client_body_in_file_only如果将次文件传递给后端的代理服务器,需要禁用request body,即设置proxy_pass_request_body off,fastcgi_pass_request_body off, uwsgi_pass_request_body off, or scgi_pass_request_body off
proxy_protocol_addr获取代理访问服务器的客户端地址,如果是直接访问,该值为空字符串(1.5.12)
http_名称http_accept_language -> zh-CN,zh;q=0.9,en;q=0.8,zh-TW;q=0.7匹配任意请求头字段; 变量名中的后半部分“name”可以替换成任意请求头字段,如在配置文件中需要获取http请求头:“Accept-Language”,那么将“-”替换为下划线,大写字母替换为小写,形如:http_accept_language即可
bytes_sent0传输给客户端的字节数 (1.3.8, 1.2.5)
body_bytes_sent0传输给客户端的字节数,响应头不计算在内;这个变量和Apache的mod_log_config模块中的“%B”参数保持兼容

3. 客户端相关 - request headers

变量名备注示例
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

4. 链接相关

变量名备注示例
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

5. 参考资料

给作者打赏,可以加首页微信,咨询作者相关问题!