Docker Desktop 内置 Kubernetes 可在 Windows 上快速搭建本地集群，需满足系统版本、WSL2、Docker Desktop 4.16+等前提，通过设置启用并验证节点与Pod状态，遇失败可重置、清理WSL或更新镜像。
如果您希望在 Windows 系统上快速搭建一个可用于开发和测试的本地 Kubernetes 集群，Docker Desktop 内置的 Kubernetes 功能提供了一种无需额外安装 minikube 或 k3s 的轻量级方案。以下是启用该功能的具体步骤：
一、确认系统前提条件
Docker Desktop 的 Kubernetes 功能依赖于 Windows 子系统（WSL 2）及特定版本的 Docker Desktop。启用前需确保基础环境满足要求，否则集群无法启动或组件加载失败。
1、确保 Windows 版本为 Windows 10 2004（Build 19041）或更高版本，或 Windows 11；
2、已安装并启用 WSL 2 后端，且默认发行版为 WSL 2 模式（可通过 PowerShell 执行 wsl -l -v 验证）；
3、已下载并安装 Docker Desktop for Windows 4.16 或更新版本（旧版本可能缺少 Kubernetes 切换开关或存在兼容性问题）；
4、Docker Desktop 设置中已勾选 “Use the WSL 2 based engine” 并完成重启。
二、在 Docker Desktop 中启用 Kubernetes
Docker Desktop 提供图形化开关来启用内置 Kubernetes 控制平面，启用后将自动部署 kube-apiserver、etcd、coredns 等核心组件，并配置 kubectl 指向本地集群。
1、启动 Docker Desktop，点击右上角 设置图标（⚙️）→ Settings；
2、左侧菜单中选择 Resources → Kubernetes；
3、勾选 “Enable Kubernetes” 复选框；
4、确认下方显示 “Kubernetes is running” 状态提示，且进度条完成；
5、点击 Apply & Restart 以保存设置并重启 Docker Desktop 服务。
三、验证 Kubernetes 集群状态
启用成功后，Docker Desktop 会自动配置本地 kubectl 上下文指向其内置集群。需通过命令行确认 API Server 可达性与节点就绪状态，排除连接超时或上下文未切换问题。
1、打开 PowerShell 或 Windows Terminal，执行 kubectl config current-context，输出应为 docker-desktop；
2、执行 kubectl get nodes -o wide，返回单行结果且 STATUS 为 Ready；
3、执行 kubectl get pods -A，确认 kube-system 命名空间下 coreDNS、kube-proxy、metrics-server 等 Pod 处于 Running 状态；
4、若出现 The connection to the server localhost:8080 was refused 错误，说明 kubectl 未使用 Docker Desktop 自动配置的上下文，需运行 kubectl config use-context docker-desktop。
四、解决常见启用失败问题
Docker Desktop 启用 Kubernetes 时可能因 WSL 配置冲突、端口占用或镜像拉取失败导致初始化中断。以下为三种独立可操作的修复路径，任选其一即可尝试恢复：
1、重置 Kubernetes 集群：进入 Docker Desktop Settings → Kubernetes，取消勾选 “Enable Kubernetes” → Apply & Restart → 重新勾选并启用；
2、手动清理 WSL 中残留组件：在 PowerShell 中执行 wsl -d docker-desktop --shutdown 和 wsl -d docker-desktop-data --shutdown，再重启 Docker Desktop；
3、强制更新 Kubernetes 镜像缓存：打开 Docker Desktop 终端（右键托盘图标 → Troubleshoot → Clean / Purge data），勾选 “Clean / Purge data” 后重启，触发镜像重新拉取。
五、配置 kubectl 命令行别名与默认命名空间
为提升日常操作效率，可在本地 shell 中设置常用别名与默认命名空间，避免重复输入冗长命令。该配置不修改集群结构，仅影响本地 CLI 行为。
1、在 PowerShell 中执行 Set-Alias k kubectl，使 k get pods 等效于 kubectl get pods；
2、运行 kubectl config set-context --current --namespace=dev，将当前上下文默认命名空间设为 dev（需提前创建）；
3、将上述命令添加至 PowerShell 配置文件（$PROFILE），实现每次启动自动加载；
4、验证别名生效：执行 k version，应返回客户端与服务器版本信息。
