如何配置本地 resolver 指令动态解析 upstream 域名以防 IP 变更导致瘫痪-Nginx-PHP中文网

nginx upstream 域名动态解析需满足三条件：resolver 必须置于 http/server 顶层、带 valid= 缓存时效（如 valid=20s）、通过变量 proxy_pass 或 server resolve 显式触发运行时查询，缺一不可。

如何配置本地 resolver 指令动态解析 upstream 域名以防 ip 变更导致瘫痪

要让 Nginx 对 upstream 域名真正实现运行时动态解析，防止后端 IP 变更后持续 502、请求打到旧地址，关键不是加个 resolver 就完事，而是让它“活起来”——即每次请求或按 TTL 主动刷新 DNS 结果。本地 resolver 配置必须满足三个硬性条件：位置正确、带缓存时效、有触发机制。

resolver 必须放在 http 或 server 块顶层

不能写在 upstream、location 或 events 块里，否则 Nginx 启动会报错，或日志反复提示 no resolver defined。推荐统一放在 http 块中，全局生效：

✅ 正确示例：

http {<br>  resolver 127.0.0.1:53 valid=20s;<br>  # 其他 server/upstream 配置<br>}

❌ 错误写法：
把 resolver 放进 upstream {} 或某个 location 内 —— 作用域失效，upstream 块完全无法继承
本地 DNS（如 CoreDNS、dnsmasq、Consul DNS）建议监听 127.0.0.1:53 或内网地址，避免走公网延迟和不稳定

valid= 参数是动态生效的核心

没有 valid=，Nginx 默认缓存永不超时，等于静态解析。这个值决定了 DNS 缓存多久后强制重查，直接关系故障恢复时间：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

设为 valid=20s：IP 变更后最多 20 秒内自动切到新地址
设为 valid=5s：适合服务发现高频变更场景（如 Kubernetes Service DNS），但需确保本地 DNS 响应快、不丢包
可叠加 resolver_timeout 2s; 防止 DNS 查询阻塞 worker 进程

必须用变量或 resolve 显式触发查询

即使 http 块已配好 resolver，只要 upstream 写的是 server api.example.com;，Nginx 仍只启动时查一次。要打破死锁，必须显式激活运行时解析：

方式一（兼容所有版本）：用变量 + proxy_pass
```
set $backend "api.example.com:8080";<br>proxy_pass http://$backend;
```
⚠️ 注意：http:// 协议头不能省，否则不触发 DNS 查询
方式二（Nginx ≥ 1.19.0）：upstream 中启用 resolve
```
upstream backend {<br>  server api.example.com:8080 resolve valid=20s;<br>}
```
server 行必须写域名，不能写 IP；且外层 http 块已声明 resolver

验证是否真正在动态更新

别信 nginx -t，它只校验语法。真实效果看运行时行为：

修改本地 DNS 记录（比如把 api.example.com 指向新 IP）
等待超过 valid= 设定的时间（如 20 秒）
检查 error.log 是否出现：
resolved api.example.com to 10.20.30.40
resolving api.example.com...
若长期只有首次解析日志，说明变量没被 proxy_pass 引用，或 valid 未生效