首页/云/Kubernetes 速查/kube-proxy 与转发规则排查
本包目录(307 条)
kubectl 基础56 条工作负载36 条
网络与服务55 条
配置与存储54 条调度与资源52 条集群运维与排障54 条

kube-proxy 与转发规则排查

Service 不通按层查:Endpoints 是否有就绪后端 → kube-proxy 组件是否正常 → 节点上的转发规则与防火墙是否放行。

Kubernetes 速查云更新于 2026-10-12

分层检查

分层检查
kubectl -n kube-system get pod -l k8s-app=kube-proxy -o wide
kubectl -n kube-system logs -l k8s-app=kube-proxy --tail=50
kubectl get endpointslices -l kubernetes.io/service-name=web-svc
# 节点侧:iptables 模式
iptables-save | grep -i <service-clusterip>
# 节点侧:IPVS 模式
ipvsadm -Ln | head -20
Endpoints 为空时任何转发规则都不会命中:先解决选择器不匹配或后端未就绪。

易错点

  • 在控制面节点查规则:kube-proxy 规则按节点各自维护,要落到 Pod 所在节点
  • IPVS 模式内核模块缺失:日志会提示 ip_vs 相关模块加载失败

数据来源与参考

  • Kubernetes 官方文档 · 虚拟 IP 与服务代理
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