Nginx集群中域名配置需启用resolver+valid及upstream内resolve关键字才能实现DNS动态刷新;否则默认长期缓存导致转发异常。

在 Nginx 集群中,后端服务若通过域名(而非固定 IP)配置在 proxy_pass 或 upstream 中,DNS 解析波动会直接引发流量转发异常——比如解析到已下线节点、缓存过期 IP 导致连接超时、或轮询不均造成部分实例过载。这不是偶发网络问题,而是 Nginx 默认 DNS 行为与动态基础设施不匹配的必然结果。
明确 DNS 缓存机制是前提
Nginx 不遵循系统 /etc/resolv.conf 或 DNS 记录中的 TTL;它只在首次建立连接时解析域名,并将结果长期缓存(实测可达数周)。reload 或 -t 操作不会刷新缓存,只有重启或触发新连接才可能更新——这正是集群中“改了 DNS 却没生效”的根源。
关键点:
- 缓存发生在 worker 进程级,每个 worker 独立缓存,不同进程可能持有不同 IP
- 静态写死在
proxy_pass http://example.com的域名,不会自动重解析 - 即使上游做了健康检查(
max_fails),也只对已知 IP 生效,无法感知新增/废弃的 IP
必须启用 resolver + valid 参数
在 http 块中显式配置 DNS 解析器,是解决波动的基础动作:
resolver 8.8.8.8 114.114.114.114 valid=60s;
resolver_timeout 5s;
说明:
-
valid=60s强制 Nginx 每 60 秒重新查询 DNS,避免长期滞留失效 IP(建议设为上游 DNS TTL 的 1/3~1/2) - 至少配置两个 DNS 服务器,防止单点解析失败导致整个 upstream 不可用
-
resolver_timeout避免 DNS 查询阻塞请求,超时后可 fallback 到旧缓存或触发proxy_next_upstream
配合 resolve 关键字实现真正动态解析
仅靠全局 resolver 不够——它只影响变量形式的域名解析。要让 upstream 块内的域名实时刷新,必须加 resolve 标识:
upstream backend {
server api.example.com resolve;
keepalive 32;
}
这样 Nginx 才会在每次选择 server 时,依据 resolver valid 设置重新查 DNS,获取最新 A 记录列表,并结合负载算法分发请求。
注意:
- 不能混用 IP 和域名在同一 upstream 中(如
server 192.168.1.1和server api.example.com resolve) - 需搭配
proxy_next_upstream error timeout http_502,确保单个 IP 失败后能自动尝试其他解析结果
生产环境建议组合策略
单一手段难以覆盖所有波动场景,推荐三层防护:
- DNS 层:上游 DNS 设置合理 TTL(如 60s),并启用健康探测自动剔除故障 IP
-
Nginx 层:使用
resolver + valid + resolve组合,确保解析时效性;禁用proxy_cache_valid对 upstream 的干扰 - 运维层:定期用
nginx -t && nginx -s reload作为兜底(尤其在已知大规模 IP 变更后),但不依赖它作为常态方案
不复杂但容易忽略


















