Windows安装Minikube搭建K8s开发环境教程

Minikube在Windows上需先启用硬件虚拟化与Hyper-V/WSL2/Docker/VirtualBox之一，再安装minikube和kubectl，最后验证版本、集群启动及Pod状态。

如果您希望在 Windows 系统上搭建本地 Kubernetes 开发环境，Minikube 是最常用的轻量级解决方案。但安装过程依赖虚拟化支持、驱动选择与工具链配置，任一环节缺失都可能导致 minikube start 失败 或命令不可用。以下是多种可行的安装路径：

一、启用系统虚拟化与平台支持

Minikube 必须运行于启用硬件虚拟化的环境中，且需配套虚拟化平台或容器运行时。此步骤是所有后续操作的前提，未完成将导致驱动初始化失败。

1、重启电脑，在启动时按 F2 / Del / F10（依主板而定）进入 BIOS/UEFI 设置界面。

2、查找 Intel VT-x（Intel CPU）或 SVM Mode（AMD CPU）选项，将其设为 Enabled。

3、保存设置并重启，进入 Windows 后以管理员身份运行 PowerShell，执行：
Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All | Select-Object FeatureName, State

4、若 State 为 Disabled，则运行：
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All -NoRestart

5、对于 Windows 10/11 家庭版用户，Hyper-V 不可用，必须改用 WSL2 + Docker Desktop 组合，或直接安装 VirtualBox。

二、安装容器/虚拟机驱动（三选一）

Minikube 通过 driver 参数指定底层运行时。不同 driver 对系统要求与网络行为差异显著，应根据 Windows 版本与已有工具选择适配方案。

1、使用 Docker Desktop（推荐，无需额外虚拟机）：
访问 https://www.docker.com/products/docker-desktop/ 下载安装包；
安装时勾选 “Install required Windows components for WSL2”；
启动后确认系统托盘出现鲸鱼图标，且 PowerShell 中执行 docker version 返回客户端与服务端信息。

2、使用 Hyper-V（仅限 Win10/11 专业版、企业版、教育版）：
在“启用或关闭 Windows 功能”中勾选 Hyper-V 和 Windows Hypervisor Platform；
重启后执行：
minikube start --driver=hyperv --hyperv-virtual-switch="Default Switch"

3、使用 VirtualBox（全版本兼容，免许可证）：
前往 https://www.virtualbox.org/wiki/Downloads 下载 Windows hosts 安装程序；
全程默认选项安装；
安装完成后执行：
minikube start --driver=virtualbox

三、安装 Minikube 与 kubectl（四选一）

Minikube 二进制文件需置于系统 PATH 中才能全局调用；kubectl 可由 minikube 自动托管，也可独立安装以获得完整 CLI 功能。

1、使用 Winget（Windows 10 1809+ / Windows 11 原生支持）：
以管理员身份打开 PowerShell；
执行：
winget install minikube

2、使用 Chocolatey（需先安装包管理器）：
管理员 PowerShell 中运行：
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))；
再执行：
choco install minikube kubernetes-cli

3、手动下载 .exe 文件（离线或受限网络适用）：
访问 https://github.com/kubernetes/minikube/releases 下载最新 windows-amd64.exe；
重命名为 minikube.exe，放入 C:\minikube 目录；
以管理员身份运行 PowerShell，执行：
$env:Path += ';C:\minikube'; [Environment]::SetEnvironmentVariable('Path', $env:Path, 'Machine')

4、通过 WSL2 + Linux 方式（Win10/11 家庭版首选）：
启用 WSL2 并安装 Ubuntu；
在 Ubuntu 中运行：
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 && sudo install minikube-linux-amd64 /usr/local/bin/minikube；
确保 Docker Desktop 已启用 WSL2 集成，并在 Ubuntu 中执行 docker info 验证连通性。

四、验证与基础集群操作

安装完成后需分别验证二进制可用性、集群状态及 kubectl 连通性，三者缺一不可。任何一项失败均表明环境未就绪。

1、新开一个非管理员权限的 PowerShell 或 CMD 窗口；

2、执行：
minikube version

3、执行：
kubectl version --client

4、执行：
minikube start --driver=docker

5、等待输出中出现 Done! kubectl is now configured to use "minikube" cluster；

6、验证集群节点状态：
kubectl get nodes -o wide

7、查看核心系统 Pod 是否 Running：
kubectl get pods -A