解决 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:

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

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

三、问题排查

1 配置文件语法错误

• 如果重启 Docker 失败，可能是 JSON 格式错误。使用在线 JSON 校验工具（如 ）检查配置文件。
• 示例正确格式： { “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 配置镜像加速器。如果遇到问题，建议优先检查配置文件语法、镜像源地址的有效性以及系统网络连接。