最后验证日期：2025-12-19
维护状态：长期维护，持续更新可用地址

一、背景与原理

由于 Docker Hub 官方镜像仓库在国内访问速度不稳定，配置镜像加速已成为开发环境的标配。通过配置 registry-mirrors，Docker 客户端会优先从加速节点拉取镜像，显著提升 docker pull 速度和成功率。

二、配置方法详解

2.1 单加速器配置

sudo vim /etc/docker/daemon.json
{
  "registry-mirrors": [
    "https://dockercf.jsdelivr.fyi"
  ]
}

2.2 多加速器配置（推荐）

sudo vim /etc/docker/daemon.json
{
  "registry-mirrors": [
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://docker.1panel.live",
    "https://docker.zhai.cm",
    "https://a.ussh.net"
  ]
}

配置要点：

  • 地址按优先级排序，Docker 会依次尝试

  • JSON 格式必须合法，最后一项不能有逗号

  • 地址末尾不要加 /

2.3 应用配置

# 重新加载配置
sudo systemctl daemon-reload

# 重启 Docker 服务
sudo systemctl restart docker

# 验证状态
sudo systemctl status docker

三、2025年可用镜像加速列表

序号

镜像加速地址

状态

备注

1

https://dockercf.jsdelivr.fyi

✅ 正常

推荐首选，CF 加速

2

https://docker.jsdelivr.fyi

✅ 正常

推荐次选

3

https://docker.1panel.live

✅ 正常

1Panel 维护

4

https://docker.zhai.cm

✅ 正常

个人维护，稳定

5

https://a.ussh.net

✅ 正常

小众但稳定

6

https://docker.sunzishaokao.com

✅ 正常

烧烤大哥维护

7

https://docker.xuanyuan.me

✅ 正常

响应快

8

https://lispy.org

✅ 正常

个人站点

9

https://docker.yomansunter.com

✅ 正常

海外节点

10

https://docker-mirror.aigc2d.com

✅ 正常

AIGC 方向

11

https://666860.xyz

✅ 正常

数字域名

12

https://docker-0.unsee.tech

✅ 正常

技术站

13

https://docker.hlmirror.com

✅ 正常

华为云镜像

14

https://dockerpull.pw

✅ 正常

简短易记

15

https://hub3.nat.tf

✅ 正常

NAT 穿透方案

16

https://hub.amingg.com

✅ 正常

Amingg 维护

17

https://cr.laoyou.ip-ddns.com

✅ 正常

动态 DNS

18

https://docker.amingg.com

✅ 正常

Amingg 备用

19

https://hub.1panel.dev

✅ 正常

1Panel 开发版

20

https://docker-registry.nmqu.com

✅ 正常

内蒙古大学

21

https://docker.367231.xyz

✅ 正常

个人站点

四、验证与测试

4.1 查看当前配置

sudo docker info | grep "Registry Mirrors"

预期输出：

Registry Mirrors:
 https://dockercf.jsdelivr.fyi/
 https://docker.jsdelivr.fyi/

4.2 测速对比

# 测试拉取速度（限时 30 秒）
time docker pull nginx:alpine

# 清理测试镜像
docker rmi nginx:alpine

健康指标：配置成功后，拉取常见镜像（如 nginx, ubuntu）应能在 10-30 秒内完成。

4.3 单地址测试

# 临时指定镜像源测试（不影响配置）
docker pull --registry-mirror=https://dockercf.jsdelivr.fyi nginx:alpine

五、故障排查指南

5.1 配置不生效

# 检查配置文件语法
cat /etc/docker/daemon.json | python3 -m json.tool

# 查看 Docker 日志
sudo journalctl -u docker -f

常见错误：

  • JSON 格式错误（多余逗号、引号不匹配）

  • 地址无法访问（防火墙/网络问题）

  • 未重启 Docker 服务

5.2 加速地址失效

# 快速测试地址可用性
curl -s https://dockercf.jsdelivr.fyi/v2/ | head -c 20

正常响应：应返回 {"errors":[{"code":"UNAUTHORIZED"...

5.3 回退方案

如果所有加速地址均失效，临时方案：

# 使用代理（如有）
docker pull --proxy=http://127.0.0.1:7890 nginx:alpine

# 改用国内镜像源（部分镜像有同步）
docker pull registry.cn-hangzhou.aliyuncs.com/library/nginx:alpine

六、个人实践建议

  1. 分层配置策略：

    • 开发环境：配置 3-5 个地址，保证最高可用性

    • CI/CD 环境：固定 1-2 个最稳定地址，避免网络波动

自动检测脚本：

# 添加到 ~/.bashrc 或 ~/.zshrc
alias docker-pull='docker pull --registry-mirror=https://dockercf.jsdelivr.fyi'

  1. 定期维护：

    • 每月首周测试所有地址可用性

    • 关注 docker.zhai.cm 等个人维护站点的公告

    • 保留 2-3 个备用地址在注释中

  2. 企业级建议：

    • 搭建私有镜像仓库（Harbor/Nexus）

    • 使用 pull-through cache 模式

    • 内网 DNS 解析加速地址

七、配置模板（一键复制）

{
  "registry-mirrors": [
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://docker.1panel.live",
    "https://docker.zhai.cm",
    "https://a.ussh.net"
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  },
  "exec-opts": ["native.cgroupdriver=systemd"],
  "storage-driver": "overlay2"
}

本笔记提供的 21 个地址经过 2025 年 12月验证，建议优先使用 前 5 个 作为主力，其余作为备用。

核心原则：多配几个地址不麻烦，但拉镜像失败时会非常痛苦。建议至少配置 3 个及以上。

反馈与更新：如果某个地址失效，欢迎在评论区反馈，我会持续更新维护。