OrbStack Kubernetes Ingress 故障排查与解决方案

问题背景

在OrbStack升级至1.6.x版本后，许多用户报告了Kubernetes Ingress功能失效的问题。具体表现为Ingress控制器无法正常启动，导致集群内的服务无法通过Ingress规则对外暴露。这个问题主要影响使用nginx ingress controller的用户，但其他Ingress控制器如Envoy也可能遇到类似情况。

故障现象

用户观察到的主要症状包括：

1. Ingress控制器Pod处于CrashLoopBackOff状态
2. 控制器日志显示IPv6转发未启用错误
3. 80/443端口监听失效
4. Ingress资源状态持续显示"Scheduled for sync"

根本原因分析

经过深入排查，发现该问题源于K3s（OrbStack内置的Kubernetes发行版）与IPv6配置的交互问题：

1. IPv6转发未启用：K3s的负载均衡器组件(klipper-lb)需要IPv6转发功能，但默认未启用
2. externalTrafficPolicy设置：当Service的externalTrafficPolicy设置为Local时，K3s会尝试使用节点的所有IP地址（包括IPv6）
3. DaemonSet配置：负载均衡器DaemonSet缺少必要的系统配置参数

解决方案

临时解决方案

对于需要立即解决问题的用户，可以采用以下两种方法：

1. 修改Service配置： 将Ingress控制器的Service资源中的externalTrafficPolicy从Local改为Cluster：

   spec:
     externalTrafficPolicy: Cluster
   

2. 修改DaemonSet配置： 在负载均衡器DaemonSet中添加IPv6转发参数：

   spec:
     template:
       spec:
         containers:
         - env:
           - name: net.ipv6.conf.all.forwarding
             value: '1'
   

永久解决方案

OrbStack团队已在1.9.4版本中修复了此问题。建议用户升级到最新版本以获得完整的修复：

1. 升级OrbStack至v1.9.4或更高版本
2. 重新部署Ingress控制器相关资源

技术细节

问题发生机制

当externalTrafficPolicy设置为Local时，K3s会尝试使用节点的所有IP地址（包括IPv6地址）来配置负载均衡规则。由于OrbStack环境中默认未启用IPv6转发，导致负载均衡器初始化失败。

错误日志分析

典型的错误日志显示：

lb-tcp-80 + cat /proc/sys/net/ipv6/conf/all/forwarding
lb-tcp-80 + '[' 0 '==' 1 ]
lb-tcp-80 + exit 1

这表明负载均衡器检查IPv6转发状态失败，导致容器退出。

最佳实践建议

1. 版本管理：始终保持OrbStack为最新稳定版本
2. Ingress控制器选择：考虑使用与K3s兼容性更好的Ingress控制器
3. 网络配置检查：部署前验证节点的IPv4/IPv6网络配置
4. 监控设置：配置适当的监控以捕获Ingress控制器的异常状态

总结

OrbStack 1.6.x版本引入的Kubernetes Ingress问题主要源于IPv6配置与K3s负载均衡器的交互问题。通过理解问题的根本原因，用户可以采取适当的临时解决方案，或升级到已修复该问题的版本。对于生产环境，建议在升级前充分测试，并考虑实施监控方案以快速发现类似问题。