docker 镜像加速

⏱️最后更新: 2025/07/25

Docker 默认从 Docker Hub 拉取镜像, ，所以要配置镜像加速。

本文只针对 linux 进行配置说明。

1 创建配置文件

bash

sudo mkdir -p /etc/docker
sudo vim /etc/docker/daemon.json

2 添加镜像源

json

{
  "registry-mirrors": [
    "https://docker.xuanyuan.me" // 轩辕镜像源，高速节点
  ]
}

测试镜像源是否可用

bash

# 1. 直接拉取镜
sudo docker pull --registry-mirror=<镜像源地址> hello-world
sudo docker pull --registry-mirror=gcr.azk8s.cn hello-world
sudo docker pull nginx --registry-mirror=https://docker.mirrors.ustc.edu.cn
# 2.使用 curl 测试镜像源 API（部分镜像源支持）
# 如果返回 200 OK，说明镜像源正常；如果返回 404 或超时，则可能不可用。
curl -I https://docker.mirrors.ustc.edu.cn/v2/
# 3. 查看docker日志/引擎日志
# 如果日志中有 failed to pull 或 connection refused 等错误，说明镜像源可能有问题。
journalctl -u docker --no-pager -n 50
sudo docker info | grep -i registry
# 4. 使用 docker info 查看镜像源状态
# 如果镜像源出现在这里，说明 Docker 已正确加载配置，但仍需测试实际拉取是否正常。
sudo docker info | grep -A 10 "Registry Mirrors"

3 重启服务

bash

sudo systemctl daemon-reload
sudo systemctl restart docker

5 直接锁定镜像源拉取镜像

bash

sudo docker pull nginx --registry-mirror=https://docker.mirrors.ustc.edu.cn