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: desktopmap 的第一个参数是输入变量,第二个参数是生成的新变量。匹配规则从上到下判断,未命中的请求使用 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 上下文,以及请求是否真正包含匹配条件。
按自己的节奏,确认真正理解。