Nginx 主配置文件中怎么正确嵌套 upstream 实现负载均衡-Nginx-PHP中文网

nginx 不支持 upstream 块嵌套，必须定义在 http{} 顶层；分层调度需通过 map、split_clients 或多级 proxy_pass + rewrite 等运行时机制实现，而非配置结构嵌套。

nginx 主配置文件中怎么正确嵌套 upstream 实现负载均衡

Nginx 不支持 upstream 块的直接嵌套，比如在另一个 upstream 里写 upstream 或用 upstream 包裹 upstream。这种写法会触发配置错误：unknown directive "upstream"，因为 upstream 只能定义在 http{} 块顶层，不能出现在 server{}、location{} 或其他 upstream{} 内部。

真正可行的做法，是用逻辑分层替代结构嵌套——把“哪类请求发给哪组后端”这个决策，从配置层级转移到请求处理流程中。

✅ 正确实现分层调度的常用方式

使用 `map` 指令动态选择 upstream 名称

适用于按域名、路径、Header、IP 等特征分流到不同后端组。

http {
    # 定义多个 upstream 组（必须在 http 块顶层）
    upstream api_v1 {
        server 10.0.1.10:3000;
        server 10.0.1.11:3000;
    }

    upstream api_v2 {
        server 10.0.2.20:3000 weight=2;
        server 10.0.2.21:3000;
    }

    upstream admin_backend {
        server 10.0.3.30:8080;
    }

    # 根据 host 或 path 映射到 upstream 名称（字符串变量）
    map $host $backend_group {
        default           "api_v1";
        ~^v2\.api\.example\.com$  "api_v2";
        ~^admin\.example\.com$     "admin_backend";
    }

    server {
        listen 80;
        server_name ~^(?<sub>.+)\.example\.com$;

        location / {
            proxy_pass http://$backend_group;  # 动态引用
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}</sub>

⚠️ 注意：proxy_pass 后必须带协议（http://）和变量名，不能写成 http://$backend_group/ 加尾部斜杠（会导致路径重复拼接）。

利用 `split_clients` 实现灰度或流量比例分层

适合 A/B 测试、新老版本按百分比分流。

Nginx Hosting

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

下载

http {
    split_clients "${remote_addr}AAA" $upstream_name {
        50%     "backend_v1";
        50%     "backend_v2";
    }

    upstream backend_v1 {
        server 192.168.1.100:8080;
    }

    upstream backend_v2 {
        server 192.168.1.101:8080;
    }

    server {
        location / {
            proxy_pass http://$upstream_name;
        }
    }
}

✅ split_clients 基于哈希保证同一客户端始终命中同一组，适合需稳定路由的场景。

多级 `proxy_pass` + `rewrite` 实现路径导向分层

适合按 URI 前缀划分服务域（如 /user/ → 用户服务，/order/ → 订单服务）。

http {
    upstream user_svc {
        server 10.10.1.1:8001;
        server 10.10.1.2:8001;
    }

    upstream order_svc {
        server 10.10.2.1:8002;
        server 10.10.2.2:8002;
    }

    server {
        location ^~ /user/ {
            rewrite ^/user/(.*)$ /$1 break;
            proxy_pass http://user_svc;
        }

        location ^~ /order/ {
            rewrite ^/order/(.*)$ /$1 break;
            proxy_pass http://order_svc;
        }

        # 兜底默认入口
        location / {
            proxy_pass http://user_svc;
        }
    }
}