Docker 镜像源配置指南

在使用 Docker 过程中，由于众所周知的原因，直接从 Docker Hub 拉取镜像可能会遇到速度慢、超时甚至无法连接的问题。为了提高镜像拉取效率，我们可以配置国内的 Docker 镜像加速器（即镜像源）。本文将详细介绍如何为 Docker 配置镜像源，并列出常用的国内镜像加速地址。

博主博客

• https://blog.uso6.com
• https://blog.csdn.net/dxk539687357

为什么需要配置镜像源？

Docker 默认从官方的 Docker Hub 拉取镜像，服务器位于国外，对于国内用户来说网络延迟较高，拉取大镜像（如 Ubuntu、Nginx 等）时耗时很长，甚至可能失败。配置国内镜像源后，Docker 会优先从加速器地址拉取镜像，这些镜像缓存了常用镜像，下载速度能提升数倍。

配置方法

1. 编辑 Docker 配置文件

Docker 的配置文件通常位于 /etc/docker/daemon.json。如果该文件不存在，可以手动创建。使用文本编辑器（如 vim）打开：

sudo vim /etc/docker/daemon.json

2. 添加镜像源地址

在文件中写入以下内容（JSON 格式），将 registry-mirrors 字段设置为一个数组，包含你希望使用的镜像源 URL。以下是一个示例，包含了多个国内常用的加速地址：

{
  "registry-mirrors": [
    "https://pee6w651.mirror.aliyuncs.com",
    "https://docker.m.daocloud.io",
    "https://docker.nju.edu.cn",
    "https://xuanyuan.cloud"
  ]
}

注意：镜像源地址可能会有变动或失效，建议定期检查更新。如果某个地址不可用，可以将其移除或替换。

3. 重新加载配置并重启 Docker

保存文件后，需要让 Docker 重新加载配置并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

4. 验证配置是否生效

运行以下命令查看 Docker 信息，确认镜像源配置已加载：

sudo docker info

在输出内容中，找到 Registry Mirrors 字段，如果显示了刚才配置的地址列表，则说明配置成功。例如：

Registry Mirrors:
  https://pee6w651.mirror.aliyuncs.com/
  https://docker.m.daocloud.io/
  https://docker.nju.edu.cn/
  https://xuanyuan.cloud/

常用国内镜像源推荐

除了上述示例中的地址，以下也是国内稳定且常用的 Docker 镜像加速器（排名不分先后）：

说明：阿里云需要注册后获取专属加速地址，其他大多为公共地址可直接使用。建议配置多个地址作为备用，当一个镜像源不可用时，Docker 会自动尝试下一个。

可能遇到的问题及解决

1. 配置后拉取镜像仍慢或失败

• 检查 daemon.json 的 JSON 格式是否正确（如缺少逗号、括号不匹配等）。
• 尝试更换其他镜像源地址，或仅保留一两个稳定的地址。
• 确保网络能够正常访问镜像源服务器（可 curl 测试）。

2. Docker 服务重启失败

• 查看错误日志：journalctl -u docker -f
• 检查配置文件是否有语法错误，可以运行 dockerd --validate 验证（需要停止 Docker 服务后执行）。

3. 镜像源地址失效

• 部分公共镜像源可能因政策或维护而关闭，需关注社区动态，及时更新地址。

总结

通过配置国内镜像源，可以显著提升 Docker 镜像的拉取速度，改善开发体验。只需编辑 /etc/docker/daemon.json，添加加速器地址，重启 Docker 即可。本文提供了详细的步骤和常用镜像源列表，希望对您有所帮助。如果您在使用过程中遇到其他问题，欢迎在评论区交流。