至于场景回顾。Nginx 反向代理导致的 504 超时

最近利用 Nginx 做了一个反向网站，将请求转发到后端域名。

server {
listen;不过，location /api/asset/upload/ {
proxy_pass https://asset.zlhub.com;proxy_set_header X-Track-Id $request_id;proxy_set_header Content-Type $content_type;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;怎么说呢，proxy_ssl_server_name on;proxy_ssl_verify off;怎么说呢，}
}

痛点一的观点是。持续的 504 超时

运行几个星期后监控报出大量 504 Gateway Timeout。直连后端域名没有问题，日志里显示 Nginx 使用的后端 IP 已经失效。

再看痛点二，手动排查发现 IP 已变更

通过 DNS 查询确认：

;<> DiG .-0ubuntu5-Ubuntu <> @. asset.zlhub.cn
global options: +cmd
Got answer:
->HEADER<- opcode: QUERY, status: NOERROR, id: ...
;; QUESTION SECTION:
;asset.zlhub.cn.            IN      A
;; ANSWER SECTION:
asset.zlhub.cn.   IN      CNAME   alb-bd91a9vsooow8dv40otdle5l.cn-beijing.volcenginealb.com.
alb-bd91a9vsooow8dv40otdle5l.cn-beijing.volcenginealb.com. IN A   203.0.113.12
;; Query time: ... msec

发现域名对应的 IP 已经变化。但 Nginx 仍然使用旧 IP 发起请求，于是超时。说起来，

Nginx 为什么会“卡死”在旧 IP 上？

在 proxy_pass 中写的是域名，Nginx 只在 启动 / 重载 / 重启 时解析一次 DNS 并缓存结果。话说回来，之后即使 DNS TTL 到期，也不会自动更新。

如果后端域名背后有多个 IP 且频繁变动。就会出现「Nginx 把请求转发到过期 IP」的问题，最终表现为 504 超时。

说到方法，让 Nginx 动态解析域名

主要指令这方面。resolver 与 resolve 参数

http {
resolver 8.8.8.8 valid=300s ipv6=off;resolver_timeout 10s;upstream backend {
server backend1.example.com resolve;server backend2.example.com resolve;
}
server {
location / {
proxy_pass http://backend;}
}
}

resolver 指定 DNS 服务器及缓存有效期；说起来，resolve 参数让 upstream 在每次请求前重新查询域名。

再看细节补全，保持原始 Host & HTTPS 支持

• Pain Point: 在共享网关上使用虚拟主机时如果 Host 被改成 “backend”。会因找不到对应的 server_name 而返回 “Service Temporarily Unavailable”。解决办法是强制把 Host 设置回原始域名。
• Pain Point: 后端强制走 HTTPS。需要在 upstream 中显式声明端口，否则默认走 HTTP 导致握手失败。

完整可直接使用的配置示例

resolver 8.8.8.8 valid=30s;upstream backend_dynamic {
zone backend_dynamic 64k;server asset.zlhub.cn:443 resolve;# 自动解析并使用 HTTPS 端口
}
server {
listen;error_log /dev/stderr debug;怎么说呢，location /api/asset/upload/ {
proxy_pass https://backend_dynamic;# 保持业务所需 Header
proxy_set_header X-Track-Id $request_id;proxy_set_header Content-Type $content_type;proxy_set_header Host asset.zlhub.cn;# ← 防止 Host 被
proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;# HTTPS 专属设置
proxy_ssl_server_name on;proxy_ssl_verify off;}
}
# 修改模板后记得重建容器
# docker compose up -d --force-recreate

至于效果验证，TCPDump 抓包展示动态解析成功

左侧为客户端发起请求。右侧通过 tcpdump -i any host asset.zlhub.cn and port 443 可以看到 Nginx 实际向最新解析得到的 IP 发起了 TLS 握手，404/504 再也没有出现。

小结——一分钟搞定动态域名解析

• Pain Point: 避免因 DNS 缓存导致的间歇性超时。
• Pain Point: 不再需要每次修改后手动 reload Nginx。怎么说呢，
• Pain Point: 保持原始 Host。兼容共享网关和虚拟主机，
• Pain Point: 完全支持 HTTPS 后端，无需额外代理层。