跳至主要內容

Docker 镜像源配置指南

GGBOND2025/11/17大约 2 分钟开发工具

Docker 镜像源配置

1. 为什么要配置 Docker 镜像源

Docker 默认从 Docker Hub 拉取镜像，在中国大陆地区访问 Docker Hub 速度较慢甚至无法访问。通过配置国内镜像源可以显著提升镜像下载速度。

2. 常用 Docker 镜像源

2.1 官方中国区镜像源

https://registry.docker-cn.com

2.2 第三方镜像源

  • 网易云镜像源：https://hub-mirror.c.163.com
  • 中国科学技术大学镜像源：https://docker.mirrors.ustc.edu.cn
  • Docker 官方中国区镜像源：https://registry.docker-cn.com
  • 阿里云镜像源：需要注册阿里云账号获取个人专属地址

3. 配置方法

3.1 方法一：修改 Docker 配置文件（推荐）

1. Linux 系统配置
  1. 创建或编辑 Docker 配置文件：
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF
  1. 重启 Docker 服务：
sudo systemctl restart docker

5. 验证配置

5.1 检查配置文件

cat /etc/docker/daemon.json

5.2 查看 Docker 信息

docker info

在输出中找到 "Registry Mirrors:" 部分，确认配置的镜像源是否生效。

6. 常见问题

6.1 配置后镜像拉取仍然慢

  1. 检查配置是否正确：
docker info | grep -A 10 "Registry Mirrors"
  1. 重启 Docker 服务：
sudo systemctl restart docker

6.2 某些镜像仍然无法拉取

某些镜像可能在镜像源中不存在，可以使用以下方法：

  1. 使用官方源拉取：
docker pull --platform linux/amd64 镜像名:标签
  1. 使用代理或 VPN 访问官方源

7. 最佳实践

  1. 多镜像源配置：建议配置多个镜像源，提高可用性
  2. 定期更新镜像源：某些镜像源可能会失效，需要及时更新
  3. 特殊镜像处理：对于企业内部镜像或私有仓库，需要额外配置
  4. 网络环境考虑：根据实际网络环境选择最合适的镜像源

8. 配置文件示例

完整的 Docker 配置文件示例：

{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn"
  ],
  "insecure-registries": ["私有仓库地址"],
  "debug": false,
  "experimental": false
}

通过以上配置，可以显著提升 Docker 镜像拉取速度，改善开发体验。

Copyright © 2025 GGBOND