【Nginx】之常用内置变量

╰半橙微兮° 2022-09-11 13:13 218阅读 0赞

### Nginx 内置变量介绍 ###

--------------------

**Nginx** 内置了许多无需声明就可以使用的变量，想要使用这些变量，只需在变量名前加个 `$` 即可，比如引用 *host* 变量的方式为 `$host`。

### Nginx 常用的内置变量 ###

--------------------

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