How to Bypass Dockerhub Mirror Outages with Alternative Registries

Mirror Service Outage

Several Chinese university Docker mirror sites announced that they will stop providing Dockerhub image services from June 6, causing many users to experience failed image downloads.

Unavailable Mirror URLs

docker.mirrors.sjtug.sjtu.edu.cn

(Shanghai Jiao Tong University) docker.mirrors.ustc.edu.cn (University of Science and Technology of China)

Tested Unusable Accelerators

"https://mirror.ccs.tencentyun.com" (Tencent Cloud)

"https://registry.docker-cn.com" (Docker official China registry)

"http://hub-mirror.c.163.com" (NetEase Cloud)

"https://docker.nju.edu.cn" (Nanjing University)

Available Mirrors

Aliyun mirror: "https://vh3bm52y.mirror.aliyuncs.com" (tested working)

Configure Docker Daemon

Edit the Docker daemon configuration file /etc/docker/daemon.json and add multiple registry mirrors:

{
  "registry-mirrors": [
    "https://registry.cn-hangzhou.aliyuncs.com",
    "https://vh3bm52y.mirror.aliyuncs.com"
  ]
}

After saving the file, restart Docker to apply the changes:

systemctl restart docker

Conclusion

By configuring several mirror sources, Docker will automatically fall back to an alternative registry if one becomes unavailable, ensuring stable image downloads without needing to reinstall Docker or the operating system.