更新时间:2025-07-02 GMT+08:00
分享

设置镜像加速器

由于运营商网络原因,会导致您拉取第三方镜像仓库的镜像(例如Docker Hub)变慢甚至下载失败。华为云容器镜像服务提供了镜像下载加速功能,对部分常用的开源镜像下载进行加速。

  • SWR镜像加速器是面向个人开发者的服务,仅限于支持个人开发场景,不允许有再次封装或商业用途。
  • 面向生产环境使用场景,为避免Docker访问网络问题导致的镜像拉取失败,建议您在生产环境中慎重考虑对Docker Hub容器镜像的依赖,将需要的镜像从Docker Hub同步到SWR私有仓库使用。
  • 仅支持通过镜像加速器拉取常用的开源镜像,镜像加速器无法保证一定拉取到所有的镜像版本,建议您将需要的镜像同步到SWR私有仓库使用。
  • 暂不支持containerd容器引擎设置镜像加速器。

约束与限制

  • 仅限华为云用户在华为云上的容器产品中使用该镜像加速能力。
  • 仅支持通过镜像加速器拉取常用的开源镜像,不保证能够加速所有镜像,生产环境请谨慎使用。
  • 构建镜像的客户端所安装的容器引擎(Docker)版本必须为18.06(包含)到24.0.9(包含)之间的。
  • "华南-广州"、"华北-北京四"、"华东-上海一"和"西南-贵阳一"区域支持该功能。

操作步骤

  1. 登录容器镜像服务控制台
  2. 在左侧导航栏选择“镜像资源 > 镜像中心”

    在使用镜像中心功能前,请确保您的当前区域支持镜像中心功能,详情请见镜像中心约束与限制

  3. 单击“镜像加速器”,在弹框中找到“加速器地址”,单击,将加速器地址复制到剪切板。

    图1 镜像加速器地址

  4. 以root用户登录容器引擎所在的虚拟机。
  5. 修改“/etc/docker/daemon.json”文件(如果没有,可以手动创建),在该文件内添加如下内容:

    vi /etc/docker/daemon.json

    {
        "registry-mirrors": ["加速器地址"]
    }

    其中,加速器地址请替换为3中获取的镜像加速器地址。

    “Esc”,输入:wq保存并退出。

  6. 配置完成后,执行systemctl restart docker重启容器引擎。

    如果重启失败,则检查操作系统其他位置(如:/etc/sysconfig/docker、/etc/default/docker)是否配置了registry-mirrors参数,删除此参数并重启容器引擎即可。

  7. 执行docker info,当Registry Mirrors字段的地址为加速器的地址时,说明加速器已经配置成功。

    图2 Registry Mirrors信息

常见问题

设置镜像加速器后还是拉取失败,可能原因:

相关文档