MacOS环境下Kind集群中Metal LB不符合文档预期无法正常工作

问题描述 #

我已按照Kind官方文档完成macOS上LoadBalancer的所有配置步骤，但无法通过外部负载均衡器访问服务。执行以下命令时出现连接超时：

LB_IP=$(kubectl get svc/foo-service -o=jsonpath='{.status.loadBalancer.ingress[0].ip}')
curl ${LB_IP}:5678 -v

返回错误：

*   Trying 172.19.255.201:5678...
* connect to 172.19.255.201 port 5678 failed: Operation timed out
* Failed to connect to 172.19.255.201 port 5678 after 75006 ms: Couldn't connect to server
* Closing connection
curl: (28) Failed to connect to 172.19.255.201 port 5678 after 75006 ms: Couldn't connect to server

排查与解决步骤 #

• 检查Metallb组件运行状态
  确认Metallb控制器和Speaker Pod是否正常工作：

  kubectl get pods -n metallb-system
  

  若有Pod异常，查看日志定位问题：

  kubectl logs -n metallb-system <异常Pod名称>
  

• 验证IP池配置匹配性
  先查看Docker的Kind集群子网：

  docker network inspect kind | grep Subnet
  

  对比Metallb的IP池配置（如config.yaml中的addresses字段），确保LoadBalancer分配的IP（如172.19.255.201）在该子网范围内，且未被其他设备占用。

• 确认服务与后端Pod关联正常
  检查服务的端点绑定情况：

  kubectl describe svc foo-service
  

  查看Endpoints字段，确保有正常的Pod IP列表；同时确认后端Pod处于运行状态：

  kubectl get pods
  

• 添加macOS路由规则
  macOS默认无法直接访问Kind容器的LoadBalancer子网，需手动添加路由：
  先获取Kind控制节点的IP：

  docker inspect kind-control-plane | grep "IPAddress"
  

  然后添加路由（替换<节点IP>和<LB子网>为实际值，例如172.19.0.2和172.19.255.0/24）：

  sudo route -n add -net <LB子网> <节点IP>
  

• 检查节点端口转发规则
  确认Kind节点已配置正确的流量转发规则：

  docker exec kind-control-plane iptables -t nat -L KUBE-SVC-* | grep foo-service
  

  需确保存在对应5678端口的转发条目。

• 排查防火墙拦截
  暂时关闭macOS系统防火墙或第三方安全软件（如Little Snitch），测试是否能正常连接，避免流量被拦截。

内容的提问来源于stack exchange，提问作者Pradeep Padmanaban C