nginx域名缓存的核心结论:nginx不会自动把proxy_pass里写死的域名解析结果按DNS TTL持续刷新;要让域名解析结果被缓存且可控更新,主流做法是resolver配合变量proxy_pass,并用valid控制缓存时长,HTTP响应缓存交给proxy_cache。
nginx域名缓存怎么配置?先分清DNS缓存与代理缓存
域名解析缓存和proxy_cache不是一回事
不少人一说“nginx域名缓存”,脑子里想的是后端域名换了IP,nginx能自动跟上,也有人把它和页面缓存混在一起,两者其实分工不同。
- DNS解析缓存:resolver把域名解析成IP后,在valid设定的时间内复用结果,它解决“后端找谁”的问题。
- proxy_cache:缓存后端返回的HTTP响应,它解决“重复请求要不要再打后端”的问题。
- 系统DNS缓存和浏览器缓存:发生在nginx之外,排障时别忽略。
| 缓存类型 | 缓存对象 | 典型指令 | 刷新方式 |
|---|---|---|---|
| resolver解析缓存 | 域名对应的A/AAAA记录 | resolver、valid | 到期后重新解析,或reload |
| proxy_cache响应缓存 | 后端HTTP响应 | proxy_cache_path、proxy_cache_valid | 按缓存策略过期 |
| 系统/本机解析 | 主机名到IP | /etc/hosts、系统DNS | 受系统解析器影响 |
哪些场景必须关心域名缓存
- 后端是云数据库域名、Kubernetes Service名、跨地域SLB域名,IP会变。
- 业务做灰度切流,DNS记录短时间调整,不想每次reload nginx。
- 多地域就近解析,同一域名在不同机房返回不同IP。
- 后端端口不变、域名不变,但IP池经常扩缩容。
这些场景里,写死IP最省事,但失去了弹性,写死域名又可能被“启动时只解析一次”坑到。关键不是背指令,而是先确认你的后端地址会不会变。
nginx域名缓存怎么配置?resolver+变量是主线
最小可用配置与验证命令
开源nginx常用做法是把后端域名放进变量,再让proxy_pass引用变量,这样请求到达时才会走resolver,resolver再按valid缓存解析结果。
http {
resolver 223.5.5.5 119.29.29.29 valid=30s ipv6=off;
resolver_timeout 3s;
server {
listen 80;
server_name _;
location /api/ {
set $backend_host "api.example.com";
proxy_pass http://$backend_host:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
}
注意几个实操点:
- resolver可以放在http、server、location层级,按作用范围选择。
- 变量proxy_pass会触发运行时解析,这是和静态域名写法的核心差异。
- valid控制nginx缓存解析结果的时间,不是让nginx完全照搬DNS TTL。
- ipv6=off可在后端只有IPv4时减少AAAA解析带来的超时排查。
改完配置先验证,再平滑重载:
nginx -t systemctl reload nginx curl -I http://127.0.0.1/api/health nginx -T | grep -E "resolver|proxy_pass"
如果返回502,先看error.log里是解析失败、连接超时,还是后端端口不通,别一上来就怀疑缓存。
valid与TTL怎么配合
valid设得太长,DNS切流后nginx可能还拿旧IP打请求,设得太短,解析压力会上来,可以按业务节奏定:
- 后端稳定、变更少:valid可以适当放长,减少解析频率。
- 灰度切流、故障转移频繁:valid放短,比如几十秒,让nginx更快感知。
- 不显式写valid时,按版本默认行为走,生产环境建议明确配置,别靠猜。
- resolver_timeout要设,避免DNS服务器慢时请求长时间挂住。
- 后端有IPv6时再考虑打开ipv6,没有就关掉,排障更清爽。
valid是nginx自己的缓存窗口,和权威DNS的TTL不是同一个开关。 业内专家指出,DNS缓存时间要和业务切流节奏一起设计,单看TTL容易误判。
upstream动态解析的替代做法
开源版里,upstream中直接写域名,通常在启动或reload时解析,后端IP变了,不reload就可能继续打旧地址,商业版nginx提供更完整的动态解析能力,开源环境更常见的是变量proxy_pass配合resolver,选哪种,看团队运维习惯和版本能力,不要为了“看起来高级”把配置弄复杂。
nginx proxy_pass 域名解析缓存对比:写死域名和变量解析差在哪
三种写法对比
| 写法 | 解析时机 | DNS变化后 | 适用场景 |
|---|---|---|---|
| proxy_pass http://api.example.com; | 启动/reload时解析 | 通常要reload才更新 | 后端IP稳定 |
| proxy_pass http://$backend_host; + resolver | 请求时解析,按valid缓存 | 缓存到期后可更新 | 后端域名会变 |
| upstream写域名 | 启动/reload时解析 | 开源版通常要reload | 固定后端池 |
nginx域名缓存失效怎么办?排查顺序
遇到“域名明明切了,nginx还打旧IP”,按下面顺序查:
- 用resolver里的DNS服务器直接查:
dig @223.5.5.5 api.example.com +short,确认权威侧是否已生效。 - 看nginx实际配置:
nginx -T | grep -E "resolver|proxy_pass|valid",确认变量写法有没有生效。 - 看错误日志:
tail -f /var/log/nginx/error.log,区分解析失败和连接失败。 - 检查变量是否为空、端口是否拼错、location是否匹配。
- 确认是否走了resolver路径,resolver路径通常不依赖本机hosts,别只改hosts就以为能影响它。
如果静态proxy_pass写的是域名,DNS变了但没reload,nginx很可能仍用旧解析结果。 这是最常见的“缓存失效”误会。
业务缓存与域名缓存怎么配合?别让proxy_cache背锅
proxy_cache基础配置
域名缓存只负责找到后端,不负责减少后端压力,要缓存响应,另配proxy_cache:
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=api_cache:20m max_size=2g inactive=60m;
location /api/ {
proxy_cache api_cache;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
add_header X-Cache-Status $upstream_cache_status;
proxy_pass http://$backend_host:8080;
}
看X-Cache-Status是HIT、MISS还是BYPASS,比猜更可靠,行业共识认为,proxy_cache不能替代DNS解析缓存,两者混用会把排障方向带偏。
北京nginx域名缓存配置场景与成本
在北京机房做内网DNS解析、跨地域切流时,resolver常指向内网DNS或云解析服务地址,内网环境别照搬公网DNS,先确认安全组和出站规则是否放通,跨地域容灾场景下,valid短一些更稳,但要做好DNS服务器冗余。
不少团队会问nginx域名缓存配置服务价格,实际情况是:nginx开源版本身不收取这项功能的授权费,支出主要在DNS解析服务、服务器资源、带宽和运维人力,北京地域的机房带宽、云解析套餐差异较大,代维报价也因SLA不同而拉开差距,不能用一个固定数字概括,自己配置的成本低,但要有排障能力;买代维买的是响应速度和责任边界。
nginx域名缓存常见疑问Q&A
nginx resolver缓存会遵循DNS TTL吗?
resolver用valid控制缓存时间,不直接等同于权威DNS的TTL,valid设得比TTL长,nginx可能继续用旧结果;设得短,解析更频繁,生产环境建议显式写valid,并结合业务切流频率调整。
proxy_pass写域名后DNS变了为什么不切换?
静态域名写法通常在启动或reload时解析一次,之后不会按DNS TTL自动刷新,要动态感知,改用resolver加变量proxy_pass,或按运维流程reload,改完用nginx -T确认实际加载的配置。
nginx域名缓存配置服务价格高吗?
开源nginx不收取域名缓存功能授权费,成本集中在DNS解析服务、服务器资源和运维人力,北京地域的机房和云解析套餐价格差异较大,代维服务因SLA不同报价也不同,nginx开源版本身不收取该功能授权费,实际支出集中在DNS解析服务、服务器资源和运维人力。