首页/网络/常用端口速查/10256 kube-proxy 健康检查口
10000-19999 注册端口49 条

10256 kube-proxy 健康检查口

kube-proxy 的 healthz 端口:默认 10256 提供 /healthz 与 /metrics 的健康端点,节点网络异常的探针口。

常用端口速查网络更新于 2026-10-13

10256 是什么

10256 是 kube-proxy 的 healthz 端口,提供 /healthz 与 /metrics 端点,用于判断代理进程本身是否健康,也常被节点监控或探针采集。它与 10249 的区别在定位:10249 更偏指标,10256 更偏健康与存活。节点出现「Ready 但服务不通」时,按 kubelet(10250 与 10248)、kube-proxy(10256)、iptables 或 ipvs 规则这个顺序排查,通常能较快收敛。

基本信息

服务kube-proxy healthz(默认 10256)
协议TCP/HTTP
用途代理健康检查与指标
配套端口10249(metrics)、10250(kubelet)
部署形态DaemonSet(kube-system)
安全等级仅节点或监控

典型使用场景

  • 节点网络异常排障:确认代理进程健康
  • 探针配置:为 DaemonSet 配置存活与就绪探针
  • 监控采集:纳入节点指标体系
  • 安全基线:核对健康端口的暴露范围
  • 升级验证:代理版本升级后逐节点确认状态
  • 集群巡检:批量检查各节点代理运行情况

节点网络排障顺序

顺序检查点命令
1节点状态kubectl get nodes
2kubelet 与运行时检查节点日志与运行时状态
3kube-proxy 健康curl -s 127.0.0.1:10256/healthz
4转发规则iptables-save 或 ipvsadm -Ln 核对

节点侧核对

节点侧核对
curl -s http://127.0.0.1:10256/healthz | head -c 100             # 代理健康
ss -lntp | grep -E '10249|10256'                              # 端口核对
kubectl -n kube-system get pod -l k8s-app=kube-proxy -o wide   # 代理 Pod 分布
ipvsadm -Ln | head -20                                        # ipvs 模式下的转发规则
kube-proxy 以 DaemonSet 运行,每个节点一份:节点级问题优先在对应节点上执行命令,用 kubectl logs 看错节点是常见的时间浪费。
健康口返回正常并不代表转发一定可用:规则同步失败时进程本身仍可能健康,因此要把指标与规则核对结合起来看。
节点混用不同转发模式时症状更具迷惑性:表现为部分节点正常、部分异常,先确认模式再逐层排查。
探针参数不要设得过激:大流量节点启动时探针频繁失败会导致重建,反而延长服务恢复时间。
节点级排查要落到具体主机上:把健康口与规则核对结合起来看,同一条命令在不同节点执行结果可能完全不同。
记录每次节点异常时的代理版本与模式:同类故障重复出现时,这些信息能显著缩短定位时间。

易错点

  • 健康口对外网可达:集群组件版本与健康状态被外部测绘
  • 只看 Pod 状态判断代理正常:Pod 运行中但规则同步失败的情况真实存在
  • 节点混用不同模式:症状是部分节点转发正常、部分异常,定位难度陡增
  • 探针阈值照搬默认值:高负载节点反复重启代理,集群网络出现周期性抖动
  • 排查顺序从业务侧开始:绕过节点与代理层,往往会在应用日志里绕很久
  • 节点异常不记录版本与模式:同类故障再次出现时又要从头排查

数据来源与参考

  • Kubernetes 官方文档(kube-proxy healthz 10256)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