适用:Windows 11(推荐 WSL2 后端)与 macOS(Intel/Apple Silicon)。目标:安装完成后能执行 docker run hello-world 并正常拉取镜像。
准备:稳定网络;管理员权限;Windows 需开启虚拟化(BIOS/UEFI)与 WSL2。
第1步:检查虚拟化:任务管理器 → 性能 → CPU,确认“虚拟化:已启用”。若未启用,需要在 BIOS/UEFI 打开 VT-x/AMD-V。
第2步:启用 WSL2(管理员 PowerShell):
wsl --install wsl --update wsl --set-default-version 2重启后,在 Microsoft Store 安装一个 Linux 发行版(如 Ubuntu)。首次启动会让你创建 Linux 用户名/密码。
第3步:安装 Docker Desktop:下载并安装后,首次启动在设置里选择使用 WSL2 引擎(Use WSL 2 d engine)。
第4步:开启 WSL 集成:Docker Desktop → Settings → Resources → WSL Integration,打开你使用的发行版(如 Ubuntu)。
第1步:选择正确安装包:Apple Silicon 选 ARM64,Intel 选 x86_64。
第2步:拖拽安装并授权:把 Docker.app 拖到 Applications,首次启动按提示授予权限(可能需要输入系统密码)。
第3步:资源配置:Docker Desktop → Settings/Preferences,按你的机器情况设置 CPU/内存(例如 2-4 CPU、4-8GB 内存起步)。
如果你所在网络拉取 Docker Hub 较慢,可配置镜像加速。路径:Docker Desktop → Settings → Docker Engine,在 JSON 中加入 registry-mirrors,例如:
{ "registry-mirrors": [ "https://YOUR-MIRROR-URL" ] }说明:镜像地址因网络与服务商而异,请使用你可信、合规的镜像服务;保存后 Docker Desktop 会提示重启引擎。
第1步:查看版本:
docker version docker compose version第2步:跑 hello-world:
docker run --rm hello-world看到欢迎信息即表示:客户端、服务端、镜像拉取都正常。
1) Cannot connect to the Docker daemon
原因:Docker Desktop 未启动/引擎未就绪。处理:打开 Docker Desktop 等待状态变为 Running;必要时重启 Docker Desktop。
2) WSL2 相关错误(Windows)
处理:
wsl --update wsl --shutdown然后重启 Docker Desktop,并在 WSL Integration 中重新勾选发行版。
3) 拉镜像超时/证书错误
处理:优先检查代理/公司网络策略;若使用镜像加速,确认镜像地址可用且是 HTTPS;必要时切换网络后再试。
建议:用 docker compose 管理项目;空间不足时可先查看占用:
docker system df清理未使用资源(谨慎):
docker system prune -a