WSL2(Ubuntu)无法连接Windows上的Kubernetes集群求助

问题根源 #

Windows生成的kubeconfig文件里，证书路径是Windows本地格式（例如C:\Users\UserName\.kube\client-certificate.crt），WSL2无法直接识别该路径；同时初始状态下WSL2的kubectl默认尝试连接localhost:8080，和Windows集群的实际端口不匹配。

修复步骤 #

1. 配置KUBECONFIG环境变量 #

在WSL2的~/.bashrc中添加以下内容（替换UserName为你的Windows用户名）：

export KUBECONFIG=/mnt/c/Users/UserName/.kube/config

执行命令让配置立即生效：

source ~/.bashrc

2. 转换kubeconfig中的证书路径 #

手动编辑/mnt/c/Users/UserName/.kube/config文件，将所有Windows格式的证书路径（如C:\Users\UserName\.kube\client-key.pem）替换为WSL挂载路径（如/mnt/c/Users/UserName/.kube/client-key.pem）。

也可以用sed命令批量替换：

sed -i 's/C:\\\/mnt\\\/c\\/g' $KUBECONFIG
sed -i 's/\\/\//g' $KUBECONFIG

3. 验证连接状态 #

执行以下命令测试集群连通性：

kubectl version
kubectl cluster-info

若仍有证书验证警告，可临时用--insecure-skip-tls-verify参数跳过验证，确认网络连通：

kubectl cluster-info --insecure-skip-tls-verify

4. 可选：简化配置的软链接方案 #

在WSL2用户目录下创建.kube文件夹并软链接Windows的config文件，避免重复指定路径：

mkdir -p ~/.kube
ln -s /mnt/c/Users/UserName/.kube/config ~/.kube/config

完成后同样需要修改软链接后的config文件中的证书路径为WSL格式。

额外建议 #

• 确保Docker Desktop已开启WSL集成：打开Docker Desktop设置，进入Resources > WSL Integration，勾选对应的Ubuntu发行版。
• 若长期使用，可直接在WSL2中启动Minikube，避免跨系统路径/网络问题：

minikube start --driver=docker

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