容器与云原生 / 系统课时

认识 kube-proxy 的职责

认识 kube-proxy 的职责

本课厘清 kube-proxy 在 Service 链路中的职责:它读取 Service 与 EndpointSlice 状态,并在采用 kube-proxy 的节点上编程数据平面,让虚拟 Service 地址能够转发到后端 endpoint;同时说明替代 Service proxy、DNS 与不同 proxy mode 的边界。

学习目标

  • 区分 Service、EndpointSlice、kube-proxy 与 DNS 的职责
  • 理解 API 对象变化如何驱动节点侧转发状态更新
  • 能确认集群是否使用 kube-proxy,并按实际 proxy mode 选择排查对象

kube-proxy 位于哪一层

Service 定义稳定的访问入口,EndpointSlice 描述与 Service 关联的 endpoint 及其就绪等条件。对除 ExternalName 外需要虚拟 IP 转发的 Service,kube-proxy 会观察 Service 与 EndpointSlice,并按配置的 proxy mode 更新本节点的数据平面,使发往 ClusterIP、端口等 Service 地址的流量被转发到合适的 endpoint。

Service、EndpointSlice 与 kube-proxy 的职责关系

需要区分“Service 机制”和“kube-proxy 实现”。kube-proxy 是 Kubernetes 提供的默认 Service proxy,但不是所有集群的必经组件;部分 Pod 网络实现会提供自己的 Service proxy。若集群明确采用替代实现,没有 kube-proxy DaemonSet 并不等于故障,此时应转向实际负责 Service 转发的组件排查。

状态如何变成节点转发

Pod 创建、删除或就绪条件变化后,控制面会更新关联的 EndpointSlice;kube-proxy 再通过控制循环把 Service 与 EndpointSlice 的期望状态同步到节点数据平面。因此,“EndpointSlice 正确”和“节点转发状态已同步”是两层不同的验证。

下面假设当前命名空间存在 web Service,并先确认集群是否部署 kube-proxy,再核对 Service 地址与后端集合:

bash
kubectl get daemonset -n kube-system kube-proxy -o 'custom-columns=NAME:.metadata.name,DESIRED:.status.desiredNumberScheduled,READY:.status.numberReady'
kubectl get svc web -o 'custom-columns=NAME:.metadata.name,TYPE:.spec.type,CLUSTER-IP:.spec.clusterIP,PORT:.spec.ports[0].port'
kubectl get endpointslice -l kubernetes.io/service-name=web -o 'custom-columns=NAME:.metadata.name,ADDRESSES:.endpoints[*].addresses[*],READY:.endpoints[*].conditions.ready'

预期结果

text
NAME         DESIRED   READY
kube-proxy   <NODES>   <NODES>
NAME   TYPE        CLUSTER-IP     PORT
web    ClusterIP   <CLUSTER_IP>   80
NAME              ADDRESSES   READY
<ENDPOINTSLICE>   <POD_IP>    true

<NODES>、<CLUSTER_IP>、<ENDPOINTSLICE> 和 <POD_IP> 会随集群变化。若第一条命令返回 NotFound,先确认是否部署了替代 Service proxy;若 kube-proxy 存在,则继续确认其 Pod 覆盖预期节点、EndpointSlice 有可用地址,再检查对应节点数据平面。

不要把 kube-proxy 当成 DNS

DNS 负责把 web.default.svc.cluster.local 这类名称解析为 Service 地址;名称解析完成后,Service proxy 与节点数据平面才负责把流量送往 endpoint。名称无法解析时优先查集群 DNS;已经得到 ClusterIP 但连接失败时,再检查 Service、EndpointSlice、实际 Service proxy 与节点网络。

kube-proxy Pod 处于 Running 也不能证明 Service 一定可访问。Service 可能没有可用 endpoint,代理状态可能尚未正确同步,或节点到 endpoint 的网络路径仍然异常。

proxy mode 要结合版本判断

以 Kubernetes v1.37 官方文档为例,Linux kube-proxy 仍可配置 iptables、ipvs 和 nftables,未显式指定时当前默认仍是 iptables。nftables 模式从 v1.31 起可用,并在 v1.33 稳定;ipvs 则从 v1.35 起进入弃用状态,因此旧版本资料与当前版本的可选项、推荐方向和弃用状态并不完全相同。

排障时不要固定检查 iptables。只有确认集群使用 kube-proxy 且实际 mode 为 iptables 时,iptables 规则才是正确对象;若 mode 为 nftables、ipvs,或集群采用自定义 Service proxy,就应检查相应实现。实际定位顺序可以保持为“Service → EndpointSlice → 实际 Service proxy → 节点数据平面”,这样能快速区分没有后端、代理未同步与节点网络异常。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

认识 kube-proxy 的职责

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通