配置kubectl从Mac连接Windows本地Kubernetes集群遇连接拒绝问题

1. 先确认基础网络连通性 #

• 在Mac终端执行 ping 192.168.1.XXX，确保两台设备在同一局域网且能互相访问。如果ping不通，先排查子网、WiFi连接等基础网络问题。
• 测试端口可达性：执行 nc -zv 192.168.1.XXX 6443，如果显示连接失败，说明6443端口未对外开放或K8s API Server未监听该IP。

2. 检查Windows上K8s API Server的监听配置 #

• 如果是Docker Desktop部署的K8s：
  1. 打开Docker Desktop设置，进入Kubernetes选项卡。
  2. 确认API Server的启动参数中包含 --bind-address=0.0.0.0（监听所有IP），而非仅127.0.0.1（仅本地访问）。若没有，需修改配置添加该参数（开发环境临时使用，生产环境需配合证书配置）。
• 其他部署方式的K8s：查看API Server的启动配置，确保监听地址包含局域网IP192.168.1.XXX或0.0.0.0。

3. 配置Windows防火墙入站规则 #

• Windows Defender防火墙默认会拦截外部对6443端口的访问，需手动添加规则：
  1. 打开「Windows Defender防火墙」>「高级设置」>「入站规则」>「新建规则」。
  2. 选择「端口」，点击下一步；输入6443，选择TCP，点击下一步。
  3. 选择「允许连接」，点击下一步；勾选「专用」「域」网络（根据你的网络环境），点击下一步。
  4. 命名规则（如「K8s API Server 6443端口」），完成配置。

4. 确保kubeconfig配置正确 #

• 不要手动复制证书数据，直接从Windows设备导出完整的kubeconfig文件：
  1. 在Windows上找到用户目录下的C:\Users\<你的用户名>\.kube\config文件。
  2. 将该文件复制到Mac的~/.kube/目录下，或者合并到现有配置：

     kubectl config merge --kubeconfig=/path/to/windows-config --kubeconfig=~/.kube/config > ~/.kube/new-config
     mv ~/.kube/new-config ~/.kube/config
     

  3. 切换上下文：kubectl config use-context windows-docker-desktop

5. 排查细节问题 #

• 如果仍报错，执行kubectl get nodes -v=6查看详细日志，日志会明确显示是证书验证失败还是网络连接超时，针对性处理。

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