一、开始前准备（2 分钟检查）
目标：装好 Docker Desktop，并确保“拉镜像不超时、容器能跑”。如果你在公司/校园网环境，建议先确认是否需要代理或镜像加速。
- Windows：建议 Windows 11 22H2+，管理员权限；开启虚拟化（BIOS/UEFI 里的 Virtualization/VT）。
- macOS：建议 macOS 12+；Apple 芯片和 Intel 都支持，但下载时要选对架构。
- 磁盘空间：至少预留 10GB（含镜像与容器数据）。
二、Windows 11 安装（WSL2 推荐方案）
- 安装 WSL2：在“Windows 终端(管理员)”执行 wsl --install，按提示重启。
- 首次进入 Linux：重启后按提示创建 Linux 用户名/密码（记住即可）。
- 下载 Docker Desktop（Windows 版）并安装：安装时勾选“Use WSL 2 instead of Hyper-V”（如有）。
- 启动 Docker Desktop：首次启动会做环境检测，等状态变为 Running。
- 在 Docker Desktop 设置里确认：Settings → Resources → WSL Integration，打开你正在使用的发行版集成。
三、macOS 安装（Intel / Apple 芯片都适用）
- 下载对应架构的 Docker Desktop（Apple Silicon 或 Intel）。
- 将 Docker.app 拖入 Applications，首次运行按系统提示授权。
- 状态栏小鲸鱼图标显示“Docker Desktop is running”即完成。
四、镜像加速与代理设置（解决拉取慢/超时）
优先级建议：先配镜像加速（简单、稳定），仍不通再配代理。
- 镜像加速：打开 Docker Desktop → Settings → Docker Engine，在 JSON 中加入/修改 registry-mirrors（示例如下），保存并重启 Docker。
{
"registry-mirrors": ["https://mirror.example.com"],
"features": {"buildkit": true}
}
说明：镜像地址以你自己的加速源为准；如果没有加速源，也可以先跳过该项。
- HTTP/HTTPS 代理（可选）：Settings → Resources/Proxies（不同版本位置略有差异），填入代理地址（例如 http://127.0.0.1:7890），保存并重启。
- 验证网络是否生效：稍后用“第一个容器”步骤做验证。
五、跑起第一个容器（验证安装是否真的成功）
- 打开终端/命令行，执行：docker version（能看到 Client/Server 信息说明 daemon 正常）。
- 执行示例容器：docker run --rm hello-world。
- 看到 “Hello from Docker!” 即 OK。
六、常见报错排查（按这个顺序基本不绕路）
1）WSL 2 installation is incomplete / WSL 未就绪
- 先确认 Windows 已重启；再检查系统更新是否完成。
- 在终端执行 wsl -l -v，确认发行版 VERSION 为 2。
- 如果是 VERSION=1，可执行 wsl --set-version <发行版名> 2。
2）Cannot connect to the Docker daemon
- 先看 Docker Desktop 是否显示 Running；未运行就先启动它。
- Windows/WSL：确认你在正确的环境里执行命令（Windows 终端或已集成的 WSL）。
- 重启 Docker Desktop 通常能解决临时 socket/服务异常。
3）拉取镜像超时：i/o timeout / TLS handshake timeout
- 优先配置镜像加速或代理，然后重启 Docker Desktop。
- 公司网络可能拦截某些域名：换网络（热点）验证能否拉取，以判断是否网络策略问题。
4）虚拟化相关：Hyper-V/Virtualization 未开启
- 进 BIOS/UEFI 开启 CPU 虚拟化（VT-x/AMD-V）。
- Windows：确保系统支持并开启 WSL2 相关组件；如你使用的是 Hyper-V 方案，需启用相应功能。
七、收尾建议（让它更好用）
- 把 Docker Desktop 设为开机自启（按需）。
- 定期清理无用镜像/构建缓存：在 Docker Desktop 的 Clean/Purge 功能中操作更直观。
- 项目开发建议优先使用 docker compose 管理多容器服务，结构更清晰。
