服务器与大带宽专家 · 持牌IDC/CDN/ISP服务商
简米科技官网JIANMI TECH
资讯 2026-11-18 简米科技 4,177 字 10 分钟阅读

Nginx域名缓存怎么配置?Nginx域名缓存不生效怎么办

导读nginx域名缓存的核心结论:nginx不会自动把proxy_pass里写死的域名解析结果按DNS TTL持续刷新;要让域名解析结果被缓存且可控更新,主流做法是resolver配合变量proxy_pass,并用valid控制缓存时长,HTTP响应缓存交给proxy_cache,nginx域名缓存怎么配置?先分清……

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”,按下面顺序查:

  1. 用resolver里的DNS服务器直接查:dig @223.5.5.5 api.example.com +short,确认权威侧是否已生效。
  2. 看nginx实际配置:nginx -T | grep -E "resolver|proxy_pass|valid",确认变量写法有没有生效。
  3. 看错误日志:tail -f /var/log/nginx/error.log,区分解析失败和连接失败。
  4. 检查变量是否为空、端口是否拼错、location是否匹配。
  5. 确认是否走了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解析服务、服务器资源和运维人力。

分享本文
本文为 简米科技官网 原创,已由运维技术专家审核。转载请注明来源:原文链接
售前咨询 服务热线 售后 邮箱