官方镜像加速

配置Docker运行时镜像加速器

您可以先使用docker --version查看Docker的版本，然后根据实际情况选择不同的配置方式。

新版本Docker（1.10及以上）

创建并编辑/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）

  在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在启动时指定默认的配置文件路径为/etc/containerd/config.toml，后续所有镜像仓库相关的配置可以在该文件中进行热加载，无需重启Containerd。如果您使用不同的路径，可以根据实际情况进行调整。

1. 确保配置文件包含config_path。

   执行以下命令，确认默认配置文件中是否存在config_path 配置（例如"/etc/containerd/cert.d"）。

   cat /etc/containerd/config.toml |grep config_path -C 5

   如果不存在，您可以在默认配置文件中添加以下配置。

   说明

   若已有[plugins."io.containerd.grpc.v1.cri".registry]，则在下面只需添加config_path，注意缩进。若没有，则可以在任意地方写入。

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

2. 检查mirror相关配置。

   检查/etc/containerd/config.toml配置文件中是否存在与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"]

3. 重启containerd（可选）。

   如果默认配置文件发生更改，则可执行以下命令，重启Containerd。

   systemctl restart containerd

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

   journalctl -u containerd

4. 创建镜像加速器配置文件。

   使用以下内容在指定的config_path路径下创建docker.io/hosts.toml文件，创建后的文件路径为/etc/containerd/certs.d/docker.io/hosts.toml。

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

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