《Kubernetes 分布式系统原理深入解析》4.1 CoreDNS 与 Service DNS 解析

集群内服务发现的首选是 DNS:Service 拥有 `<name>.<namespace>.svc.cluster.local` 的稳定域名,CoreDNS 从 apiserver 监听 Service 与端点并把它们变成 DNS 记录。本节讲记录形态、CoreDNS 的生成路径、Headless Service 的 A 记录差异,lab 用 dns.go 的 FQDN 与 Resolver 验证记录拼接与精确解析。

4.1 CoreDNS 与 Service DNS 解析

前面两章都在讲「流量到 Service 之后怎么转发」,这一章把视角往后拉一步:应用是怎么知道 Service 在哪里的。分布式系统里的服务发现是一个老问题——客户端需要一个「按名字找地址」的机制,K8s 的答案是 DNS。集群里跑着一个 CoreDNS,它把 Service 的名字解析成 ClusterIP,应用通过标准的 DNS 查询就能找到彼此。

为什么服务发现用 DNS 而不是直接连 apiserver?因为 DNS 是所有编程语言与操作系统都原生支持的协议:不引入 SDK、不依赖特定客户端库、getaddrinfo 到处都有。K8s 用 DNS 把「服务发现」这件分布式系统的常备功能,做成了应用完全无感知的透明能力。

Service DNS 记录的形态

K8s 给每个 Service 分配一个稳定域名,规则非常固定:

<service-name>.<namespace>.svc.<cluster-domain>
组成部分值例子
服务名spec.nameweb
命名空间metadata.namespaceprod
固定段svcsvc
集群域clusterDomain(默认 cluster.local)cluster.local

于是 prod 命名空间里名为 web 的 Service 完整 FQDN 是 web.prod.svc.cluster.local。lab 里 ServiceDNS.FQDN("cluster.local") 就是这个拼接逻辑的一行实现。域名只跟 Service 的名字与命名空间绑定,与 Pod IP、ClusterIP 具体值无关——IP 可以换,域名永远不变,这是「稳定服务发现」的关键。

同命名空间内可以用短名 web 解析,跨命名空间必须写全名 web.prod.svc.cluster.local。短名之所以能解析,靠的是第 4.2 节的 search 域自动拼接——DNS 记录本身只有全限定名这一份。

CoreDNS 从哪拿到记录:apiserver → 权威数据

CoreDNS 不是一个「静态配置」的 DNS 服务器——它不知道也不配置每个 Service 的名字,而是靠 kubernetes 插件从 apiserver 实时读取:

步骤机制说明
订阅list-watch Service 与 EndpointSlice复用卷二第 3 章的 watch 原语
建记录每个 Service 生成 A/AAAA 记录ClusterIP → A 记录
建反向Service 的反向映射PTR 记录(较少用)
更新Service/端点变化触发记录增删靠 watch 事件增量维护

CoreDNS 对 apiserver 的角色,与 kube-scheduler 对 apiserver 的角色一模一样(卷三第 1.2 节)——一个靠 watch 维护本地视图的消费者。它从 apiserver 拉取 Service 与端点,在自己的内存里构建 name → IP 的权威记录表,再应答集群内 Pod 发来的 DNS 查询。lab 里 Resolver.Add 与 Resolver.Resolve 就是这个「记录表 + 查询」的最小模型。

一条典型的解析链路是这样的:

  1. Pod 里的应用调用 getaddrinfo("web.prod.svc.cluster.local")。
  2. 请求经 kubelet 注入的 resolv.conf 发给 CoreDNS(10.96.0.10,kube-system 里的 Service)。
  3. CoreDNS 查自己的记录表,命中 web.prod.svc.cluster.local → 10.96.0.1。
  4. 应答返回,应用拿 ClusterIP 发起连接,kube-proxy 再把它转给后端 Pod。

两种 Service:ClusterIP 与 Headless 的 DNS 差异

不是所有 Service 都解析成 ClusterIP。Headless Service(spec.clusterIP: None)没有虚拟 IP,它的 DNS 记录直接指向后端 Pod 的真实 IP:

维度普通 ServiceHeadless Service
A 记录指向ClusterIP(虚拟 IP)每个就绪 Pod 的 IP
查询结果一个 IP多个 IP(全部端点)
谁做负载均衡kube-proxy(转发层)DNS 返回多 IP,客户端/轮询自行选择
典型用途常规访问入口StatefulSet 固定标识、Pod 级寻址

