如何利用 proxy_pass 中的变量动态构建后端路径连接实战教程-Nginx-PHP中文网

nginx中proxy_pass不支持uri路径含变量，推荐用map预定义upstream映射实现动态后端；次选resolver+变量实现动态dns解析；或rewrite+proxy_pass组合动态改写路径，三者均需规避常见配置陷阱。

如何利用 proxy_pass 中的变量动态构建后端路径连接实战教程

proxy_pass 本身不支持在 URI 路径部分拼接变量，比如 proxy_pass http://$host:$port/api; 会直接报错。这不是配置写法问题，而是 Nginx 架构决定的：URI 解析发生在配置加载时，而变量只在请求处理时才可取值。但真实业务中又确实需要动态后端路径——关键在于绕开限制，用安全、原生、可控的方式实现。

用 map 预定义可信后端映射（最推荐）

这是无需额外模块、兼容性好、逻辑清晰的首选方案。核心是把“判断逻辑”提前到配置解析阶段，用 map 将请求特征（如参数、头信息、路径）映射为已声明的 upstream 名称，再由 proxy_pass 引用该名称。

必须先定义 upstream 块，名称要和 map 输出完全一致
map 块需放在 http 级，不能在 location 内；变量名如 $upstream_name 可在后续 location 中直接使用
proxy_pass 后只能写 http://$upstream_name，不能加任何路径（否则变量失效）

示例：按查询参数 env 切流量

http {
  upstream api_prod { server 10.0.1.10:8080; }
  upstream api_staging { server 10.0.2.20:8080; }
  map $arg_env $upstream_name {
    default "api_prod";
    "prod" "api_prod";
    "staging" "api_staging";
  }
  server {
    location /api/ {
      proxy_pass http://$upstream_name;
    }
  }
}

用 resolver + 变量触发动态 DNS 解析

当后端地址是域名且 IP 经常变更（如 K8s Service、云函数域名），需每次请求前重新查 DNS。这必须同时满足两个条件：proxy_pass 的值是变量，且同级或外层有 resolver 指令。

resolver 必须写在 location 或 server 块内，不建议放 http 全局（旧版本不继承）
set 定义的变量只含域名（不带协议、端口、路径），协议和端口写在 proxy_pass 中
valid= 时间设为略小于后端 DNS TTL，避免缓存过期后仍连旧 IP

示例：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

location /legacy/ {
  resolver 114.114.114.114 valid=10s;
  set $backend "old-api.example.com";
  proxy_pass https://$backend:443/;
}

用 rewrite + proxy_pass 组合构造动态路径

如果目标是动态拼接后端请求路径（而非主机），可用 rewrite 提前改写 $request_uri，再交由 proxy_pass 转发。这种方式适用于路径规则明确、可正则提取的场景。

rewrite 必须加 break，防止继续匹配其他 location
proxy_pass 末尾不带路径，确保 rewrite 后的完整 URI 被传递
避免在 if 块里用 proxy_pass（Nginx 明确不推荐）

示例：把 /v2/{service}/xxx → 转发到 http://$service.internal:8080/xxx

location ~ ^/v2/(?[a-z]+)(?
rewrite ^/v2/[^/]+(.*)$ $1 break;
proxy_pass http://$svc.internal:8080;
}

注意事项与避坑点

有些看似合理写法实际无效，务必避开：

proxy_pass http://$host:$port/api —— URI 部分含变量，启动即失败
resolver 在 http 块，set 和 proxy_pass 在 location —— 低版本 Nginx 不识别，DNS 不刷新
set $url "https://api.com"; proxy_pass $url —— 协议不能塞进变量，会触发 500 或连接异常
location 正则匹配时 proxy_pass 带路径 —— 如 location ~ /api/ { proxy_pass http://b.com/v1/; }，Nginx 直接拒绝加载