Operations 3 min read

Configuring Docker Registry Mirrors in China to Overcome Image Pull Failures

This article explains how to resolve Docker image pull failures in China by editing the daemon.json file to add accessible domestic registry mirrors, providing step‑by‑step instructions and a ready‑to‑use mirror list for developers and operators.

IT Services Circle
IT Services Circle
IT Services Circle
Configuring Docker Registry Mirrors in China to Overcome Image Pull Failures

During a holiday CTF preparation, the author attempted to deploy the open‑source CTFd platform using Docker but repeatedly failed to pull required images due to the Great Firewall restricting access to foreign Docker registries.

Although many Chinese organizations provide free Docker mirror services (e.g., Alibaba Cloud, Tsinghua University, University of Science and Technology of China), none of the tested mirrors worked at first, leading to confusion.

After extensive trial and error, a functional mirror list was discovered, allowing the Docker environment to be set up successfully. The author then shares the currently usable mirror addresses for others facing similar issues.

To apply these mirrors, edit the Docker daemon configuration file /etc/docker/daemon.json (create it if it does not exist) and add the following JSON content:

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://noohub.ru",
    "https://huecker.io",
    "https://dockerhub.timeweb.cloud"
  ]
}

After saving the file, restart the Docker service and retry pulling images; the mirrors should now work. The author notes that these addresses might be blocked in the future, so users should use them while they remain accessible.

Dockeroperationscontainertutorialdaemon.jsonregistry-mirrors
IT Services Circle
Written by

IT Services Circle

Delivering cutting-edge internet insights and practical learning resources. We're a passionate and principled IT media platform.

0 followers
Reader feedback

How this landed with the community

Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.