NodeLocal DNSCache通过在各节点部署缓存代理，使Pod优先访问本地DNS缓存，降低CoreDNS负载、解析延迟及conntrack冲突风险。需满足Kubernetes≥1.14、网络插件兼容（非GR/Cilium Overlay/tke-direct-eni）、存在kube-dns或coredns服务等前提，支持控制台一键安装或YAML手动部署，启用后可通过metrics和nslookup验证缓存命中。
为解决CoreDNS负载过高或节点负载高导致的DNS解析失败、延迟升高问题，需在Kubernetes集群中部署NodeLocal DNSCache组件，使Pod优先访问本节点缓存，降低跨节点DNS请求与iptables conntrack冲突风险。
确认集群兼容性与前提条件
登录集群kubectl终端，执行kubectl version --short确认Kubernetes版本≥1.14；检查网络插件是否为VPC-CNI（非GR、Cilium Overlay或tke-direct-eni模式）；运行kubectl -n kube-system get svc kube-dns,coredns，确保存在名称为kube-dns或coredns且带k8s-app: kube-dns标签的服务。
【若使用Terway网络插件，必须为v1.0.10.301或更高版本】。低版本Terway在IPvlan模式下可能无法正确注入DNS配置，需先升级或调整Terway配置。
Windows节点不支持部署NodeLocal DNSCache，该组件仅适用于Linux工作节点。
安装NodeLocal DNSCache组件
方法一：通过容器服务控制台安装（推荐用于ACK/TKE/CCE等托管集群）
登录容器服务管理控制台→左侧导航栏选择「集群列表」→单击目标集群名称→左侧导航栏单击「组件管理」→切换至「网络」页签→找到「ACK NodeLocal DNSCache」卡片→单击「安装」→在弹出框中单击「确认」。
方法二：手动部署YAML清单（适用于自建集群或需定制参数场景）
执行wget https://raw.githubusercontent.com/kubernetes/kubernetes/master/cluster/addons/dns/nodelocaldns/nodelocaldns.yaml获取官方清单；若国内拉取registry.k8s.io镜像失败，用sed -i 's#registry\.k8s\.io/dns/k8s-dns-node-cache#docker.io/dyrnq/k8s-dns-node-cache#g' nodelocaldns.yaml替换镜像地址；检查并按需修改ConfigMap中__PILLAR__LOCAL__DNS__（默认169.254.20.10）和__PILLAR__DNS__DOMAIN__（默认cluster.local）变量；最后执行kubectl apply -f nodelocaldns.yaml。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
启用DNS缓存策略
第一步：确认组件已就绪
运行kubectl -n kube-system get daemonset node-local-dns，状态应为DESIREDCURRENTREADY全部一致；再执行kubectl -n kube-system get pods -l k8s-app=node-local-dns，所有Pod应处于Running状态且READY为1/1。
第二步：选择启用方式
① 全局启用（推荐）：仅适用于NodeLocal DNSCache v1.6.0+版本。进入控制台「组件管理」→点击已安装的NodeLocal DNSCache卡片右上角「配置」→勾选「是否默认启用DNSCache」→保存。此后除kube-system、default等系统保留命名空间外，所有新建Pod将自动注入169.254.20.10作为nameserver。
② 命名空间级启用：对特定命名空间打标，执行kubectl patch namespace <ns-name> -p '{"metadata":{"annotations":{"dns.alpha.kubernetes.io/node-local-dns":"enabled"}}}'。
③ Pod级手动启用（仅限调试）：在Pod spec中显式添加dnsConfig字段，指定nameservers: ["169.254.20.10"]。注意：【此方式会强制覆盖原有dnsConfig，虚拟节点上的Pod不支持】。
验证缓存生效
创建测试Pod：kubectl run dns-test --image=busybox:1.35 --rm -it --restart=Never -- nslookup kubernetes.default.svc.cluster.local。
观察返回的Server:行，若显示169.254.20.10而非CoreDNS的ClusterIP，则说明已命中本地缓存代理。
进一步验证缓存行为：连续执行两次相同查询，第二次响应时间应显著低于第一次；同时在节点上执行curl http://localhost:9253/metrics | grep 'node_local_dns_cache_hits_total'，确认指标值递增。
