1. 准备工作
- 操作系统：Win11，建议保持系统更新
- WSL版本：强烈建议使用 WSL2（性能和兼容性更好）
- 推荐用 Ubuntu 20.04/22.04 作为 WSL 子系统
检查/安装 WSL2
在 PowerShell（管理员）运行：
wsl --install
wsl --set-default-version 2
如已安装可用 wsl -l -v 查看当前系统及版本。
如需升级已存在子系统至 WSL2：
wsl --set-version <Your-Distro-Name> 2
2. 安装 Docker Desktop
- 下载 Docker Desktop for Windows 官方安装包
- 安装过程中确保勾选“为 WSL2 安装 Docker” 选项
- 安装好后启动 Docker Desktop，务必在设置→资源→WSL integration，确保你用的 WSL 发行版已启用 Docker 集成（一般都自动勾选）
验证：在 WSL/Ubuntu 里直接执行
docker info能看到 Docker 信息，表示已连通
在 WSL Ubuntu 中遇到域名解析失败（例如执行 sudo apt update 时出现 Temporary failure resolving 错误）是一个常见问题。其核心原因是 WSL 会自动生成并覆盖 /etc/resolv.conf 这个 DNS 配置文件，导致您自定义的 DNS 设置失效。
首先，您需要编辑或创建 /etc/wsl.conf 文件，告诉 WSL 不要自动管理 DNS。
sudo nano /etc/wsl.conf
在文件中添加以下配置
[network]
generateResolvConf = false
保存并退出编辑器。
手动配置 DNS 服务器 接下来，删除旧的 DNS 配置文件，并创建一个新的、静态的配置文件。 bash # 删除可能存在的旧文件（包括符号链接）
sudo rm -f /etc/resolv.conf
然后，创建新的 resolv.conf 文件并写入 DNS 服务器地址
sudo nano /etc/resolv.conf
在文件中输入您选择的 DNS 服务器。最推荐使用您 Windows 主机中 WSL 虚拟网卡的 IP 作为 DNS 网关，这通常能获得最稳定的解析。您可以在 Windows PowerShell 中运行 ipconfig，找到名为 vEthernet (WSL) 的适配器，其 IPv4 地址 就是您需要的网关（例如 172.28.160.1）。
nameserver 172.28.160.1 # 请替换为您自己查到的 WSL 网关 IP
或者，您也可以使用公共 DNS，例如：
nameserver 114.114.114.114 # 国内常用 DNS
nameserver 8.8.8.8 # Google 公共 DNS
保存并退出。
重启 WSL 使配置生效 配置完成后，您必须完全重启 WSL 才能使更改生效
- 在 WSL Ubuntu 终端中，输入 exit 退出。
- 在 Windows PowerShell 或 CMD（以管理员身份运行）中，执行关闭命令： powershell wsl –shutdown
- 等待几秒后，重新启动您的 WSL Ubuntu 发行版。
- 验证 DNS 解析 重新进入 WSL Ubuntu 后，首先检查配置是否已应用： bash cat /etc/resolv.conf
确认输出的 nameserver 是您设置的地址。然后，测试网络连通性： bash ping www.baidu.com
如果能够收到回复，说明域名解析已恢复正常。
3. 配置 kubectl
在 WSL/Ubuntu 执行：
sudo apt update
sudo apt install -y curl apt-transport-https
# 添加 Kubernetes 官方 key
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
# 添加 Kubernetes 源
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt update
sudo apt install -y kubectl
4. 安装 Minikube
建议用官方脚本：
bash
curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
chmod +x minikube
sudo mv minikube /usr/local/bin/
minikube version
5. 配置 helm
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
helm version
6. 启动 Minikube（WSL2 推荐用 docker driver）
minikube start --driver=docker
Tips:
- Minikube 会用 Docker Desktop 的后端，不额外开虚拟机
- 如需指定资源，如脚本要求的 cpu/memory:
bash
minikube start --driver=docker --cpus=6 --memory=10g
如果卡住/报错，先尝试 minikube delete 清理旧环境。
7. 校验
kubectl get node应该能返回 minikube 节点minikube dashboard可以打开浏览器看到 Kubernetes Dashboard- 在 WSL 里运行
docker images能看到镜像 - 脚本用到的命令都在 PATH 里且运行无报错
