Nginx 中 proxy_pass 如何根据请求头动态选择后端-Nginx-PHP中文网

可在nginx中用http块内map指令基于请求头（如$http_x_env）映射变量$upstream_name，配合预定义upstream块实现动态路由；proxy_pass须写为http://$upstream_name，不加路径；支持正则/精确匹配及嵌套map联合判断，并需设default值防502。

nginx 中 proxy_pass 如何根据请求头动态选择后端

可以在 Nginx 中用 map 指令从请求头提取值，映射为变量，再让 proxy_pass 引用该变量实现动态路由。核心是把判断逻辑提前到配置层，而不是在运行时拼接地址。

在 http 块中定义 map 映射

只能在 http 块里定义 map，不能放在 server 或 location 内。常用请求头如 $http_x_env、$http_user_agent、$http_authorization 都可作为输入源：

支持正则匹配（~ 区分大小写，~* 不区分）和精确匹配（=）
必须设 default 值，避免变量未命中时为空导致 502
输出变量名要带 $，比如 $upstream_name

示例：根据自定义头 X-Env 切集群

http {
  map $http_x_env $upstream_name {
    default "backend_default";
    "prod" "backend_prod";
    "staging" "backend_staging";
    "dev" "backend_dev";
  }
}

配合 upstream 块使用更稳妥

推荐将 map 输出映射为已声明的 upstream 名称，而非直接拼 URL。这样能复用连接池、健康检查等能力，也规避了协议/端口硬编码风险：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

upstream 块需提前定义，名称必须与 map 输出完全一致
proxy_pass 写法必须是 http://$upstream_name 或 https://$upstream_name，结尾不能带路径
如果加了路径（如 http://$upstream_name/api），变量会失效，Nginx 直接报错

示例：

upstream backend_prod {
  server 10.0.1.10:8080;
}
upstream backend_staging {
  server 10.0.2.20:8080;
}

server {
  location /api/ {
    proxy_pass http://$upstream_name;
    proxy_set_header Host $host;
  }
}