Docker Desktop 安装与镜像加速:Windows 11/macOS 从零到能拉镜像(含常见报错)

适用范围与准备

适用:Windows 11(推荐 WSL2 后端)与 macOS(Intel/Apple Silicon)。目标:安装完成后能执行 docker run hello-world 并正常拉取镜像。

准备:稳定网络;管理员权限;Windows 需开启虚拟化(BIOS/UEFI)与 WSL2。

Windows 11 安装(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)。

macOS 安装(Intel / Apple Silicon)

第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

用户评论 (0)

登录后参与讨论

立即登录 注册账号

暂无评论,快来抢沙发吧~

操作成功