容器与云原生 / 系统课时
Headless Service
Headless Service
Headless Service 不提供虚拟 ClusterIP,而是把后端实例地址直接交给 DNS 返回。本节会用一个两副本 StatefulSet 验证服务名和单个 Pod 名的解析结果,并说明客户端拿到 Pod IP 后需要自己承担的连接与重试职责。
学习目标
- 能创建
clusterIP: None的 Headless Service,并理解它与普通 Service 的差异。 - 能验证服务名返回多个 Pod 地址,以及 StatefulSet Pod 的稳定 DNS 名。
- 能判断何时适合让客户端直接发现实例,而不是依赖 Service 虚拟 IP。
Headless Service 改变了什么
普通 Service 通常提供稳定的 ClusterIP,客户端先连接虚拟 IP,再由集群网络把流量转发到某个后端 Pod。Headless Service 把 spec.clusterIP 设为 None,不再提供这一层虚拟入口,DNS 会根据后端 EndpointSlice 返回实例地址。

这意味着 Headless Service 仍然依靠标签选择后端,但负载均衡位置从 Service 数据面移到了客户端。数据库驱动、服务注册 SDK 或需要直连指定副本的应用可以利用这个能力;只想获得一个稳定入口的普通无状态服务通常不需要它。
创建无头服务和 StatefulSet
下面的清单在 default 命名空间创建名为 db 的 Headless Service,以及两个 nginx Pod。StatefulSet 的 serviceName: db 会让 Pod 获得形如 demo-db-0.db、demo-db-1.db 的稳定子域名。
apiVersion: v1
kind: Service
metadata:
name: db
spec:
clusterIP: None
selector:
app: demo-db
ports:
- name: http
port: 80
targetPort: 80
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: demo-db
spec:
serviceName: db
replicas: 2
selector:
matchLabels:
app: demo-db
template:
metadata:
labels:
app: demo-db
spec:
containers:
- name: nginx
image: nginx:1.27-alpine
ports:
- name: http
containerPort: 80将内容保存为 headless.yaml。该配置生效后,Service 的 clusterIP 应为 None,StatefulSet 会按序创建 demo-db-0 和 demo-db-1。
验证服务名与单 Pod DNS
执行下面的命令。验证命令把 kubectl apply 和等待过程静默处理,只输出本节真正关心的结果;示例使用 Kubernetes 常见的 cluster.local 搜索域,但短名称解析不依赖你手工写出完整域名。
kubectl apply -f headless.yaml >/dev/null
kubectl rollout status statefulset/demo-db >/dev/null
kubectl get service db -o jsonpath='clusterIP={.spec.clusterIP}{"\n"}'
kubectl run dns-check-service --image=busybox:1.36 --restart=Never --rm -i -- nslookup db >/dev/null 2>&1 && echo "service DNS resolved"
kubectl run dns-check-pod --image=busybox:1.36 --restart=Never --rm -i -- nslookup demo-db-0.db >/dev/null 2>&1 && echo "pod DNS resolved"预期输出:
clusterIP=None
service DNS resolved
pod DNS resolved如果还想看到实际地址,可执行 kubectl get pod -l app=demo-db -o wide。其中 Pod IP 会随重建发生变化,因此应把 DNS 名作为稳定发现入口,而不要把某次观察到的 IP 写进应用配置。
处理未就绪实例与客户端职责
默认情况下,DNS 通常只发布满足就绪条件的后端。某些需要在启动阶段互相发现的有状态系统,可以在 Service 中设置 publishNotReadyAddresses: true,让尚未 Ready 的实例也进入发现结果;这样做前必须确认应用能容忍连接失败和初始化中的节点。
Headless Service 不提供 Service 级虚拟 IP,也不替客户端实现连接选择、故障转移或重试。使用它时,应明确客户端如何在多个地址之间选择目标、如何剔除失败实例,以及是否需要连接池感知拓扑。对于 StatefulSet,稳定的是 Pod 名与服务子域组合出的 DNS 身份,而不是某个固定 Pod IP。