Docker镜像加速与代理配置指南

MX Lv3

Docker镜像加速与代理配置

Docker在国内使用时,由于网络原因,拉取官方镜像可能会很慢。本文提供了一些常用的镜像加速地址和代理配置方法,帮助你提升Docker的使用体验。

配置镜像加速器

在Linux系统中,编辑或创建/etc/docker/daemon.json文件,添加以下内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"registry-mirrors": [
"https://docker.m.daocloud.io/",
"https://docker.imgdb.de/",
"https://docker-0.unsee.tech/",
"https://docker.hlmirror.com/",
"https://docker.1ms.run/",
"https://func.ink/",
"https://lispy.org/"
],
"proxies": {
"http-proxy": "http://127.0.0.1:2345",
"https-proxy": "http://127.0.0.1:2345",
"no-proxy": "*.test.example.com,.example.org,127.0.0.0/8"
}
}

镜像加速器说明

以上配置中包含了多个镜像加速器地址,按照顺序尝试使用:

  • DaoCloud镜像https://docker.m.daocloud.io/ - 国内知名云服务提供商DaoCloud提供的Docker镜像加速
  • ImgDB德国镜像https://docker.imgdb.de/ - 德国服务器,欧洲地区连接稳定
  • Unsee.tech镜像https://docker-0.unsee.tech/ - 另一个可选的国际镜像源
  • HLMirror镜像https://docker.hlmirror.com/ - 国内高速镜像
  • 1ms.run镜像https://docker.1ms.run/ - 速度较快的镜像源
  • Func.ink镜像https://func.ink/ - 稳定可靠的镜像源
  • Lispy.org镜像https://lispy.org/ - 备选镜像源

配置多个镜像源可以提高可用性,当某个镜像源不可用时,Docker会自动尝试下一个。

代理配置说明

如果你的网络环境需要通过代理服务器访问互联网,可以在daemon.json中配置代理设置:

  • HTTP代理http-proxy 字段设置HTTP协议的代理服务器
  • HTTPS代理https-proxy 字段设置HTTPS协议的代理服务器
  • 不使用代理的地址no-proxy 字段设置不需要通过代理访问的地址列表

在示例中,我们设置了:

  • HTTP和HTTPS代理均为本地代理服务器:http://127.0.0.1:2345
  • 不使用代理的地址包括:*.test.example.com.example.org127.0.0.0/8网段

不同系统的配置路径

根据不同的操作系统,Docker配置文件的位置有所不同:

  • Linux/etc/docker/daemon.json
  • macOS~/.docker/daemon.json或通过Docker Desktop的UI界面配置
  • Windows%programdata%\docker\config\daemon.json或通过Docker Desktop的UI界面配置

应用配置

配置完成后,需要重启Docker服务以应用更改:

Linux系统(使用systemd)

1
2
sudo systemctl daemon-reload
sudo systemctl restart docker

Linux系统(使用service)

1
sudo service docker restart

macOS和Windows

在Docker Desktop中,点击右上角的重启按钮或在系统托盘图标上右键选择”Restart”。

验证配置

重启Docker服务后,可以通过以下命令验证配置是否生效:

1
docker info

在输出信息中,查找Registry Mirrors部分,应该能看到已配置的镜像加速器地址。

也可以通过拉取一个小镜像来测试速度:

1
docker pull hello-world

常见问题

  1. 配置后无法连接Docker Hub

    • 检查代理服务器是否正常工作
    • 确认代理地址和端口是否正确
    • 尝试暂时禁用代理配置进行测试
  2. 镜像拉取仍然很慢

    • 尝试使用不同的镜像加速器
    • 检查网络连接是否稳定
    • 考虑使用更靠近你地理位置的镜像源
  3. Docker服务无法启动

    • 检查daemon.json文件格式是否正确,确保是有效的JSON格式
    • 查看Docker日志以获取更详细的错误信息:journalctl -u docker.service

参考资料

  • 标题: Docker镜像加速与代理配置指南
  • 作者: MX
  • 创建于 : 2025-07-14 15:46:45
  • 更新于 : 2025-09-24 11:41:02
  • 链接: https://www.convolution.fun/2025/07/14/202507141546/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论