Headless 下应用拿到的是一组 Pod IP,由客户端自己决定连哪个——这放弃了 kube-proxy 的转发均衡,换来两个能力:一是可以寻址到具体某一个 Pod(StatefulSet 的 pod-0.web.ns.svc 这类稳定主机名);二是把均衡下沉到客户端(对某些自研客户端反而更可控)。此外 Headless 还会生成 _<port>._<proto>.<name>.ns.svc 的 SRV 记录,供应用按端口发现。

为什么「只解析 ClusterIP」就够了

普通 Service 的 DNS 只返回 ClusterIP,这是刻意的简化——把均衡放在转发层,DNS 层就只需回答「虚拟 IP 是多少」:

  • DNS 层是「名字 → 一个地址」的简单映射,记录量小、缓存友好、TTL 好控制。
  • 真正的后端选择发生在 kube-proxy 的转发规则里(第 3 章),那里才看得到端点实时状态。
  • 若让 DNS 返回所有 Pod IP,DNS 缓存会让客户端在端点变化后长时间持有旧列表(第 4.3 节讲滞后),均衡性反而变差。

所以 DNS 在 K8s 里的定位不是「全能服务发现」,而是「稳定的名字 → 虚拟 IP」的解析器。服务发现的复杂部分(端点、健康、均衡)全部下沉到数据面,DNS 保持简单,正是它能作为通用协议被所有语言无感使用的原因。

CoreDNS 的部署形态与高可用

CoreDNS 在集群里通常以 Deployment 多副本运行,前端挂一个 Service,Pod 的 resolv.conf 指向它的 ClusterIP:

组件角色细节
DeploymentCoreDNS 副本通常 2 副本,滚动更新
Service稳定入口kube-system 里的 kube-dns,ClusterIP 固定
kubelet 注入写入 resolv.conf--cluster-dns 参数指定该 IP

高可用的意义:DNS 是服务发现链路的咽喉——解析失败等于所有服务互相找不到。多副本保证单点故障不瘫痪解析,滚动更新保证升级不中断。注意 CoreDNS 本身也依赖 apiserver(记录来源),所以「CoreDNS 挂了 → 服务发现全断 → 重建还要等 apiserver」的循环是真实的——这也是把 CoreDNS 副本数设为 2 以上、并为它配置就绪探针的原因。

集群域:cluster.local 不是写死的

默认集群域是 cluster.local,但它可以在部署时改:

位置配置项影响
kubelet--cluster-domain注入 resolv.conf 的 search 域
CoreDNSCorefile 里 kubernetes <domain>权威记录的域后缀
Service无感知DNS 记录自动跟随集群域

集群域不一致是「Pod 内解析失败但配置看起来对」的隐蔽来源:kubelet 与 CoreDNS 必须用同一个域。改集群域需要两端同步,否则 search 域拼接出来的名字 CoreDNS 不认。集群域是一个两端要一致的全局配置——排障时若 search 域与 CoreDNS 记录对不上,先怀疑两端的域配置不一致,而不是记录本身。

SRV 与 PTR:记录家族的另外两块

除了 A/AAAA,K8s DNS 还生成 SRV 与 PTR 记录,它们服务于不同场景:

记录类型内容用途
A / AAAA名字 → IP常规解析(本节核心)
SRV<port>.<proto>.<name>.<ns>.svc → 目标与端口按端口发现服务
PTRIP → 名字反向解析、日志审计

SRV 记录让客户端可以「先问有哪些端口、再选端口连」;PTR 用于把 IP 反查成服务名。对大多数应用 A 记录就够,但自研客户端要实现服务发现协议时,SRV 是标准工具。记录家族的分工:A 管「怎么连」,SRV 管「连哪个端口」,PTR 管「这是谁」。

排查 DNS 解析的命令

解析问题排查要从集群内 Pod 里做,比从宿主机做更贴近真实路径:

# 1. 看 resolv.conf 是否指向集群 DNS
kubectl exec -it <pod> -- cat /etc/resolv.conf
# 2. 直接解析一个 Service 名
kubectl exec -it <pod> -- nslookup web.prod.svc.cluster.local
# 3. 检查 CoreDNS Pod 状态与日志
kubectl get pods -n kube-system -l k8s-app=kube-dns
kubectl logs -n kube-system -l k8s-app=kube-dns --tail=20
# 4. 确认 Service 确实存在且已有端点
kubectl get svc web -n prod
kubectl get endpointslices web -n prod

