Docker Desktop 是在 Windows/macOS 上最省心的本地容器运行环境之一：它把 Docker Engine、GUI 管理、Kubernetes（可选）以及与系统的网络/文件共享整合到一起。本文按“安装 -> 基础配置 -> 镜像加速 -> 常见问题排查”的顺序写，你照着做完就能稳定地拉镜像、跑容器、做本地开发。
Windows 建议 Windows 11/10 64 位，优先使用 WSL2 作为后端。先确认：系统已启用虚拟化（BIOS/UEFI 中的 Intel VT-x/AMD-V），并在“任务管理器 -> 性能”里看到“虚拟化：已启用”。
macOS 建议使用较新版本的 macOS；Apple Silicon（M 系列）与 Intel 都可用，但部分镜像的架构需要留意（arm64/amd64）。
参考链接（工具地址）：https://docs.docker.com/desktop/
1) 下载并安装 Docker Desktop（官方页面见上方链接）。安装时勾选/选择使用 WSL2 作为后端（如果安装器提供该选项）。
2) 更新并启用 WSL2（如你之前没用过）：
wsl --update
wsl --set-default-version 2
3) 打开 Docker Desktop 后，进入 Settings（设置）-> Resources/WSL Integration，选择你要集成的 Linux 发行版（例如 Ubuntu）。
4) 验证安装：
docker version
docker run --rm hello-world
如果 hello-world 能正常拉取并输出欢迎信息，说明引擎可用。
1) 从 Docker Desktop 官方页面下载对应芯片版本并安装。
2) 第一次启动时按提示授权（可能需要输入系统密码/允许后台组件）。
3) 验证安装：
docker version
docker run --rm hello-world
若你在 Apple Silicon 上运行 amd64 镜像，可能会看到拉取不同架构的提示，这是正常现象；建议优先选择带 arm64 的镜像或多架构镜像。
在网络环境不稳定或访问国外仓库较慢时，建议配置镜像加速。Docker Desktop 通常提供可编辑的 Engine 配置（JSON）。
路径示例：Docker Desktop -> Settings -> Docker Engine（或类似入口）。在 JSON 中加入/修改 registry-mirrors，例如：
{ "registry-mirrors": [ "https://mirror.gcr.io" ] }
保存后 Docker 会重启生效。注意：不同地区/网络可用的镜像源不同；如果配置后仍然慢或拉取失败，先暂时移除镜像源配置做对比验证，再替换为你所在网络可用的源。
参考链接：https://docs.docker.com/network/
1) Windows 提示需要启用虚拟化/Hyper-V/WSL2
先确认 BIOS 虚拟化已开；然后在 Windows 功能里启用相关组件（不同版本可能名称不同）。如果你只用 WSL2 后端，重点是 WSL 与虚拟机平台相关组件。完成后重启。
2) Docker Desktop 启动很慢或卡在 “Starting”
优先检查系统代理/网络是否导致访问受阻；其次检查是否与安全软件/网络过滤冲突。你也可以在 Docker Desktop 的 Troubleshoot/诊断页面查看是否有明显报错信息。
3) 拉镜像报错：timeout / TLS handshake / proxy
先把问题归因到网络：换网络、关闭/更换代理、对比是否只在特定仓库失败。再检查是否配置了不可用的 registry-mirrors。必要时清空镜像源并重启 Docker，确认“默认配置”是否可用。
4) 权限问题：无法访问挂载目录/文件变化不生效
Windows+WSL2 场景建议尽量把项目放在 Linux 文件系统里（例如发行版的 home 目录）以减少跨文件系统带来的性能/权限问题。macOS 场景注意在 Docker Desktop 的 File Sharing 中授权你的项目目录。
5) 端口冲突：容器启动失败或网页打不开
检查主机端口是否已被占用，调整映射端口即可。比如把 -p 80:80 改为 -p 8080:80。
你可以用最简单的 nginx 容器验证“拉镜像 + 端口映射 + 浏览器访问”全链路：
docker run --rm -p 8080:80 nginx:alpine
然后打开浏览器访问：https://127.0.0.1:8080（如果浏览器提示证书/协议问题，改为 http://127.0.0.1:8080）。能看到 nginx 欢迎页说明环境整体 OK。
到这里，你的 Docker Desktop 基础环境就完成了。后续你可以再按需引入 Compose、私有镜像仓库、或把常用命令做成脚本，但建议先把“稳定可用”的底座搭好。
