Nginx 变量概述

在 Nginx 中，变量是用于在配置文件中动态生成和传递数据的重要机制。变量可以表示来自客户端的请求数据、服务器的配置信息，或由模块计算的值。通过使用 Nginx 变量，您可以灵活地配置路由、重定向、日志记录等功能。

1. 变量的类型

Nginx 中的变量主要分为三类：

1. 内置变量：Nginx 提供了一组内置变量，这些变量包含了常见的 HTTP 请求、响应和服务器信息。例如：

   • $host: 请求中的主机名。
   • $remote_addr: 客户端的 IP 地址。
   • $request_uri: 原始请求的 URI，不包含请求参数。
   • $query_string: 请求的查询参数部分。

2. 模块变量：某些 Nginx 模块会引入特定的变量。例如：

   • $upstream_addr: 由 http_upstream 模块提供，用于获取实际提供服务的上游服务器的地址。
   • $gzip_ratio: 由 gzip 模块提供，显示响应压缩的比例。
3. 用户自定义变量：用户可以在 Nginx 配置文件中定义自定义变量，通常用于存储和处理特定逻辑的数据。

2. 变量的使用场景

1. 日志记录：
   Nginx 日志配置中，变量经常用于动态生成日志内容。例如，通过使用 $remote_addr 和 $request_uri 可以记录每个客户端的访问请求。

   log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                  '$status $body_bytes_sent "$http_referer" '
                  '"$http_user_agent" "$request_time"';

2. 条件控制：
   通过 if 指令，Nginx 变量可以用于条件判断。例如，根据请求路径或客户端 IP 进行重定向：

   if ($request_uri ~* "\.php$") {
      return 403;
   }

3. 负载均衡与代理：
   在代理请求时，变量可用于控制请求的转发地址。通过 $upstream_addr 可以记录请求转发到的具体上游服务器地址。

4. 重写与重定向：
   使用 rewrite 指令，可以基于请求参数动态生成重定向地址。例如，根据客户端请求的 URI 动态生成重定向地址：

   rewrite ^/oldpath(.*)$ /newpath$1 permanent;

3. 变量的定义与作用域

• 全局变量：Nginx 的内置变量和大部分模块变量在整个配置文件中都可以访问。
• 局部变量：用户定义的变量一般在定义它们的上下文中有效（如在 server 或 location 块中），不能跨上下文访问。

4. 性能影响

由于 Nginx 变量的动态计算特性，频繁地使用变量（特别是在复杂的条件判断或重写规则中）可能会对性能产生一定影响。因此，建议谨慎使用变量，尤其是在高并发的生产环境中。

总结

Nginx 变量在配置文件中提供了强大的灵活性，支持处理动态数据、条件控制以及日志记录等多种场景。通过合理使用内置变量、模块变量和自定义变量，可以提升 Nginx 配置的动态处理能力。但需要注意的是，频繁的变量使用可能对性能产生影响，因此在使用时需要平衡灵活性和性能之间的关系。