四步把「解析失败」归因到三类:resolv.conf 没指向集群 DNS(kubelet 注入问题)、CoreDNS 没生成记录(apiserver 同步问题)、Service 本身没有端点(后端问题)。DNS 是最底层的服务发现,任何上层异常都可能表现为解析失败——先确认服务对象存在,再查 DNS 配置。

三个常见误解

  • 「DNS 记录是静态配置的,Service 变了要手动改」——错误。CoreDNS 通过 list-watch 从 apiserver 实时读取 Service 与端点,Service 增删自动反映到 DNS 记录,无需人工干预。
  • 「Service 的 DNS 永远解析到后端 Pod」——错误。普通 Service 解析到 ClusterIP,均衡在转发层;只有 Headless Service 才直接解析到 Pod IP 列表。
  • 「只要 Pod 在,DNS 就一定返回它」——错误。DNS 记录基于就绪端点;未就绪 Pod 不进记录(Headless 时),记录更新滞后于端点变化(第 4.3 节)。

DNS 什么时候不合适:三条例外

DNS 是通用服务发现,但不是万能:

场景DNS 为什么不合适替代
秒级精确状态TTL 滞后(第 4.3 节)直连端点 API
请求属性路由DNS 只认名字不认请求服务网格 / 自研客户端
海量高频新连接每次解析有成本连接池 + 长连接

DNS 的定位是「名字 → 虚拟 IP」的稳定映射,它不适合做实时端点状态的查询。要实时、要按请求路由,就走端点 API 或网格——DNS 做它擅长的稳定解析,其他交给专门机制。这条边界与第 4.3 节的最终一致是同一枚硬币的两面。

服务发现选型的判断清单

  1. 客户端生态多样吗(多语言、多系统)?——是则 DNS 是唯一通用协议。
  2. 需要按端口发现吗?——需要则 SRV 记录,纯连接则 A 记录够。
  3. 能容忍 TTL 级滞后吗?——不能则考虑直连 apiserver 或服务网格。
  4. 要寻址具体 Pod 吗?——要则 Headless + 稳定主机名。

四问决定发现机制的形态:默认 DNS,特殊需求换机制。绝大多数集群应用在第 1 问就是「是」,DNS 已经是正确答案;真正需要偏离的,只有第 3、4 问里那些对实时性与精确寻址有硬要求的服务。

一句话总结本节

集群内服务发现首选 DNS,CoreDNS 用「watch apiserver + 内存记录表」把 Service 变成标准域名:

  • 记录形态:<name>.<namespace>.svc.cluster.local,名字与 IP 解耦,IP 换了域名不变。
  • 生成路径:CoreDNS 从 apiserver 订阅 Service 与 EndpointSlice,增量维护记录表,应答集群内查询。
  • 两类差异:普通 Service 解析到 ClusterIP(均衡在转发层);Headless 解析到 Pod IP 列表(均衡在客户端)。

DNS 的简单性是有意为之——名字解析只回答「虚拟 IP 是多少」,端点选择全部下沉到 kube-proxy。下一节看 DNS 层的另一半:Pod 的 resolv.conf 里那些 ndots、search 域配置,如何决定一次解析要发几次查询、以及外部域名为什么可能变慢。

本节 lab

本节用 dns 包的 ServiceDNS.FQDN 与 Resolver 验证记录形态与精确解析:

cd private/labs/k8s-net-lab
go test ./dns -run TestServiceFQDN -v
go test ./dns -run TestResolverExact -v

TestServiceFQDN 断言 web.prod Service 拼接出 web.prod.svc.cluster.local——记录形态成立;TestResolverExact 断言已注册的 FQDN 精确解析到 10.96.0.1、未注册的返回空——「记录表 + 查询」的最小模型成立。两个测试合计 3 个断言,覆盖本节最核心的两点:域名是机械拼出来的,查询是表查找。lab 用 map[FQDN]IP 模拟 CoreDNS 的内存记录表,省略了 list-watch 订阅那一段(卷二的 watch 原语),这正是 CoreDNS 在真实集群里维护这份表的来源。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图