一、Windows 10/11 安装（推荐 Docker Desktop）

1. 系统要求

• 操作系统：仅支持 Windows 10/11 专业版、企业版、教育版 或 家庭版（需开启 WSL 2）。
• 硬件要求：CPU 支持虚拟化（需在 BIOS 中启用），至少 4GB 内存。
• 依赖组件：需启用 Hyper-V 或 WSL 2（Windows Subsystem for Linux）。

2. 启用 Hyper-V（传统虚拟机方式）

注意：启用 Hyper-V 后，VirtualBox、VMWare 15 及以下版本将无法使用。
方法一：通过控制面板

1. 打开 控制面板 → 程序和功能 → 启用或关闭 Windows 功能。

2. 勾选 Hyper-V 并确认安装，重启电脑。

方法二：通过 PowerShell（管理员权限）

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

3. 安装 Docker Desktop
步骤：

1. 访问 Docker Desktop 官方下载页，点击 Download for Windows 获取安装包。
2. 双击安装包，按向导提示操作（建议默认配置）。
3. 安装完成后，点击 Finish 启动 Docker Desktop（任务栏会显示鲸鱼图标）。

验证安装：

docker run hello-world

若输出 Hello from Docker!，说明安装成功。

二、Windows 7/8 安装（使用 Docker Toolbox）

1. 系统限制

• 仅支持 64 位系统，且需启用 CPU 虚拟化。
• 通过 Oracle VirtualBox 运行 Linux 虚拟机（Docker 引擎部署在虚拟机中）。

2. 安装步骤

1.下载工具包：

• 国内镜像源（推荐）：阿里云 Docker Toolbox 镜像
• 包含组件：Docker CLI、VirtualBox、Docker Machine、Kitematic（图形界面）等。

2.运行安装程序：

• 双击安装包，按向导提示勾选需要的组件（建议保持默认）。
• 安装过程中可能需要确认 VirtualBox 的权限，点击 Yes。

3.启动 Docker：

• 双击桌面 Docker QuickStart Terminal 图标，首次启动会自动创建名为 default 的 VirtualBox 虚拟机。

• 等待终端显示 docker> 提示符，即表示 Docker 环境就绪。

3. 验证安装

docker run hello-world

若输出容器运行日志，说明安装成功。

三、基于 WSL 2 的安装（Windows 10/11 家庭版推荐）

1. 启用 WSL 2

步骤：

1. 以管理员身份打开 PowerShell，执行：

wsl --install

该命令会自动启用 WSL 2 并安装默认 Linux 发行版（如 Ubuntu）。

1. 重启电脑后，按照提示完成 Linux 系统初始化（设置用户名和密码）。

2. 安装 Docker Desktop

1. 下载并安装 Docker Desktop for Windows。
2. 打开 Docker Desktop 设置 → Resources → WSL Integrations，勾选已安装的 Linux 发行版（如 Ubuntu）。
3. 保存设置后，Docker 会自动配置 WSL 2 环境。

验证：在 WSL 终端中执行 docker run hello-world，确认正常运行。

四、常见问题与解决方法

1. Hyper-V 与其他虚拟机冲突

• 现象：启用 Hyper-V 后，VirtualBox/VMWare 无法启动虚拟机。
• 解决：

若需使用其他虚拟机，卸载 Hyper-V（
Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V），改用 WSL 2 模式 安装 Docker Desktop。

或使用 Docker Toolbox（基于 VirtualBox）。

2. WSL 报错：找不到文件 ConfigureGpu

• 错误信息：

找不到文件 Wsl/InstallDistro/Service/RegisterDistro/CreateVm/ConfigureGpu/HCS/ERROR_FILE_NOT_FOUND

• 解决：

wsl --uninstall 
wsl --install -d Ubuntu # 重新安装 WSL 和 Linux 发行版

3. 权限不足（非管理员运行）

• 现象：普通用户执行 docker 命令提示权限拒绝。
• 解决：

Windows 10/11：确保以管理员身份运行 Docker Desktop，或加入 docker 组（需在 WSL 中操作）。Windows 7/8：通过 Docker QuickStart Terminal 启动（已自动配置权限）。

五、优化建议

1. 配置镜像加速器（国内用户必选）：
2. 打开 Docker Desktop 设置 → Docker Engine，添加镜像源（如阿里云）：

{ "registry-mirrors": ["https://your-aliyun-mirror.com"] }

1. 保存后点击 Apply & Restart 生效。
2. 调整资源分配：
3. 在 Docker Desktop 设置 → Resources 中，根据硬件配置调整 CPU、内存和磁盘空间，避免容器运行卡顿。

六、总结

• Windows 10/11 推荐路径：启用 WSL 2 + 安装 Docker Desktop，性能更优且兼容其他开发工具。
• 旧系统兼容方案：使用 Docker Toolbox，但需注意虚拟机资源占用和兼容性限制。
• 关键要点：确保系统版本符合要求，优先使用官方工具，遇到问题参考日志和错误信息逐步排查。