解决 openeuler 系统 docker 下载慢，docker 镜像加速

一、步骤说明

1. 编辑 Docker 配置文件

Docker 的镜像源配置文件路径为 /etc/docker/daemon.json。如果该文件不存在，则需要先创建目录和文件。

# 创建目录（如果不存在）
sudo mkdir -p /etc/docker

# 编辑配置文件（使用 nano 或 vi）
sudo nano /etc/docker/daemon.json

2. 添加镜像加速器地址

在 daemon.json 文件中添加 registry-mirrors 配置项，选择以下 可用的国内镜像源（推荐选择 1-3 个稳定的源）：

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",  # 中国科学技术大学（稳定）
    "http://hub-mirror.c.163.com",         # 网易云加速（HTTP协议）
    "https://registry.docker-cn.com",      # 阿里云加速器（官方推荐）
    "https://mirror.ccs.tencentyun.com"    # 腾讯云加速器
  ]
}

注意：

• 如果多个镜像源地址不可用，可以只保留一个有效的源。
• 部分镜像源可能需要 HTTPS 或 HTTP 协议，需根据实际情况选择。

3. 保存并退出编辑器

• 如果使用 nano，按 Ctrl+O 保存，Ctrl+X 退出。
• 如果使用 vi，输入 :wq 保存退出。

4. 重启 Docker 服务

sudo systemctl daemon-reload
sudo systemctl restart docker

5. 验证配置是否生效

docker info | grep "Registry Mirrors"

如果配置成功，输出应包含你添加的镜像源地址，例如：

Registry Mirrors:
 https://docker.mirrors.ustc.edu.cn/
 http://hub-mirror.c.163.com/

二、常见镜像源地址（2025年更新）

根据知识库信息，以下镜像源地址较为稳定（建议优先选择）：

三、问题排查

1. 配置文件语法错误

• 如果重启 Docker 失败，可能是 JSON 格式错误。使用在线 JSON 校验工具（如 jsonlint.com）检查配置文件。
• 示例正确格式：

  {
    "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
  }
  

2. 镜像源失效

• 如果拉取镜像仍失败，尝试更换其他镜像源地址（如 https://hub.xdark.top 或 https://docker.1panel.live，需根据网络环境测试）。

3. 系统网络问题

• 确保 openEuler 的网络连接正常：

  ping docker.mirrors.ustc.edu.cn
  

四、补充说明

1. 更换 openEuler 系统源（可选）

如果系统本身源不可用，需先配置 openEuler 的官方源（参考知识库条目[3]、[4]）：

# 编辑 BaseOS 源文件（以 x86_64 架构为例）
sudo vi /etc/yum.repos.d/BaseOS.repo

# 添加以下内容：
[BaseOS]
name=BaseOS
baseurl=https://repo.huaweicloud.com/openeuler/openEuler-20.03-LTS/OS/x86_64/
enabled=1
gpgcheck=1
gpgkey=https://repo.huaweicloud.com/openeuler/openEuler-20.03-LTS/OS/x86_64/RPM-GPG-KEY-openEuler

2. 清理 Docker 缓存

如果之前拉取的镜像有错误，可以清理缓存：

docker system prune -a

五、总结

通过以上步骤，你可以成功为 openEuler 系统上的 Docker 配置镜像加速器。如果遇到问题，建议优先检查配置文件语法、镜像源地址的有效性以及系统网络连接。