Nginx 中 location 块如何通过 map 指令实现动态配置-Nginx-PHP中文网

map指令只能在http或server块中定义，用于启动时建立请求特征到变量的静态映射，不可在location内使用，但可在location中引用其变量实现动态路由。

nginx 中 location 块如何通过 map 指令实现动态配置

Nginx 中的 map 指令本身不能直接写在 location 块内，它只能出现在 http 或 server 上下文中。但你可以用 map 提前定义变量，再在 location 中通过 if、set 或匹配逻辑引用这些变量，从而实现“动态配置”的效果。

map 指令的作用是变量映射，不是运行时判断

map 是在 Nginx 启动或重载配置时一次性计算并建立键值映射关系的指令，它不支持运行时条件分支，也不支持嵌套或复杂表达式。它的核心价值在于把请求特征（如 Host、URI、Header）映射为一个可复用的变量，供后续指令使用。

映射源可以是任意内置变量（$host、$args、$http_user_agent 等）
目标变量必须以 $ 开头，且不能与已有变量同名
支持正则匹配、默认值（default）、空值处理（""）

在 location 中使用 map 变量的典型方式

定义好 map 后，在 location 块中可通过 if 判断变量值、用 set 衍生新值，或配合 proxy_pass、return、rewrite 实现动态行为。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

用 if ($my_backend) { ... } 控制代理目标或返回码
用 set $upstream_host $my_backend; 再传给 proxy_pass http://$upstream_host;
配合 try_files 或 error_page 实现基于变量的路径路由

一个实用示例：按域名动态选择后端集群

比如根据 Host 头自动切换 upstream：

http {
    map $host $backend {
        default          "default-backend";
        ~^app\.example\.com$  "app-cluster";
        ~^api\.example\.com$  "api-cluster";
        ~^admin\.example\.com$ "admin-cluster";
    }

    upstream default-backend { server 10.0.1.10:8080; }
    upstream app-cluster    { server 10.0.2.20:8080; }
    upstream api-cluster    { server 10.0.3.30:8080; }
    upstream admin-cluster  { server 10.0.4.40:8080; }

    server {
        listen 80;
        location / {
            proxy_pass http://$backend;
            proxy_set_header Host $host;
        }
    }
}

注意：proxy_pass 后必须带协议和变量（如 http://$backend），不能只写 $backend；Nginx 会自动解析变量对应的 upstream 名称。