分类列举nginx 的shell变量

àì夳堔傛蜴生んèń 2024-03-22 11:13 83阅读 0赞

以下是一些常见的nginx shell变量，按照功能分类列出来：

## 1. 环境变量： ##

$PATH：指定了可执行程序的搜索路径

*  $LD\_LIBRARY\_PATH：指定了动态链接库的搜索路径
 *  $TZ：指定时区信息

## 2. 系统信息变量： ##

$HOSTNAME：主机名

*  $HOME：当前用户主目录
 *  $USER：当前用户名
 *  $UID：当前用户ID
 *  $SHELL：当前用户使用的shell

## 3. 程序执行相关变量： ##

$0：当前程序名

*  $1, $2, …：脚本或命令的第1、2、…个参数
 *  $\#：传给脚本或命令的参数个数
 *  $@：所有参数列表
 *  $?：上一个命令或脚本执行的返回值

## 4. nginx特有变量： ##

$host：请求的域名

*  $request\_uri：请求URI（不含协议和域名）
 *  $remote\_addr：客户端IP地址
 *  $http\_user\_agent：客户端浏览器类型
 *  $server\_protocol：服务器使用的协议（HTTP/1.0或HTTP/1.1）
 *  $http\_referer：客户端请求来源网址

## 5. 时间和日期相关变量： ##

$date：服务器当前日期和时间

*  $time\_iso8601：ISO 8601格式的日期和时间，例如“2021-10-01T12:34:56+08:00”
 *  $time\_local：服务器本地时间，例如“01/Oct/2021:12:34:56 +0800”

## 6. 请求处理相关变量： ##

$uri：请求URI（不含查询参数）

*  $args：请求的查询参数
 *  $request\_method：请求使用的HTTP方法（例如GET、POST等）
 *  $query\_string：请求的查询字符串
 *  $content\_length：请求体内容长度
 *  $content\_type：请求体内容类型

## 7. 响应处理相关变量： ##

$status：响应码

*  $body\_bytes\_sent：发送给客户端的响应体长度

1.  SSL/TLS相关变量：

*  $ssl\_cipher：客户端使用的SSL/TLS加密算法
 *  $ssl\_protocol：HTTPS协议的版本（例如TLSv1.2）

1.  请求重定向相关变量：

*  $redirect\_url：重定向的URL地址

## 10. 负载均衡相关变量： ##

$upstream\_addr：负载均衡后的服务器地址和端口

*  $upstream\_response\_time：响应时间（包括TCP连接时间和处理时间）

1.  FastCGI相关变量：

*  $fastcgi\_script\_name：FastCGI脚本的文件名
 *  $fastcgi\_path\_info：FastCGI程序所在目录

1.  日志相关变量：

*  $remote\_user：客户端发送的用户名
 *  $request\_time：请求到达Nginx的时间
 *  $http\_x\_forwarded\_for：客户端真实IP，在反向代理时使用

1.  文件相关变量：

*  $document\_uri：当前请求的URI，不带主机名和查询参数，例如“/index.html”
 *  $document\_root：Nginx配置文件中定义的文档根目录
 *  $realpath\_root：当前请求对应文件在服务器上的真实路径

## 14. HTTP头部相关变量： ##

$http\_cookie：客户端发送的cookie

*  $http\_host：客户端发送的Host头部信息
 *  $http\_user\_agent：客户端使用的浏览器类型
 *  $http\_referer：客户端请求来源网址
 *  $http\_accept\_language：客户端接受的语言

1.  缓存相关变量：

*  $upstream\_cache\_status：指示响应是否来自缓存

1.  OpenResty相关变量：

*  $lua\_version：当前Nginx是否启用了Lua模块
 *  $request\_uri：请求URI（含查询参数）
 *  $request\_filename：经过映射后的请求文件名

1.  压缩相关变量：

*  $gzip\_ratio：响应体的压缩比例
 *  $gzip\_proxied：指定什么样的代理服务器可以从响应中获取压缩数据

1.  远程端口相关变量：

*  $remote\_port：客户端访问Nginx的端口号
 *  $server\_port：Nginx监听的端口号
 *  $proxy\_port：代理服务器的端口号

这些变量可以帮助Nginx实现更加细粒度的日志记录、统计和调试等功能。

### 关于转发相关的Shell变量： ###

1.  $proxy\_host：代理服务器地址
2.  $proxy\_port：代理服务器端口号
3.  $proxy\_add\_x\_forwarded\_for：为HTTP头部添加X-Forwarded-For字段
4.  $proxy\_upstream\_name：上游服务器组名称
5.  $proxy\_cookie\_domain：向上游服务器发送的cookie域名
6.  $proxy\_cookie\_path：向上游服务器发送的cookie路径
7.  $proxy\_cache\_bypass：是否绕过缓存
8.  $proxy\_connect\_timeout：与上游服务器建立连接的超时时间
9.  $proxy\_read\_timeout：从上游服务器读取响应的超时时间
10. $proxy\_send\_timeout：给上游服务器发送请求的超时时间
11. $proxy\_set\_body：设置请求体的内容
12. $proxy\_pass\_request\_headers：是否向上游服务器发送请求头
13. $proxy\_pass\_request\_body：是否向上游服务器发送请求体
14. $proxy\_method：请求方法
15. $proxy\_remote\_addr：客户端源IP地址
16. $proxy\_protocol\_addr：使用代理协议时客户端真实IP地址
17. $upstream\_response\_time：上游服务器响应时间
18. $upstream\_status：上游服务器响应状态码
19. $upstream\_cache\_status：缓存服务器响应状态码
20. $upstream\_http\_\*：上游服务器HTTP响应头信息

这些变量可以帮助Nginx获取到上游服务器的响应数据，并进行进一步的处理和分析。例如， u p s t r e a m r e s p o n s e t i m e 可以用于监控并优化上游服务器的性能， upstream\_response\_time可以用于监控并优化上游服务器的性能， upstreamresponsetime可以用于监控并优化上游服务器的性能，upstream\_status则可以用于判断上游服务器是否出现异常。

### nginx关于缓存相关的Shell变量： ###

1.  $cache\_key：缓存的唯一键值
2.  $cache\_valid\_200：缓存的有效期

这两个变量都和Nginx的缓存机制相关。 c a c h e k e y 用于设置缓存的唯一键值，确保可以在多次请求中快速地命中缓存。 cache\_key用于设置缓存的唯一键值，确保可以在多次请求中快速地命中缓存。 cachekey用于设置缓存的唯一键值，确保可以在多次请求中快速地命中缓存。cache\_valid\_200则用于设置缓存的有效期，确保缓存不会过期或者被重复使用。

值得注意的是，$cache\_valid\_200只适用于200状态码的响应，如果需要对其他状态码也进行缓存控制，可以通过自定义变量和if语句来实现。