2. Docker Desktop 安装与配置：Windows/Mac 下的完整环境搭建
在支付订单系统的本地开发中，Docker Desktop 是运行中间件（MySQL、Redis、RocketMQ、Nacos 等）的核心容器管理平台。本章将指导你在 Windows 和 Mac 环境下完成 Docker Desktop 的下载、安装、镜像加速器配置以及 Windows 特有的 WSL2 集成。
2.1 下载与安装
| 操作系统 | 下载地址 | 安装注意事项 |
|---|---|---|
| Windows (x86_64) | Docker Desktop for Windows | 需启用 WSL2 或 Hyper-V；建议 8GB 以上内存 |
| macOS (Intel) | Docker Desktop for Mac (Intel Chip) | macOS 11 (Big Sur) 及以上版本 |
| macOS (Apple Silicon) | Docker Desktop for Mac (Apple Chip) | 原生支持 M1/M2/M3 芯片，性能优于 Rosetta 转译 |
版本选择建议： 支付系统中间件调试推荐使用 Docker Desktop 4.25+ 版本，该版本对 Kubernetes 单节点集群和 Compose V2 支持更稳定，避免因版本过旧导致的容器网络兼容性问题。
2.2 安装步骤（Windows 示例）
- 系统前置检查： 确保 Windows 10 64 位（22H2 以上）或 Windows 11，BIOS 中已开启虚拟化（VT-x/AMD-V）。
- 下载安装包： 从 Docker Hub 下载
Docker Desktop Installer.exe（约 600MB）。 - 执行安装： 双击安装包，勾选 "Use WSL 2 instead of Hyper-V"（推荐），点击 OK 开始安装。
- 重启系统： 安装完成后重启，Docker Desktop 会自动启动并在任务栏显示鲸鱼图标。
- 验证安装： 打开终端（PowerShell 或 CMD），执行以下命令：
docker --version
docker compose version
docker run hello-world若看到 "Hello from Docker!" 信息，则安装成功。
2.3 镜像加速器配置
由于国内网络环境，直接拉取 Docker Hub 镜像速度较慢。支付系统中间件镜像（如 mysql:8.0、redis:7.2、apache/rocketmq:5.1.4）体积较大，必须配置镜像加速器。
2.3.1 配置方法
- 打开 Docker Desktop → 点击右上角 ⚙️ Settings → 左侧 Docker Engine。
- 在
registry-mirrors字段中添加加速器地址（JSON 数组格式）。 - 点击 Apply & Restart 使配置生效。
推荐使用阿里云容器镜像服务（需登录后获取个人专属加速地址）或中科大镜像源：
{
"registry-mirrors": [
"https://<your-code>.mirror.aliyuncs.com",
"https://docker.mirrors.ustc.edu.cn"
]
}
注意： 不要同时配置过多加速器地址，2~3 个即可。配置后请测试拉取速度：
docker pull nginx:alpine，若速度仍慢，检查加速器地址是否有效或更换为腾讯云/网易镜像源。
2.4 WSL2 集成（Windows 专属）
WSL2（Windows Subsystem for Linux 2）是 Docker Desktop 在 Windows 上推荐的容器运行后端。相比 Hyper-V，WSL2 启动更快、内存占用更低，且与 Linux 内核完全兼容，是支付系统中间件本地调试的最佳选择。
2.4.1 启用 WSL2 前置条件
| 组件 | 要求 | 验证命令 |
|---|---|---|
| Windows 版本 | Windows 10 2004+ 或 Windows 11 | winver |
| WSL 内核 | 已安装 WSL2 Linux 内核更新包 | wsl --status |
| 默认 WSL 版本 | 设置为 WSL2 | wsl --set-default-version 2 |
2.4.2 安装 Linux 发行版
在 PowerShell（管理员）中执行：
# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重启后，安装 Ubuntu 22.04 LTS（推荐）
wsl --install -d Ubuntu-22.042.4.3 配置 Docker Desktop 使用 WSL2
- 打开 Docker Desktop → Settings → Resources → WSL Integration。
- 确保 "Enable integration with my default WSL distro" 已勾选。
- 在下方列表中选择你安装的 Ubuntu 发行版，打开开关。
- 点击 Apply & Restart。
配置完成后，在 Ubuntu 终端中可直接使用 docker 命令，无需额外安装 Docker CLI。
WSL2 集成优势：
- 容器运行在 WSL2 轻量级 VM 中，性能接近原生 Linux。
- 文件 I/O 性能比 Hyper-V 提升 3~5 倍，适合 RocketMQ 等磁盘密集型中间件。
- 支持 systemd，可在 WSL2 内直接管理服务。
2.5 Docker Desktop 配置验证与中间件拉取测试
完成上述配置后，建议执行一次完整的中间件拉取测试，确保环境可用于后续章节的支付订单系统调试：
# 测试拉取支付系统常用中间件镜像
docker pull mysql:8.0
docker pull redis:7.2
docker pull nacos/nacos-server:v2.3.2
docker pull apache/rocketmq:5.1.4
# 查看镜像列表
docker images
# 测试容器运行（MySQL 示例）
docker run --name test-mysql -e MYSQL_ROOT_PASSWORD=123456 -d mysql:8.0
docker ps
docker stop test-mysql && docker rm test-mysql若所有镜像拉取成功且容器能正常启动，则 Docker Desktop 环境搭建完成。