镜像加速器

官方镜像加速

由于运营商网络原因，会导致您拉取Docker Hub镜像变慢，甚至下载失败。为此，阿里云容器镜像服务ACR提供了官方的镜像加速器，从而加速官方镜像的下载。

根据Docker公司政策，2020年11月01日起将逐步向Docker Hub匿名和免费用户实施速率和拉取请求次数限制。ACR镜像加速器无法保证一定拉取到latest最新的镜像版本，建议您指定镜像版本拉取。关于Docker Hub拉取请求次数限制的详细介绍，请参见Download rate limit。

获取镜像加速器地址

ACR会为每一个账号（阿里云账号或RAM用户）生成一个镜像加速器地址，配置镜像加速器前，您需要获取镜像加速器地址。

登录容器镜像服务控制台，在左侧导航栏选择镜像工具 > 镜像加速器，在镜像加速器页面获取加速器地址。

例如：
加速器地址：[系统分配前缀].mirror.aliyuncs.com    

配置Docker运行时镜像加速器

在不同的操作系统下，配置加速器的方式略有不同，下文将介绍主要操作系统的配置方法。

当您的Docker版本较新时

当您下载安装的Docker Version不低于1.10时，建议通过daemon config进行配置。使用配置文件/etc/docker/daemon.json（没有时新建该文件）。

 

{
    "registry-mirrors": ["<镜像加速器地址>"]
}            

然后重启Docker Daemon。

当您的Docker版本较旧时

您需要根据不同的操作系统修改对应的配置文件。

Ubuntu 12.04 - 14.04

Ubuntu的配置文件的位置在/etc/default/docker目录下。您只需要在这个配置文件中添加加速器的配置项，重启Docker即可。

 

echo "DOCKER_OPTS=\"\$DOCKER_OPTS --registry-mirror=<your accelerate address>\"" | sudo tee -a /etc/default/docker
sudo service docker restart            

Ubuntu 15.04 - 15.10

Ubuntu的配置文件的位置在/etc/systemd/system/docker.service.d/目录下。在这个目录下创建任意的*.conf文件即可作为配置文件。然后在这个配置文件中添加加速器的配置项，之后重启Docker即可。

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo tee /etc/systemd/system/docker.service.d/mirror.conf <<-'EOF'
[Service]
ExecStart=
ExecStart=/usr/bin/docker daemon -H fd:// --registry-mirror=<your accelerate address>
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker            

CentOS 7

CentOS的配置方式略微复杂，需要先将默认的配置文件（/lib/systemd/system/docker.service）复制到/etc/systemd/system/docker.service。然后再将加速器地址添加到配置文件的启动命令中，之后重启Docker即可。

 

sudo cp -n /lib/systemd/system/docker.service /etc/systemd/system/docker.service
sudo sed -i "s|ExecStart=/usr/bin/docker daemon|ExecStart=/usr/bin/docker daemon --registry-mirror=<your accelerate address>|g" /etc/systemd/system/docker.service
sudo sed -i "s|ExecStart=/usr/bin/dockerd|ExecStart=/usr/bin/dockerd --registry-mirror=<your accelerate address>|g" /etc/systemd/system/docker.service
sudo systemctl daemon-reload
sudo service docker restart            

• Redhat 7

  Red Hat 7配置加速器，需要编辑/etc/sysconfig/docker配置文件。在OPTIONS配置项中添加加速器配置--registry-mirror=<your accelerate address>。最后执行sudo service docker restart命令以重启Docker Daemon。

• Redhat 6/CentOS 6

  在这两个系统上无法直接安装Docker，需要升级内核。

  配置加速器时需要编辑/etc/sysconfig/docker配置文件。 在other_args配置项中添加加速器配置--registry-mirror=<your accelerate address>。最后执行sudo service docker restart命令以重启Docker Daemon。

• Docker Toolbox

  在Windows、Mac系统上使用Docker Toolbox的话，推荐做法是在创建Linux虚拟机的时候，就将加速器的地址配置进去。

 

docker-machine create --engine-registry-mirror=<your accelerate address> -d virtualbox default
docker-machine env default
eval "$(docker-machine env default)"
docker info            

如果您已经通过docker-machine创建了虚拟机的话，则需要通过登录该虚拟机来修改配置。

1. 执行docker-machine ssh <machine-name>命令以登录虚拟机。

2. 修改/var/lib/boot2docker/profile文件，将--registry-mirror=<your accelerate address>添加到EXTRA_ARGS中。

3. 执行sudo /etc/init.d/docker restart命令以重启Docker服务。

 

配置Containerd运行时镜像加速器

Containerd通过在启动时指定一个配置文件夹，使后续所有镜像仓库相关的配置都可以在里面热加载，无需重启Containerd。

1. 1. 如果/etc/containerd/config.toml配置文件中已包含config_path 配置（例如"/etc/containerd/cert.d"），则无需执行此步骤；如果不存在，您可以在配置文件中添加以下config_path并重启Containerd使更改生效。

       

      config_path = "/etc/containerd/certs.d"

      说明

      /etc/containerd/config.toml非默认路径，您可以根据实际使用情况进行调整。

      1. 若已有plugins."io.containerd.grpc.v1.cri".registry，则在下面添加一行，注意要有Indent。若没有，则可以在任意地方写入。

          

         [plugins."io.containerd.grpc.v1.cri".registry]
           config_path = "/etc/containerd/certs.d"

      2. 之后需要检查配置文件中是否有原有mirror相关的配置，如下：

          

         [plugins."io.containerd.grpc.v1.cri".registry.mirrors]
           [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
             endpoint = ["https://registry-1.docker.io"]

         若有原有mirror相关的配置，则需要清理。

      3. 执行systemctl restart containerd重启Containerd。

      4. 若启动失败，执行journalctl -u containerd检查为何失败，通常是配置文件仍有冲突导致，您可以依据报错做相应调整。

    2在步骤一中指定的config_path路径中创建docker.io/hosts.toml文件。

   在文件中写入如下配置。

    

   server = "https://registry-1.docker.io"
   
   [host."$(镜像加速器地址，如https://xxx.mirror.aliyuncs.com)"]
     capabilities = ["pull", "resolve", "push"]

2. 拉取Docker镜像验证加速是否生效。如未生效，请参见Reference。