Web 服务器与网关 / 系统课时

使用变量与 map

使用变量与 map

本课解决 Nginx 配置中根据请求特征动态生成配置值的问题。通过内置变量和 map 指令,可以把复杂判断转换为清晰的数据映射规则,提升网关配置的可维护性。

学习目标

  • 理解 Nginx 常用变量的来源和使用方式。
  • 掌握 map 指令根据条件生成新变量的方法。
  • 学会避免在复杂场景中过度使用 if 指令。

理解 Nginx 变量模型

Nginx 变量是运行时计算的配置值,来源包括客户端请求、连接状态、服务器信息和处理阶段数据。例如 $host 表示请求主机名,$request_uri 表示当前 URI,$http_user_agent 可以获取客户端 User-Agent 请求头。

变量通常用于日志记录、转发控制、缓存策略和访问限制。它们本身不是固定配置,而是在请求处理过程中由 Nginx 解析得到。

使用 map 根据条件生成变量

map 用于建立输入变量到输出变量的映射。它适合处理多个条件分支,例如根据请求头判断设备类型、根据域名选择后端策略。

nginx
http {
    # 根据请求头生成访问策略变量
    map $http_user_agent $client_type {
        default desktop;
        ~*Mobile mobile;
    }

    server {
        listen <PORT>;

        location / {
            add_header X-Client-Type $client_type;
            proxy_pass http://backend;
        }
    }
}

预期结果

text
请求头包含 Mobile 时,响应头增加 X-Client-Type: mobile
其他请求默认增加 X-Client-Type: desktop

map 的第一个参数是输入变量,第二个参数是生成的新变量。匹配规则从上到下判断,未命中的请求使用 default 结果。

map 与 if 的使用边界

简单判断可以使用 if,但在 location 中大量嵌套 if 容易让配置难以理解。map 更适合提前定义规则,把条件计算集中到 http 上下文中。常见场景包括:

  • 根据域名映射不同上游服务。
  • 根据 Cookie 或请求头选择灰度版本。
  • 根据 URI 判断缓存或转发策略。

验证变量配置

修改配置后,应先检查语法,再重新加载服务。

bash
nginx -t && nginx -s reload

预期结果

text
syntax is ok
configuration file test is successful

如果变量未生效,优先检查变量名称是否正确、map 是否位于 http 上下文,以及请求是否真正包含匹配条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用变量与 map

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通