MetalLB 负载均衡器 IP 分配问题排查指南

问题背景

MetalLB 是一个用于裸机 Kubernetes 集群的负载均衡器实现，它能够为 LoadBalancer 类型的服务分配外部 IP 地址。在实际部署中，用户可能会遇到 MetalLB 成功分配了 IP 地址但无法访问的问题。

典型症状

1. MetalLB 控制器成功分配了 IP 地址池中的 IP
2. 服务状态显示 IP 已分配
3. 但通过 ping 或 arping 测试无法访问该 IP
4. 网络接口列表中没有显示分配的 IP 地址

根本原因分析

经过深入排查，发现这类问题通常与 Kubernetes 节点的标签配置有关。当节点被打上 node.kubernetes.io/exclude-from-external-load-balancers 标签时，MetalLB 的 Speaker 组件会忽略该节点，不会在其上宣告服务 IP 地址。

解决方案

临时解决方案

通过移除问题节点的排除标签来恢复功能：

kubectl label node <节点名称> node.kubernetes.io/exclude-from-external-load-balancers-

永久解决方案

等待 MetalLB 新版本发布，该问题已在代码库中修复，新版本将正确处理这类标签情况。

技术细节

MetalLB 的 Speaker 组件负责在节点上宣告服务 IP 地址。当节点被标记为排除外部负载均衡时：

1. Speaker 会跳过该节点的 IP 宣告
2. 不会在节点网络接口上配置服务 IP
3. 不会响应 ARP 请求
4. 导致服务 IP 无法访问

验证方法

1. 检查服务事件：

kubectl describe svc <服务名称>

2. 检查 Speaker 日志：

kubectl logs -n metallb-system <speaker-pod-name>

3. 使用 arping 测试连通性：

sudo arping -I <接口名称> <服务IP>

最佳实践

1. 部署前检查节点标签配置
2. 避免使用排除外部负载均衡的标签
3. 定期检查 MetalLB 组件日志
4. 确保网络接口配置正确

总结

MetalLB 的 IP 分配问题通常与节点标签配置相关。通过正确配置节点标签或升级到修复版本，可以解决这类访问性问题。对于生产环境，建议在部署前充分测试网络配置，确保 MetalLB 能够正常工作。

对于使用 Cilium 等 CNI 插件的环境，还需要特别注意网络策略和路由配置，确保 MetalLB 的流量能够正常转发。