Windows 安装 Docker Desktop 指南
这是一份在 Windows 上从零安装并验证 Docker Desktop 的操作指南，涵盖系统检查、WSL 2 配置、安装步骤和常见问题排查。
Windows 安装 Docker Desktop 指南
1. 安装前确认
系统要求
- Windows 10 64位：Enterprise / Pro / Education，版本 22H2（build 19045）及以上
- Windows 11 64位：Enterprise / Pro / Education，版本 23H2（build 22631）及以上
- Home 版本官方文档未明确说明，可先尝试安装
硬件要求
- 64 位处理器，支持 SLAT（二级地址转换）
- 内存 8GB 及以上（部分旧文档写 4GB，建议按 8GB 准备）
- BIOS/UEFI 中开启硬件虚拟化
检查虚拟化是否已开启
打开任务管理器 → "性能"选项卡 → CPU，右下角查看"虚拟化"是否显示"已启用"。
如未开启，需要重启进入 BIOS/UEFI，找到 Intel VT-x 或 AMD-V（不同主板叫法不同，常见为 Virtualization / SVM Mode），设置为 Enabled。
2. 安装 WSL 2
以管理员身份打开 PowerShell，依次运行：
wsl --install
wsl --update
运行完成后重启电脑。
检查 WSL 版本（需要 2.1.5 或更高）：
wsl --version
3. 下载并安装 Docker Desktop
- 前往官网下载安装包： https://docs.docker.com/desktop/setup/install/windows-install/
- 选择 Docker Desktop for Windows - x86_64
- 双击
Docker Desktop Installer.exe - 保持默认选项（WSL 2 后端），一路安装完成
- 推荐使用 per-user 安装，不需要管理员权限即可安装和更新
- 注意：per-user 模式不支持 Windows 容器，但运行 Linux 容器（绝大多数场景，包括跑 Docker 镜像）完全够用
4. 启动并验证
- 从开始菜单打开 Docker Desktop，等待左下角状态变为运行中
- 打开 PowerShell，运行：
docker --version
docker run hello-world
如果看到 Hello from Docker! 的输出，说明安装成功。
5. 常见问题
管理员账号与日常账号不同
需要把日常账号加入 docker-users 组：
- 以管理员身份运行"计算机管理"
- 依次进入：本地用户和组 → 组 → docker-users
- 右键添加当前用户
- 注销后重新登录生效
国内网络问题
拉取镜像（如 ghcr.io、docker.io 上的镜像）可能很慢或超时，需要给 Docker 配置镜像加速器或代理。具体可用的镜像源经常变化，建议安装前先搜索当前可用的国内镜像加速地址。