Windows下Docker Desktop安装与版本选择指南

一、系统要求检查

1.1 最低与推荐配置

项目	最低要求	推荐配置
操作系统	Windows 10 64位（Build 19041+）/ Windows 11 64位	Windows 11 专业版
CPU	支持虚拟化的64位处理器（Intel VT-x/AMD-V）	4核以上
内存	4GB RAM	8GB+ RAM
存储	4GB可用空间	10GB+ SSD
必要功能	启用WSL2或Hyper-V	WSL2（推荐）

1.2 检查Windows版本

Win+R → 输入winver → 查看版本号和内部版本号

二、Docker版本选择（Windows）

2.1 核心版本选择

推荐版本：Download for Windows - AMD64
适用场景说明 ：
- AMD64版本：适用于绝大多数Windows设备，包括英特尔（Intel）或AMD x86-64架构处理器的笔记本、台式机（主流选择）
- ARM64版本：仅针对搭载ARM架构处理器的设备（如微软Surface Pro X、部分轻薄本，少见）

2.2 确认电脑架构

右键点击"此电脑" → 选择"属性"
在"系统"信息中查看"系统类型"：
- 显示"x64-based PC" → 选AMD64
- 显示"ARM64-based PC" → 选ARM64

三、准备工作（WSL2后端，推荐）

以管理员身份打开PowerShell，执行以下命令启用WSL和虚拟机平台：

powershell 复制代码

wsl --install

此命令自动完成：

启用WSL和虚拟机平台功能
下载安装最新Linux内核
设置WSL2为默认版本
安装Ubuntu分发版

重启电脑完成WSL安装
安装完成后，设置默认WSL版本为2：

powershell 复制代码

wsl --set-default-version 2

（可选）安装其他Linux分发版：

powershell 复制代码

wsl --list --online  # 列出可用分发版
wsl --install -d <Distribution Name>  # 安装指定分发版

四、下载Docker Desktop安装程序

4.1 图形界面下载

访问Docker官方网站：https://www.docker.com/products/docker-desktop
点击"Download for Windows"按钮（自动适配系统架构）

4.2 PowerShell下载（自动化）

powershell 复制代码

$url = "https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe"
$output = "$env:TEMP\DockerDesktopInstaller.exe"
Invoke-WebRequest -Uri $url -OutFile $output

五、安装Docker Desktop

5.1 图形界面安装（默认路径）

双击运行Docker Desktop Installer.exe（建议以管理员身份运行）
勾选许可协议，点击"OK"
配置安装选项（专业版可见，家庭版默认WSL2）：
- ✅ Use WSL 2 instead of Hyper-V（推荐，性能更佳）
- ✅ Install required Windows components for WSL 2（自动安装WSL2所需组件）
- ✅ Add shortcut to desktop（添加桌面快捷方式）
点击"OK"开始安装，等待约5-10分钟
安装完成后，点击"Close and restart"重启电脑

5.2 自定义路径安装（C盘空间不足）

powershell 复制代码

# 基本安装命令
Start-Process -Wait -FilePath "Docker Desktop Installer.exe" -ArgumentList "install --installation-dir=D:\Docker"

# 完整自定义安装命令（含WSL2配置）
Start-Process -Wait -FilePath "Docker Desktop Installer.exe" -ArgumentList "install --installation-dir=D:\Docker --wsl-default-data-root=D:\Docker\wsl-data"

六、初始化与配置Docker Desktop

重启后，Docker Desktop自动启动，显示欢迎界面
勾选"I accept the terms"并点击"Accept"接受服务条款
登录Docker账号（可选，建议注册登录，可使用Docker Hub镜像库）
等待Docker引擎启动（右下角显示绿色鲸鱼图标表示正常运行）
（推荐）配置国内镜像加速：
- 右键托盘Docker图标 → Settings（设置）→ Docker Engine
- 在配置文件中添加镜像源：

json 复制代码

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

点击"Apply & Restart"应用配置并重启Docker

七、验证Docker安装

7.1 界面验证

打开Docker Desktop → Images（镜像）和Containers（容器）页面显示正常
点击右上角Settings → Diagnose & Feedback → 显示"Docker is running"

7.2 命令行验证（推荐）

bash 复制代码

# 检查Docker版本
docker --version
# 输出示例：Docker version 26.0.0, build 2ae903e

# 检查Docker Compose版本
docker-compose --version
# 输出示例：Docker Compose version v2.24.6

# 运行测试容器
docker run hello-world

输出"Hello from Docker!"相关信息表示安装成功

八、常见问题解决

8.1 WSL2相关错误

确保已启用虚拟机平台：控制面板 → 程序 → 启用或关闭Windows功能 → 勾选"虚拟机平台"和"WSL"
更新WSL内核：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

8.2 Docker启动失败

检查是否同时启用了Hyper-V和WSL2（专业版建议选其一）
以管理员身份运行Docker Desktop
重启电脑后重试

8.3 镜像下载慢

配置国内镜像加速（见第六部分第5点）
重启Docker服务后再尝试拉取镜像

8.4 WSL2与Docker集成问题

打开Docker Desktop → Settings → Resources → WSL Integration
确保已启用需要集成的Linux分发版