Mac本地部署Minikube后服务访问与端口转发连接被拒问题

常见问题根源 #

• 驱动兼容性冲突：Mac设备上Minikube默认使用Docker Desktop作为驱动时，若Docker Desktop同时启用了内置Kubernetes集群，会和Minikube的网络栈抢占端口映射规则，导致外部访问链路中断
• 集群内部链路异常：Service与Pod的标签选择器不匹配、Pod实际监听端口与配置的服务端口不一致、Endpoints为空都会导致服务访问失败
• 本地网络拦截：Mac本地防火墙、VPN、端口占用会阻断端口转发或服务暴露的流量链路

分步解决方法 #

1. 清理冲突的基础环境 #

• 执行minikube status确认所有集群组件（kubelet、apiserver、kube-proxy）处于Running状态，若存在异常组件，执行minikube delete && minikube start重建干净集群
• 打开Docker Desktop设置页面，进入Kubernetes选项卡，确认「Enable Kubernetes」复选框未勾选，若已勾选取消后重启Docker Desktop，再重新启动Minikube集群

2. 校验集群内部服务链路有效性 #

• 执行kubectl get pods -o wide确认hello-minikube的Pod处于Running状态，无异常重启记录
• 执行kubectl get endpoints hello-minikube确认返回结果中存在对应的IP+端口条目，若Endpoints为空，检查Deployment的selector和Service的selector字段是否完全匹配
• 执行minikube ssh登录Minikube节点内部，执行curl <Endpoints对应的IP:端口>，如果能正常返回hello-minikube的响应内容，证明集群内部服务运行正常，问题出在本地到Minikube的外部访问链路上

3. 修复外部访问链路 #

优先使用Minikube官方隧道方案暴露服务，避免端口转发的兼容性问题：

• 新开终端窗口执行minikube tunnel，保持窗口常驻运行，该命令会自动为LoadBalancer类型的Service分配可本地直接访问的IP
• 执行kubectl get service hello-minikube，获取EXTERNAL-IP列的地址，直接在浏览器访问该IP加服务端口即可正常加载页面

若需要使用端口转发方案，先确认端口匹配规则：

• 执行kubectl exec <hello-minikube的Pod名称> -- netstat -tunlp确认Pod内部服务实际监听端口，若监听端口不是8080，修改端口转发命令的目标端口为实际监听端口后再重试

4. 校验本地网络规则 #

• 执行lsof -i :7080确认本地7080端口没有被其他进程占用，若存在占用kill对应进程后重新执行端口转发命令
• 临时关闭本地VPN、防火墙后再次尝试访问，确认不是安全策略拦截了访问流量

内容的提问来源于stack exchange，提问作者benz