要让Nginx响应后端IP变更,必须三者齐备:在http块顶层配置resolver并带valid参数(如valid=30s)、proxy_pass必须用变量(如http://$backend)触发实时解析、验证需查error.log中resolving日志。

要让 Nginx 真正响应后端域名的 IP 变更(比如容器重建、云主机漂移、SLB 切换),不能只加 resolver 就完事——必须让它“动起来”。核心是三件事:指定可用 DNS 服务器、控制缓存时效、用变量或 resolve 参数触发实时查询。
resolver 必须放在 http 块顶层,且带 valid 参数
它不读取系统 /etc/resolv.conf,也不继承自其他块。写错位置等于没配:
- ✅ 推荐写法:
http { resolver 114.114.114.114 8.8.8.8 valid=30s; } - ❌ 错误写法:放在
upstream或events块里(Nginx 直接报错);只写在某个location里(作用域太窄,易遗漏) -
valid=30s是关键——它强制 Nginx 每 30 秒检查一次 DNS 是否更新;不加这个参数,缓存永不刷新 - 多个 DNS 地址用空格分隔,提升容错性;避免用
127.0.0.11(Docker 内置 DNS 在部分环境不可达)
proxy_pass 必须走变量路径,否则仍是静态解析
直接写 proxy_pass http://api.example.com; 是启动时查一次就固化 IP。要激活动态行为,必须让 Nginx “看到”这是一个需运行时解析的地址:
- ✅ 正确示例:
set $backend "api.example.com:8000"; proxy_pass http://$backend; - ⚠️ 注意点:协议前缀
http://不能省,写成$backend或//都无效 - Host 请求头不会自动带出,需手动补:
proxy_set_header Host api.example.com; - 如果用了 HTTPS 后端,记得写
https://$backend,否则可能降级为 HTTP
进阶选择:upstream 中启用 resolve(Nginx ≥ 1.19.9)
需要负载均衡、健康检查等能力时,可改用更规范的方式:
- 保持
http块已有resolver upstream backend { server api.example.com:8080 resolve valid=20s; }- server 行必须写域名,不能写 IP;
resolve必须紧贴在行末,不能换行或加多余空格 - 低于 1.19.9 的版本会忽略
resolve,仍按静态处理
验证是否真正生效,别只看配置
光靠 nginx -t 或 reload 日志无法确认效果,得看运行时行为:
- 修改 DNS 记录(例如把
api.example.com指向一个新 IP),等超过valid设置的时间(如 30 秒) - 查
/var/log/nginx/error.log,出现resolving "api.example.com"或resolved ... to 10.20.30.40才算成功 - 用
ss -tnp | grep :80查看 worker 进程实际连接的目标 IP,比对是否已更新 - 频繁报
no resolver defined或getaddrinfo() failed,先检查 DNS 是否可达、UDP 53 端口是否被防火墙拦截

















