一、步骤说明
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年更新）
根据知识库信息，以下镜像源地址较为稳定（建议优先选择）：
| 镜像源名称 | 地址 |
|---|---|
| 中国科学技术大学 | https://docker.mirrors.ustc.edu.cn |
| 网易云加速器 | http://hub-mirror.c.163.com |
| 阿里云官方加速器 | https://registry.docker-cn.com |
| 腾讯云加速器 | https://mirror.ccs.tencentyun.com |
三、问题排查
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 配置镜像加速器。如果遇到问题，建议优先检查配置文件语法、镜像源地址的有效性以及系统网络连接。
