Windows 安装 Docker 详细教程

• /enable-feature：启用指定系统功能；
• /featurename:Microsoft-Hyper-V：目标功能是 Hyper-V；
• /all：启用该功能所有子组件；
• /norestart：临时不重启系统。

第二条命令：启用 WSL 2 虚拟机平台

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

• 核心作用：启用 WSL 2 所需的虚拟机平台组件。
• 参数说明：
  • /featurename:VirtualMachinePlatform：目标功能是'虚拟机平台'；
  • 其他参数同上。

为什么要同时启用这两个组件？

简单说：Docker 在 Windows 上的运行依赖'虚拟化环境'，而这两个组件共同构成了虚拟化的基础：

• Hyper-V：传统虚拟化引擎，为早期 Docker 提供 Linux 虚拟机载体；
• VirtualMachinePlatform：WSL 2 专用轻量虚拟化层，是现代 Docker 推荐的'高效后端'。

现在 Docker Desktop 安装时会自动检测并优先使用 WSL 2（需 VirtualMachinePlatform 支持），若 WSL 2 不可用才会回退到 Hyper-V。因此，启用这两个组件是为了确保 Docker 有可用的虚拟化环境。

注意事项

1. 硬件要求：这两个功能依赖 CPU 虚拟化技术（Intel VT-x / AMD-V），需在 BIOS/UEFI 中开启。
2. 系统版本限制：
   • Hyper-V 仅支持 Windows 10/11 专业版、企业版、教育版；
   • WSL 2 和 VirtualMachinePlatform 支持 Windows 10 2004+ / Windows 11 所有版本。
3. 重启生效：执行命令后需重启电脑，组件才能正式激活。

验证

验证 1：检查 WSL 2 是否可用

重启后，在 cmd 中输入命令：wsl --status。 若输出中包含 默认版本：2 和 内核版本：…，说明 VirtualMachinePlatform 已生效。

验证 2：检查 Hyper-V 服务是否运行

重启后，打开'服务'（services.msc），查找以下服务：

• Hyper-V 虚拟机管理
• Hyper-V 主机计算服务

若状态为'正在运行'，说明 Hyper-V 组件已生效。

2. 安装 WSL 2 内核更新包

👉 双击安装
若提示：您的系统已安装了更高版本的 Windows 子系统 Linux 更新。安装程序即将退出。

执行：

wsl --set-default-version 2

3. 下载 Docker Desktop

官网下载
✅ 认准'Download for Windows - AMD64'按钮

4. 安装并启动

1. 双击下载的 Docker Desktop Installer.exe
2. 勾选 ✅ Use WSL 2 instead of Hyper-V（推荐）

要理解 Docker Desktop 安装界面这三个选项的含义，我们可以逐个拆解：

Use WSL 2 instead of Hyper-V (recommended)

意思是'使用 WSL 2 替代 Hyper-V（推荐）'。

• WSL 2：全称 Windows Subsystem for Linux（Windows 子系统 for Linux）的第二代技术。它让 Windows 能直接运行 Linux 内核环境，无需传统虚拟机（如 Hyper-V）的完整硬件模拟，对系统和开发流程的'侵入性'更低，且性能更接近原生 Linux。
• Hyper-V：是 Windows 自带的全功能虚拟化技术。但 Docker 选择用 WSL 2 替代它，是因为 WSL 2 对 Docker 容器的集成度更高、启动更快、资源占用更优，是官方推荐的默认方案。

Allow Windows Containers to be used with this installation

意思是'允许此安装使用 Windows 容器'。

• Windows 容器：是专门为 Windows 系统设计的容器。和常见的'Linux 容器'不同，Windows 容器依赖 Windows 内核特性，只能运行 Windows 原生应用或框架。
• 勾选后，Docker Desktop 不仅能运行常规的 Linux 容器，还支持 Windows 容器；但需注意：Windows 容器的生态、兼容性、资源占用和 Linux 容器有明显差异。

Add shortcut to desktop

意思是'在桌面添加快捷方式'。

非常直观：勾选后，Docker Desktop 的启动快捷方式会自动出现在电脑桌面。

简单总结：

• 第一个选项决定 Docker 运行容器的'底层技术栈'（推荐用更轻量的 WSL 2）；
• 第二个选项决定是否扩展支持 Windows 生态的容器（按需开启）；
• 第三个选项是'是否在桌面放快捷方式'的体验优化。

3. 完成安装后登录 Docker Hub 账号（无账号可跳过）

安装完成后桌面就会出现一个图标，双击。

进入：

点击接受，然后：

使用 github 账号登录：

这个提示的意思是：你的 Windows 子系统 for Linux (WSL) 版本太旧了，需要更新。

提示说明

你可能正在安装或运行某个依赖 WSL 的程序（比如 Docker Desktop、Linux 发行版等）。该程序需要更新版本的 WSL 才能正常工作，而当前系统安装的 WSL 版本过旧。

操作步骤

打开 命令提示符 (cmd) 或 PowerShell（以管理员身份运行）。

这个命令会自动下载并安装最新版本的 WSL。

输入以下命令并按回车执行：

wsl --update

后续操作

更新完成后，点击提示窗口中的'Restart'按钮，或手动重启电脑，使更新生效。

简单来说：你的 WSL 该升级了，运行一下它给出的命令就行。这是 Windows 系统组件的正常更新流程，按照提示操作即可。

四、验证安装

docker --version # 输出示例：Docker version 24.0.7, build afdd53b

docker run hello-world # 出现 "Hello from Docker!" 即成功！

若长时间卡在'拉取中'或提示 pull access denied/network timeout，说明拉取出错，需排查以下问题：

1. 网络问题（最常见）
   症状：无法连接 Docker Hub（国外服务器，国内访问慢/被墙）。
   解决：配置国内镜像加速器。

五、配置镜像加速

1. 右键任务栏 Docker 图标 → Settings
2. 在 JSON 中添加镜像源：

进入 Docker Engine 选项卡

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

3. 点击 Apply & Restart

六、常见问题

❌ 错误：WSL 2 installation is incomplete

解决方案：

1. 升级 WSL：wsl --update
2. 手动安装内核：https://aka.ms/wsl2kernel

❌ 错误：Docker Desktop requires a newer WSL kernel

解决方案：
升级 Windows 系统至 21H2 或更高版本

❌ 拉取镜像超时

排查步骤：

1. 检查镜像加速器配置
2. 关闭 VPN 或代理软件
3. 执行 netsh winsock reset 重置网络栈

七、学习资源

• 📚 官方文档：https://docs.docker.com/
• 🛠️ 镜像仓库：https://hub.docker.com/explore