Nginx 中 proxy_pass 如何配置动态域名转发解析-Nginx-PHP中文网

nginx实现proxy_pass动态域名解析的核心是变量+resolver+作用域匹配：必须用变量（如$backend）承载域名，配合同级location/server块内的resolver指令（如resolver 8.8.8.8 valid=30s），且proxy_pass需写为http://$backend$request_uri；直接写死域名或resolver位置错误均导致静态解析。

nginx 中 proxy_pass 如何配置动态域名转发解析

要让 Nginx 的 proxy_pass 实现动态域名转发解析，核心是打破默认的“启动时静态解析”机制——Nginx 默认对字面量域名（如 proxy_pass http://api.example.com;）只解析一次，后续全靠缓存 IP，无法响应后端 DNS 变更。真正可行的做法是：**用变量承载域名 + 显式配置 resolver + 确保作用域匹配**。

必须启用 resolver 并放在正确位置

Nginx 不会自动读取系统 DNS 配置（如 /etc/resolv.conf），必须手动指定 DNS 服务器。resolver 不能只写在 http 块顶层（旧版本不支持），推荐直接写在使用变量的 location 或 server 块内：

resolver 8.8.8.8 valid=30s;（公共 DNS，适合测试）
resolver 127.0.0.11 valid=10s;（Docker 内置 DNS）
resolver kube-dns.kube-system.svc.cluster.local valid=5s;（K8s 环境）

valid 参数决定 DNS 缓存有效期，太长（如 300s）会导致节点变更延迟生效，太短（如 1s）易引发 DNS 查询风暴，10–60 秒是常见平衡点。

proxy_pass 必须使用变量且不含硬编码路径

以下写法才能触发运行时解析：

FastAPI Flask Proxy

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

下载

✅ 正确：set $backend "api-v2.example.com"; proxy_pass http://$backend$request_uri;
✅ 正确（配合 map）：map $arg_env $upstream { default "api-prod.example.com"; "staging" "api-staging.example.com"; } location / { proxy_pass http://$upstream$request_uri; }
❌ 错误：proxy_pass http://api.example.com;（无变量，永远静态）
❌ 错误：proxy_pass http://$backend/;（结尾带 / 会丢弃原始路径，$request_uri 失效）

路径处理需与变量解耦

若需根据请求动态改写后端路径（比如租户路由、版本前缀），不要把路径拼进 proxy_pass，而是用 rewrite 预处理 URI：

用 rewrite ^/(v\d+)/(.*)$ /$2 break; 提取版本号并剥离
再用 proxy_pass http://backend;（无路径，交由 Nginx 自动补全）
或结合 map 提取路径片段：map $uri $path_prefix { ~^/tenant-(\w+)/ $1; }，然后在 proxy_pass 中引用

这样既保持路径逻辑清晰，又避免因拼接错误导致 404 或循环重定向。