Nginx proxy_pass 怎么配置动态域名解析地址-Nginx-PHP中文网

要让 proxy_pass 动态解析域名，必须同时满足：用变量承载域名、同级作用域显式配置 resolver、proxy_pass 值中不带硬编码路径；否则仍为启动时静态解析。

nginx proxy_pass 怎么配置动态域名解析地址

要让 proxy_pass 实际生效动态域名解析，关键不是“写个域名就行”，而是必须满足三个硬性条件：用变量承载域名、在同级作用域显式配置 resolver、proxy_pass 值中不带硬编码路径。缺一不可。

Nginx 默认对 proxy_pass http://api.example.com; 这类写法只在启动时解析一次 IP，后续全靠缓存，无法响应 DNS 变更。真正触发运行时解析的写法是：

在 location 或 server 块内，先用 set 定义变量，例如：set $backend "api-v2.example.com";
在同一块内（不能只放在 http 块顶层），声明 resolver，例如：resolver 8.8.8.8 valid=30s;
proxy_pass 必须引用该变量且保留原始路径：proxy_pass http://$backend$request_uri;

resolver 指令的位置非常敏感：

FastAPI Flask Proxy

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

下载

如果用于 proxy_pass 变量方式，推荐直接写在 location 或 server 块内，作用域明确，避免旧版本兼容问题
如果用于 upstream 动态解析（Nginx ≥1.19.0），则 resolver 必须放在 http 块顶层，且 upstream 中的 server 行必须带端口并加 resolve 关键字，例如：server api.example.com:8080 resolve;
valid 参数决定 DNS 缓存时间，建议设为 10–60 秒；太长（如 300s）会导致后端 IP 变更后仍转发到失效地址，引发 502/504

不要把路径拼进 proxy_pass 的变量里，否则容易丢路径或引发重定向循环：

错误写法：set $backend "api.example.com/v2"; proxy_pass http://$backend$request_uri;（可能造成双 /v2）
正确做法：用 rewrite 提前剥离或改写 URI，再用无路径的 proxy_pass，例如：rewrite ^/v2/(.*)$ /$1 break;，然后 proxy_pass http://$backend;
若需根据请求头或参数选不同后端，优先用 map 指令生成变量，逻辑更清晰、可维护性更强

如果配置后仍走静态解析，大概率是以下某一项没做对：

proxy_pass 写成了字面量域名（如 http://api.example.com），而不是变量（如 http://$backend）
resolver 被误放在 upstream 或 http 块顶层，而当前使用的是 location 级变量方式
proxy_pass 结尾写了 /，导致 $request_uri 被丢弃，后端收不到原始路径
DNS 服务器不可达或超时，建议配两个 resolver（如 8.8.8.8 114.114.114.114）并设 resolver_timeout 5s