在 nginx 中,`server_name` 本身不支持直接引用变量进行动态匹配,但可以通过 `map` 指令将请求头(如 host)映射为自定义变量,并在 `server` 块中使用该变量实现逻辑分流。具体做法是定义一个 `map` 块将域名解析为特定标识,然后在 `server` 块的配置中通过 `$variable` 引用这个标识来区分不同的处理逻辑或上游服务。

如何根据 Host 头将不同域名映射到内部变量
要实现这一功能,需要在 `http` 上下文中使用 `map` 指令创建一个变量映射表。该指令以 HTTP 请求的 `Host` 头部作为输入键,输出一个自定义变量(例如 `$backend_pool`)。当请求进入时,Nginx 会查找匹配的域名并赋值给该变量,从而让后续的 `proxy_pass` 或 `root` 指令能够基于此变量做出动态选择。

http {
# 定义 map 块,将 host 映射到 backend_pool 变量
map $host $backend_pool {
default "default_backend";
~^www\.(?<sub>.+)$ "$sub_backend";
api.example.com "api_pool";
static.example.com "static_pool";
}
server {
listen 80;
server_name _; # 捕获所有未明确匹配的请求
location / {
# 根据映射结果动态设置代理目标
proxy_pass http://$backend_pool;
}
}
}上述配置中,`~^www\.(?.+)$` 使用了正则表达式提取子域名部分。如果请求来自 `blog.example.com`,它不会匹配 `api.example.com`,而是匹配默认项或需要更细致的正则规则。若需精确匹配子域名,应使用 `~*^(?[^.]+)\.example\.com$` 并将值设为 `$sub` 对应的后端。实际运行时,`$backend_pool` 的值取决于 `Host` 头与 `map` 规则的匹配顺序,第一个匹配的规则生效。
如何处理通配符和正则域名的优先级冲突
当 `server_name` 或 `map` 规则中存在通配符(如 `*.example.com`)和正则表达式(如 `~^.*\.example\.com$`)时,Nginx 遵循特定的匹配优先级:精确字符串匹配最高,其次是通配符,最后是正则表达式。在 `map` 指令中,这种优先级同样适用,确保复杂域名场景下的路由正确性。

# 假设我们有以下 map 规则
map $host $pool {
example.com "main";
*.example.com "subdomain";
~^mail\..+\.example\.com$ "mail_service";
default "catch_all";
}
# 测试用例分析
# 1. host: example.com -> 匹配 "main" (精确匹配优先)
# 2. host: www.example.com -> 匹配 "subdomain" (通配符次之)
# 3. host: mail.example.com -> 匹配 "mail_service" (正则最后,但若通配符已覆盖则需注意)
# 注意:在 map 中,正则表达式 ~ 开头的规则通常放在后面,因为前缀匹配更快。
# 如果希望 mail.example.com 走专用服务,需确保其不被通配符 .* 提前捕获。
# 修正后的 map 应显式列出 mail.example.com 或使用更具体的正则:map $host $pool {
example.com "main";
mail.example.com "mail_service"; # 显式精确匹配,避免被通配符覆盖
*.example.com "subdomain";
default "catch_all";
}在实际部署中,建议将高频访问的特定域名放在 `map` 的前面,以提高匹配效率。同时,`server_name` 指令中的通配符和正则表达式行为与 `map` 类似,但 `server_name` 用于确定哪个 `server` 块处理请求,而 `map` 用于在同一个 `server` 块内进一步细分逻辑。两者结合使用时,应先由 `server_name` 定位到正确的 `server` 块,再由 `map` 决定内部转发目标。
当 Host 头缺失或为空时 map 指令返回什么
如果客户端发送的请求中没有 `Host` 头(例如 HTTP/1.0 请求或未设置 Host 头的连接),`$host` 变量的值为空字符串。此时,`map` 指令将尝试匹配空字符串对应的规则。如果没有显式定义空字符串的映射,它将回退到 `default` 指定的值。这意味着即使没有 Host 头,系统也能提供一个安全的默认后端,防止因变量未定义导致的错误。
map $host $pool {
"" "empty_host_handler"; # 显式处理空 Host
default "default_backend";
}在上述代码中,如果 `$host` 为空,`$pool` 将被设置为 `empty_host_handler`。这允许管理员为非法或缺失 Host 头的请求提供专门的错误页面或重定向逻辑,而不是将其混入正常流量。验证此行为可通过 curl 命令模拟:`curl -H "Host: " http://localhost`,观察响应是否来自配置的默认或空值处理逻辑。


















