You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows环境Docker Desktop启用Kubernetes后执行kubectl version报连接错误

Docker Desktop 启用 Kubernetes 后 kubectl 连接失败解决方案

错误详情

执行命令:kubectl version
返回原始错误:

kubectl : Unable to connect to the server: dial tcp : connectex:
A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
At line:1 char:1
错误中文翻译:
kubectl 无法连接到服务器:TCP 拨号连接失败:连接尝试超时,对端未在规定时间内返回响应,或已建立的连接异常,目标主机关闭了响应。

修复步骤

  • 确认 Kubernetes 运行状态
    打开 Docker Desktop 进入设置页的 Kubernetes 标签,确认 Kubernetes 集群状态为绿色运行中。如果状态为启动中/启动失败,先重启 Docker Desktop,等待 2-5 分钟让集群组件完成初始化,首次启动需要拉取官方镜像,网络不佳会延长启动时间。
  • 检查 kubectl 上下文配置
    执行 kubectl config get-contexts 查看本地所有集群上下文,确认当前激活的上下文为 docker-desktop。如果当前指向其他集群,执行 kubectl config use-context docker-desktop 切换到本地 Docker 内置的 Kubernetes 集群。
  • 重置 Kubernetes 集群
    上述操作无效的情况下,打开 Docker Desktop 的 Kubernetes 设置页,点击 Reset Kubernetes Cluster 重置集群配置,重置完成后再次执行 kubectl version 验证。
  • 检查本地端口占用
    Kubernetes API 服务默认监听本地 6443 端口,执行 netstat -ano | findstr :6443 查看端口是否被其他应用占用。如果存在其他进程占用,结束对应进程后重启 Kubernetes 即可恢复连接。

内容的提问来源于stack exchange,提问作者srigu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.06 12:48:04