Windows版Docker Desktop启用Kubernetes无法连接服务器问题

错误核心原因：解析kubernetes.docker.internal域名时，请求被转发到了代理环境的DNS服务器160.50.250.20，该地址网络不可达，本质是本地域名映射缺失、no_proxy规则未全链路生效导致的流量走了代理通道。

按以下顺序逐一排查：

1. 检查本地hosts域名映射 #

Docker Desktop启动时会自动向系统hosts文件写入内置域名的映射规则，规则缺失会直接导致域名走公网/代理DNS解析：

• 以管理员权限打开记事本，打开文件C:\Windows\System32\drivers\etc\hosts
• 查找是否存在如下条目：

127.0.0.1 kubernetes.docker.internal
127.0.0.1 docker.internal

• 若不存在，手动追加上述两行后保存，执行ipconfig /flushdns刷新本地DNS缓存，重新打开终端测试kubectl命令。

2. 全链路校验no_proxy配置 #

仅配置系统环境变量的no_proxy无法覆盖所有链路，三个位置必须同步配置：

• 系统环境变量：同时在用户变量和系统变量中，为NO_PROXY和no_proxy（大小写两个变量都要加，部分工具仅识别小写变量）追加值.internal,localhost,127.0.0.1。配置完成后必须完全关闭当前终端/PowerShell/CMD，新启动的终端才会加载新的环境变量。
• Docker Desktop内置代理配置：打开Docker Desktop设置 -> Resources -> Proxies，在Bypass proxy settings for these hosts & domains输入框中同样追加.internal,localhost,127.0.0.1，点击Apply & Restart重启Docker。Docker后台服务不会自动继承系统的no_proxy规则，必须单独配置。
• 终端临时代理清理：如果当前终端手动设置过临时代理变量，执行以下命令清空当前会话的代理配置后再测试：

Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:http_proxy -ErrorAction SilentlyContinue
Remove-Item Env:https_proxy -ErrorAction SilentlyContinue

3. 校验Kubernetes组件运行状态 #

如果上述配置完成后仍然报错，先确认K8s组件本身正常启动：

• 查看Docker Desktop左下角的Kubernetes状态标识，绿色为正常运行，黄色/红色为启动异常。如果启动异常，可以点击设置 -> Kubernetes -> Reset Kubernetes Cluster重置集群（该操作会清空本地K8s集群内所有工作负载和数据），等待集群完全启动后再测试。
• 执行netstat -ano | findstr ":6443"查看端口监听状态，如果没有任何进程监听6443端口，说明Kubernetes APIServer未正常启动，优先查看Docker Desktop运行日志定位启动失败原因。

4. 临时绕过域名解析验证 #

可以直接修改kubectl配置将服务地址改为本地回环地址，快速验证是否为域名解析问题：

kubectl config set-cluster docker-desktop --server=https://127.0.0.1:6443

执行后运行kubectl cluster-info，如果能正常返回集群信息，可确认故障点就是域名解析链路走了代理通道，回头补全前两步的配置即可。

注意：如果Docker Desktop使用WSL2后端，不要直接替换为127.0.0.1，需要替换为WSL2虚拟网卡的对应IP，或者在WSL2系统内的hosts文件同步追加域名映射规则。

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