本文适用于 macOS 用户，演示如何正版安装、镜像加速、代理配置三步到位，保证后续
docker pull飞快。
1. 官网下载安装包
- 打开 Docker 官网
- 顶部导航 Download Docker Desktop for Mac
- 下载完成后双击
Docker.dmg，拖拽到Applications完成安装 - 首次启动会提示授权，按引导完成即可(如没有账号可跳过登陆)
Apple Silicon（M1/M2/M3）与 Intel Mac 都提供对应版本，官网会自动识别。
2. 配置国内镜像源（提速神器）
打开 Docker Desktop → Settings → Docker Engine，把下面 JSON 整段替换，点击 Apply & Restart。
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"dns": ["8.8.8.8", "1.1.1.1"],
"experimental": false,
"features": {
"buildkit": true
},
"registry-mirrors": [
"https://dockerpull.com",
"https://docker.1ms.run"
]
}
3. 配置代理（可选，如果配置了镜像源仍然拉取不了镜像）
- 可以访问镜像源（ docker.1ms.run ）
- 可以访问vpn地址，代理已运行（http://127.0.0.1:10844），端口要换成自己的vpn端口
- 可访问docker hub（hub.docker.com）
如果仍拉取不了镜像源需要代理，再补一步：
- Docker Desktop → Settings → Resources → Proxies
- 勾选 Manual proxy configuration 并填写：
| 协议 | 地址 |
|---|---|
| Web Server (HTTP) | http://127.0.0.1:10844 |
| Secure Web Server (HTTPS) | http://127.0.0.1:10844 |
端口
10844仅为示例，请换成本地代理工具（Clash、V2Ray、Surge…）实际监听的端口。
注意：更改完点击右下角的应用，然后重启docker
4. 验证是否成功
docker info | grep -i registry
看到 https://dockerpull.com 和 https://docker.1ms.run 即镜像加速生效。
再跑个 hello-world：
docker run --rm hello-world
若出现 “Hello from Docker!” 字样，恭喜安装完成！
5. 常见 Tips
- Apple Silicon 无法启动？
打开 “系统设置 → 隐私与安全” 允许 Docker 运行，或升级到最新 macOS。 - 镜像仍超时？
检查代理是否填写正确，或者临时切换网络（手机热点）。 - 磁盘占用大？
在 Settings → Resources 里调低 Disk image size，或定期docker system prune -a。
6.总结建议
| 排查项 | 操作建议 |
|---|---|
| 镜像源配置 | 使用 Docker Desktop 设置国内镜像源，不要改 daemon.json |
| VPN代理 | 在 Docker Desktop 中配置 HTTP/HTTPS 代理 |
| DNS问题 | 设置 DNS 为 8.8.8.8 |
| 镜像是否存在 | 用浏览器访问镜像仓库确认 |
| 网络连通性 | 用 curl 测试 Docker Hub 是否可达 |
| 清理缓存 | docker system prune -a |
祝你开发愉快，一键起飞！
