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

news2025/3/17 11:21:19

一、步骤说明

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