当前位置：首页 > 服务器技术 > 正文

Nginx配置文件变量详解（从零开始掌握Nginx变量的使用方法）

Nginx 是一款高性能的 Web 服务器和反向代理服务器，广泛应用于现代 Web 架构中。在 Nginx 的配置文件中，变量（Variables）是一个非常强大但常被初学者忽略的功能。通过合理使用变量，我们可以实现动态配置、日志记录、请求重写等高级功能。

本文将带你从零开始，详细讲解 Nginx变量 的基本概念、常见用法以及实际示例，即使你是刚接触 Nginx 的小白，也能轻松上手！

什么是 Nginx 变量？

Nginx 变量是在配置文件中以 $ 开头的标识符，例如 $host、$request_uri 等。这些变量可以存储来自客户端请求的信息、服务器状态、时间戳等数据，并在配置指令中动态使用。

Nginx配置文件变量详解（从零开始掌握Nginx变量的使用方法） Nginx变量 Nginx配置 Nginx内置变量 Web服务器配置第1张

常见的 Nginx 内置变量

Nginx 提供了大量内置变量，以下是一些最常用的：

$host：请求中的 Host 头部值
$request_uri：完整的原始请求 URI（包括参数）
$uri：当前请求的路径（不带参数）
$args 或 $query_string：URL 中的查询字符串
$remote_addr：客户端 IP 地址
$http_user_agent：客户端的 User-Agent 信息
$scheme：请求协议（http 或 https）

如何在配置中使用变量？

变量可以用于多种 Nginx 指令中，比如 rewrite、return、proxy_set_header、log_format 等。

示例 1：自定义访问日志格式

我们可以通过变量自定义日志内容，方便调试或分析用户行为：

log_format custom_log '$remote_addr - $host [$time_local] '                      '"$request" $status $body_bytes_sent '                      '"$http_referer" "$http_user_agent"';access_log /var/log/nginx/access.log custom_log;

示例 2：根据 User-Agent 返回不同内容

利用 $http_user_agent 变量，我们可以为移动端和桌面端用户提供不同的页面：

server {    listen 80;    server_name example.com;    if ($http_user_agent ~* "(Android|iPhone|iPad)") {        rewrite ^(.*)$ /mobile$1 break;    }    location / {        root /usr/share/nginx/html;    }    location /mobile/ {        alias /usr/share/nginx/mobile/;    }}

示例 3：设置反向代理头部

在反向代理时，后端服务通常需要知道原始请求信息，这时可以用变量传递：

location /api/ {    proxy_pass http://backend/;    proxy_set_header Host $host;    proxy_set_header X-Real-IP $remote_addr;    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    proxy_set_header X-Forwarded-Proto $scheme;}

自定义变量

除了内置变量，Nginx 还允许你使用 set 指令创建自己的变量：

server {    listen 80;    server_name example.com;    set $my_var "hello";    if ($uri = "/test") {        set $my_var "world";    }    return 200 "Value: $my_var\n";}

访问 http://example.com/test 将返回 Value: world。