如何配置 upstream 模块支持对后端集群进行基于正则表达式的调度-Nginx-PHP中文网

nginx的upstream模块本身不支持正则调度，但可通过map指令基于$request_uri等变量匹配正则，动态映射到预定义upstream组，再由proxy_pass调用，实现按规则分流。

如何配置 upstream 模块支持对后端集群进行基于正则表达式的调度

Nginx 的 upstream 模块本身不支持基于正则表达式的调度逻辑。它的调度算法（如 rr、least_conn、ip_hash、hash $arg_xxx 等）作用于请求的固定变量（如 $remote_addr、$request_uri、$args、$host），而非运行时对 URI 或 header 进行动态正则匹配并据此选后端。

但你可以通过 组合 map 指令 + upstream 分组 + proxy_pass 动态变量，间接实现“按正则规则分流到不同 upstream 组”的效果。这不是 upstream 内部做正则调度，而是由 Nginx 在 proxy 阶段前，用 map 提前计算出目标 upstream 名称。

✅ 正确做法：用 `map` 实现基于正则的 upstream 路由

1. 定义多个 upstream 组

upstream api_v1 {
    server 10.0.1.10:8000;
    server 10.0.1.11:8000;
}

upstream api_v2 {
    server 10.0.2.10:8000;
    server 10.0.2.11:8000;
}

upstream admin_backend {
    server 10.0.3.10:9000;
}

2. 使用 `map` 根据 `$request_uri`（或其他变量）匹配正则，映射到 upstream 名

map $request_uri $backend_upstream {
    default              "api_v1";

    ~^/api/v1/.*          "api_v1";
    ~^/api/v2/[a-z]+/id/\d+  "api_v2";
    ~^/admin/(login|logout|dashboard)  "admin_backend";
    ~*\.(js|css|png|jpg|gif)$  "api_v1";  # 静态资源也走 api_v1
}

⚠️ 注意：map 块必须在 http { } 级别定义，不能放在 server 或 location 内。

3. 在 location 中使用动态 `proxy_pass`

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://$backend_upstream;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

✅ 此时 Nginx 会先执行 map 匹配，确定 $backend_upstream 的值（如 "api_v2"），再将请求代理到 http://api_v2 对应的 upstream 组。

Upload audio to AIOZ Stream

快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象，上传文件并完成处理后返回音频链接。

下载

❌ 常见错误（不可行）

在 upstream { } 块里写 if 或正则判断 → 语法不支持，配置会报错
在 proxy_pass 中直接写正则路径，如 proxy_pass http://backend~/v2/ → Nginx 不识别这种写法
试图让 ip_hash 或 hash $request_uri 执行正则提取 → hash 只接受完整变量或简单表达式，不支持 ~ 匹配

? 补充：若需更复杂路由逻辑（如多条件、header+uri组合）

可叠加多个 map：

map $http_user_agent $is_mobile {
    "~*Android|iPhone"  1;
    default             0;
}

map $is_mobile:$request_uri $route_to {
    "1:/api/"           "mobile_api";
    "0:/api/"           "desktop_api";
    default             "fallback";
}

然后 proxy_pass http://$route_to;