Nginx动态DNS解析需同时满足:resolver指令(带valid=参数)与proxy_pass引用变量,二者缺一不可;valid控制Nginx缓存时长,非DNS TTL;连接复用会影响刷新感知;1.19.9+推荐用upstream resolve替代。

不能做到“每次请求都重新解析 DNS”,Nginx 的 resolver + 变量机制本质是**按缓存有效期(valid)触发解析**,不是每次请求都查。但你可以把缓存时间设得很短(如 1s),接近“每次请求都查”的效果——前提是后端 DNS 响应快、网络稳定,否则会显著拖慢首字节时间(TTFB)。
必须用变量,否则 resolver 完全不工作
proxy_pass 直接写域名(如 proxy_pass https://api.example.com;)会在 Nginx 启动或重载时静态解析一次,之后永远用缓存的 IP,无论 DNS 是否已变更。resolver 指令对这种写法完全无效。
真正启用动态解析的唯一方式是:让 proxy_pass 的值**包含变量**。变量是开关,resolver 是工具,二者缺一不可。
- ✅ 正确(触发 resolver):set $upstream "api.example.com"; proxy_pass https://$upstream;
- ❌ 错误(不触发 resolver):proxy_pass https://api.example.com;
- ⚠️ 注意:变量可以来自 set、$http_xxx 请求头、$arg_xxx 查询参数等,只要 proxy_pass 中引用了变量即可
resolver 必须放在正确作用域,且需指定 valid
resolver 不是全局生效的指令。它必须出现在与变量同级或更外层的配置块中(如 server 或 location),且要带 valid= 参数,否则默认缓存 5 分钟,达不到“高频刷新”目的。
- 推荐写在 location 块内,避免跨块继承问题:location /api/ { resolver 114.114.114.114 8.8.8.8 valid=1s; set $backend "api.example.com"; proxy_pass https://$backend; }
- valid=1s 表示最多缓存 1 秒,超时后下一次新建连接(非复用 keepalive 连接)会重新发起 DNS 查询
- 注意:valid 控制的是 Nginx 自身缓存的生命周期,不是 DNS 记录的 TTL;即使后端 DNS TTL 是 60s,你设 valid=1s,Nginx 仍每秒查一次
连接复用会影响“感知刷新”的时机
Nginx 默认复用 upstream 连接(keepalive)。这意味着即使 valid=1s,只要旧连接还在活跃、被复用,就不会触发新 DNS 查询——你看到的仍是旧 IP。
- 要让 DNS 刷新更快生效,可配合 upstream 的 keepalive 设置(如 keepalive 32;)并合理控制空闲超时
- 更直接的方式:在 location 中加 proxy_http_version 1.1; proxy_set_header Connection ''; 显式启用 HTTP/1.1 keepalive,并避免 connection: close 干扰
- 调试时可用 nginx -T | grep -A5 "proxy_pass" 查看实际展开的配置,或开启 error_log debug 级别观察 resolver 调用日志
替代方案:升级到 1.19.9+,改用 upstream resolve
如果你需要真正的服务发现能力(比如对接 Consul、Kubernetes Headless Service),不建议硬压 valid 到 1s。Nginx 1.19.9+ 支持在 upstream 块中直接使用 resolve 指令:
- upstream backend { server api.example.com resolve; }
- 再配合 proxy_pass http://backend;
- 这种方式支持 SRV 记录、健康检查、自动剔除失败节点,比 location + 变量更健壮,也更适合云原生场景











