Docker Desktop 内置 Kubernetes 启动失败的核心原因是底层依赖未就绪或配置不匹配，需按“能否拉到镜像→能否跑起来→能否连上 API”三层递进排查：先确认 WSL2 运行正常（wsl --list --verbose 显示 VERSION 为 2 且状态 Running），再验证 Docker daemon 是否就绪（docker info 无 500 错误、com.docker.service 服务 Running），接着检查国内镜像源配置是否生效并确保 k8s 镜像拉取完整，最后排查 6443 端口占用、防火墙拦截及日志中 kubelet/apiserver 等关键错误。
windows 上 docker desktop 内置的 kubernetes 启动失败，核心问题通常不是 kubernetes 本身出错，而是底层依赖未就绪或配置不匹配。排查要从“能否拉到镜像”“能否跑起来”“能否连上 api”三层递进，而不是直接看 kubectl 报错。
确认 WSL2 和 Docker 引擎是否真正就绪
Kubernetes 在 Docker Desktop 中完全运行在 WSL2 的 Linux 虚拟机里，如果 WSL2 没跑稳，K8s 根本不会启动：
- 以管理员身份打开 PowerShell，运行 wsl --list --verbose，确认至少有一个发行版（如 Ubuntu）状态为 Running 且 VERSION 是 2
- 运行 docker info，若返回 500 错误或提示 pipe 找不到，说明 Docker daemon 没起来——先别碰 Kubernetes，先解决 Docker 自身启动问题
- 检查服务状态：Get-Service com.docker.service，确保状态是 Running；若为 Stopped，手动执行 Start-Service com.docker.service
检查镜像拉取是否完成且完整
Docker Desktop 启用 Kubernetes 时会自动拉取 k8s.gcr.io 域名下的多个镜像（如 coredns、etcd、pause），国内网络环境下极易中断或拉取不全：
- 进入 Docker Desktop 设置 → Resources → WSL Integration，确保已启用对应 WSL 发行版
- 设置 → Docker Engine，添加国内镜像源（推荐组合）：
"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn", "https://cr.console.aliyun.com"] - 启用 Kubernetes 后，打开 Images 标签页，观察是否有镜像卡在 “Pulling” 或状态为空；若有，说明拉取失败
- 若发现镜像缺失或拉取异常，可点击右上角 bug 图标 → Clean / Purge data → 勾选全部三项（清除所有镜像、容器、数据卷），再重启 Docker Desktop，触发重新拉取
验证端口与网络组件是否冲突
Kubernetes 控制平面默认监听 6443 端口，而 Windows 的 Hyper-V 动态端口范围可能将其占用，导致 API Server 启动失败：
- 打开 PowerShell（管理员），运行：
netsh int ipv4 show excludedportrange protocol=tcp
查看输出中是否包含 6443 —— 若有，说明该端口被系统保留，K8s 无法绑定 - 临时释放方式（需重启生效）：
netsh int ipv4 set dynamicport tcp start=49152 num=16384
将动态端口起始值调高，避开 6443 - 检查防火墙是否拦截：
确保 vpnkit.exe（路径：C:Program FilesDockerDocker esources pnkit.exe）同时被允许入站和出站；仅加白名单入站规则不够，必须补上出站
查看日志定位具体失败阶段
界面只显示 “Starting…” 很难判断卡在哪一步，真实线索藏在日志里：
- 日志路径：
C:Users\AppDataLocalDockerlog.txt（注意是 Local，不是 Roaming） - 重点关注含以下关键词的行：
“kubernetes”、“kubelet”、“apiserver”、“failed to start”、“bind: address already in use”、“EOF”、“connection refused” - 常见线索举例：
– 出现 “EOF” 或 “6443/api/v1/nodes: EOF”：API Server 已启动但无法响应，大概率是证书或网络问题
– 出现 “ImagePullBackOff”：镜像拉取失败，回到第二步检查 registry-mirrors 或手动拉取
– 出现 “LxssManager service is not running”：WSL 子系统服务异常，需重置 WSL（wsl --shutdown + 重启）
