Mac上Docker拉取镜像卡顿、超时或极慢,是因直连海外Docker Hub导致TLS握手失败或链路不稳定;必须配置国内镜像源,推荐通过Docker Desktop图形界面在Settings→Docker Engine中填入实测可用地址如https://docker.xuanyuan.me等JSON数组并Apply & Restart生效。

Mac上拉取Docker镜像时卡在Waiting状态、超时中断或速度低于100KB/s,说明Docker正在直连海外Docker Hub,而当前网络链路无法稳定完成TLS握手与分层数据传输。必须通过配置国内镜像加速源,让请求转向境内缓存节点。
通过Docker Desktop图形界面配置(推荐新手)
这一步操作起来很简单,直接在菜单栏点几下就能完成,无需接触任何配置文件。
第一步:点击屏幕右上角菜单栏中的 Docker 图标 → 选择 Settings(设置)。
第二步:在左侧边栏中点击 Docker Engine 选项卡,右侧会显示一个JSON格式的编辑框。
第三步:将原有内容全部清空,粘贴以下实测可用的镜像源列表(2026年11月持续可用):
{ "registry-mirrors": ["https://docker.xuanyuan.me", "https://ccr.ccs.tencentyun.com", "https://docker.m.daocloud.io"] }
第四步:重点检查括号是否成对、逗号是否遗漏、双引号是否闭合——【JSON语法错误会导致Apply & Restart按钮置灰且无提示】。
第五步:点击右下角 Apply & Restart,等待Docker Desktop自动重启完成。
手动编辑daemon.json文件(适合需同步配置或脚本化部署)
该方法绕过图形界面,直接写入配置文件,适用于多台Mac批量部署或CI/CD环境预配置。
打开终端,执行以下命令定位并创建配置文件:
mkdir -p ~/Library/Containers/com.docker.docker/Data/docker-daemon.json
用VS Code或nano打开该文件:
code ~/Library/Containers/com.docker.docker/Data/docker-daemon.json
写入最小有效结构(仅含镜像源):
{ "registry-mirrors": ["https://docker.xuanyuan.me"] }
【注意:Docker Desktop不会监听此文件变更,保存后仍需进入Settings → Docker Engine → Apply & Restart才能生效】
验证镜像源是否生效
终端执行:
docker info | grep -A 5 "Registry Mirrors"
若输出中包含你配置的任一域名(如 docker.xuanyuan.me),说明已成功启用。
再执行一次真实拉取测试:
docker pull hello-world
观察终端输出——如果看到类似 Pulling from library/hello-world 且进度条持续前进,而非卡在 Waiting 或报 i/o timeout,即为配置完成。











