配置多个国内镜像源可提升Docker拉取稳定性,Linux通过编辑/etc/docker/daemon.json并重启服务,macOS/Windows使用Docker Desktop图形界面设置,验证用docker info | grep "Registry Mirrors",临时可用--registry-mirror参数。

安装完 Docker 后,配置多个国内镜像源是提升拉取稳定性最直接有效的方式。Docker 支持在 daemon.json 中声明多个镜像地址,它会按顺序尝试,任一可用即可成功拉取,避免单点失效导致失败。
Linux 系统:编辑 daemon.json 并重启服务
这是最常用且推荐的方式,适用于 Ubuntu、CentOS、Debian 等发行版。
- 创建或编辑配置文件:
sudo mkdir -p /etc/docker && sudo nano /etc/docker/daemon.json - 填入多个已验证有效的国内镜像源(2026 年 7 月实测可用):
{ "registry-mirrors": [ "https://docker.xuanyuan.me", "https://docker.1ms.run", "https://hub.rat.dev", "https://docker.hpcloud.cloud", "https://docker.m.daocloud.io", "https://docker.tbedu.top/" ] } - 保存退出(
Ctrl+O→ 回车 →Ctrl+X),然后重载并重启:sudo systemctl daemon-reload && sudo systemctl restart docker
macOS / Windows:通过 Docker Desktop 图形界面设置
无需命令行,适合新手或非 Linux 用户。
-
macOS:点击菜单栏 Docker 图标 → Preferences → Docker Engine → 在 JSON 编辑框中粘贴上述
registry-mirrors数组 → 点击 Apply & Restart - Windows:右键任务栏 Docker 图标 → Settings → Docker Engine → 同样填入数组 → Apply & Restart
验证是否生效
执行以下命令,确认输出中包含你配置的任意一个镜像地址:
docker info | grep "Registry Mirrors"
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境(极空间等),支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件,不暴露在代码中。
如果看到类似 Registry Mirrors: https://docker.1ms.run/ 的结果,说明配置已加载成功。也可用 docker pull alpine 实测拉取速度和成功率。
补充建议:临时拉取时指定镜像源(应急用)
当某次拉取失败或想绕过 daemon 配置快速测试某个源时,可直接加参数:
docker pull --registry-mirror=https://docker.1ms.run library/nginx:1.25
注意:该方式仅对本次命令生效,不改变全局配置,适合调试或 CI 中临时切换。

















