Nginx中基于域名的虚拟主机利用map指令实现动态路径跳转-Nginx-PHP中文网

Nginx可通过map指令实现基于域名的动态路径跳转，即在http块中定义$host到$backend_prefix等变量的映射，再于proxy_pass或return中引用，支持精确/正则匹配及default默认值。

nginx中基于域名的虚拟主机利用map指令实现动态路径跳转

在 Nginx 中，基于域名的虚拟主机本身不直接支持“动态路径跳转”，但可以通过 map 指令结合 server_name 和请求路径，实现按域名映射不同后端路径或重定向逻辑——这是一种轻量、高效且配置灵活的动态路由方式。

理解 map 指令的核心作用

map 是 Nginx 的变量映射模块（需启用 ngx_http_map_module，默认已编译），它能在请求处理早期根据某个源变量（如 $host、$request_uri）生成一个新变量。这个新变量后续可在 location、proxy_pass、return 等指令中使用，从而实现条件化行为。

关键点：

必须定义在 http 块中，不能放在 server 或 location 内
匹配是精确的（支持正则和通配符，但需加波浪线 ~ 或星号 *）
未匹配时变量值为空字符串，建议用 default 设默认值

按域名映射不同代理路径（推荐场景）

例如：同一台 Nginx 同时托管 app1.example.com 和 app2.example.com，希望将所有请求分别转发到 http://backend-app1/ 和 http://backend-app2/api/（注意后者带固定前缀）。

配置示例：

http {
    # 定义域名 → 后端路径前缀的映射
    map $host $backend_prefix {
        default              "";
        app1.example.com     "/";
        app2.example.com     "/api/";
    }
<pre class="brush:php;toolbar:false;">server {
    listen 80;
    server_name app1.example.com app2.example.com;

    location / {
        proxy_pass http://127.0.0.1:8000$backend_prefix;
        proxy_set_header Host $host;
    }
}

}

说明：

Nginx Hosting

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

下载

当访问 app2.example.com/v1/users 时，$backend_prefix 为 /api/，最终代理到 http://127.0.0.1:8000/api/v1/users
路径拼接由 Nginx 自动完成，proxy_pass 末尾有斜杠才触发路径替换逻辑

按域名+路径组合做条件重定向

若需对特定域名下的某些路径做跳转（如把旧版路径统一重写），可用 map 组合 $host 和 $request_uri：

http {
    map "$host:$request_uri" $redirect_target {
        default                    "";
        "legacy.example.com/old"   https://new.example.com/migrated;
        "legacy.example.com/old/v2" https://new.example.com/v2;
    }
<pre class="brush:php;toolbar:false;">server {
    listen 80;
    server_name legacy.example.com;

    location / {
        if ($redirect_target) {
            return 301 $redirect_target;
        }
        # 其他正常处理...
    }
}

}

注意：