Win11 的 WSL2环境下配置 Docker Desktop 和 Minikube

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

1. 下载 Docker Desktop for Windows 官方安装包
2. 安装过程中确保勾选“为 WSL2 安装 Docker” 选项
3. 安装好后启动 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 里且运行无报错