docker desktop 内置 kubernetes 可通过图形界面一键启用,无需额外配置;启动后在 settings → resources → kubernetes 勾选启用并重启,验证需 kubectl config current-context 返回 docker-desktop 且 kubectl get nodes 显示 ready。
直接在 docker desktop 图形界面里打开开关就行,不需要额外装组件或配环境变量(只要 docker desktop 本身安装正确)。
确保 Docker Desktop 已正常运行
启动后右下角任务栏会出现鲸鱼图标,点击它确认状态是“Docker Desktop is running”。如果图标灰掉或报错,先解决 Docker 引擎启动问题——Kubernetes 依赖 Docker 守护进程。
启用 Kubernetes 的具体步骤
- 点击右上角设置图标(⚙️)→ 打开 Settings
- 左侧选 Resources → Kubernetes
- 勾选 Enable Kubernetes
- 等待下方显示 “Kubernetes is running”,进度条走完
- 点击 Apply & Restart,让 Docker Desktop 重启并加载集群
验证是否生效
打开 PowerShell 或 Windows Terminal:
-
kubectl config current-context应输出docker-desktop -
kubectl get nodes返回一行,STATUS 是 Ready -
kubectl get pods -A | findstr "Running"能看到 coreDNS、kube-proxy 等核心 Pod 处于 Running 状态
常见卡点和应对
- 镜像拉取慢或失败:在 Docker Desktop → Settings → Docker Engine 中添加国内镜像源,例如:
{ "registry-mirrors": ["https://docker.1panel.live"] } - 启用后 kubectl 不识别:检查系统 PATH 是否包含
C:\Program Files\Docker\Docker\Resources\bin,该路径下有kubectl.exe - WSL2 未启用:Windows 10/11 专业版需在“启用或关闭 Windows 功能”中勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”,并重启
这个内置集群是单节点标准 K8s,含 etcd、API Server、Scheduler 等全部控制平面组件,适合本地开发、CI 测试和学习使用。











