Docker-Registry-Mirror China 2026: Pull-Timeout in 5 Minuten eingrenzen

Aktualisiert im Juni 2026 nach Prüfung der Docker-Hub-Nutzungs- und Pull-through-Cache-Dokumentation. 2026 geht es nicht um den einen perfekten Mirror, sondern um die richtige Wahl zwischen Community-Mirror, Docker-daemon-Proxy und privatem Cache. Eine leicht übersehene Änderung: Seit dem 1. April 2025 erzwingt Docker Hub Pull-Limits (10/Stunde pro IP unauthentifiziert, 100/Stunde mit kostenlosem Konto). Ist der Fehler also ein 429 statt eines Timeouts, führen Sie zuerst docker login aus, statt den Mirror zu wechseln.

Letzten Freitag um 15 Uhr starrte ich auf docker pull nginx:latest im Terminal – der Cursor blinkte zehn Minuten lang, dann kam ein rotes i/o timeout. Ehrlich gesagt war das nicht das erste Mal. Seit Juni wird das immer häufiger: Das Netzwerk wirkt normal, der Browser ist schnell – aber Docker-Images lassen sich nicht ziehen.

Ich habe online nach Tutorials gesucht. Aliyun- und NetEase-Mirror halfen trotz korrekter Konfiguration nicht. Später wurde klar: Am 6. Juni 2024 fielen in China nahezu alle Docker-Registry-Mirror aus – Aliyun, Tencent Cloud, Baidu Cloud und universitäre Mirror-Sites wurden eingestellt oder nur noch intern erreichbar.

Kennen Sie das? Tutorials aus 2023 versprechen die „perfekte Lösung für langsame Docker-Pulls“. Sie konfigurieren daemon.json, starten Docker neu, führen erneut docker pull aus – und wieder Timeout. Das frustriert.

Die gute Nachricht: Einige community-betriebene Mirror funktionieren noch – ich habe sie selbst getestet. In diesem Artikel erfahren Sie, welche Docker-Mirror im Dezember 2025 noch verfügbar sind, wie Sie daemon.json konfigurieren und wie Sie Probleme beheben. Los geht’s.

Warum sind Docker-Registry-Mirror in großem Umfang ausgefallen?

Bevor wir zur Lösung kommen, lohnt sich ein Blick auf die Ursache. Ihr Aliyun-Mirror hat nicht ohne Grund aufgehört zu funktionieren.

Der 6. Juni 2024 war ein Wendepunkt. An diesem Tag kündigten nahezu alle großen Docker-Hub-Mirror-Dienste in China Einstellung oder Einschränkung an. Aliyun, NetEase, Tencent Cloud, Baidu Cloud – fast alle kommerziellen Mirror fielen über Nacht aus. Auch Mirror der Nanjing University, Shanghai Jiao Tong University und USTC schlossen oder wurden auf internes Netz beschränkt.

Damals war ich überrascht. Diese Mirror waren jahrelang im Einsatz – und plötzlich weg. Hintergrund: regulatorische Anforderungen und hohe Betriebskosten für hochverfügbare Mirror-Dienste.

Wenn Sie heute alte Mirror aufrufen, kommt entweder 404 oder Timeout. Stehen in Ihrer daemon.json noch registry.cn-hangzhou.aliyuncs.com oder hub-mirror.c.163.com, nutzen Sie praktisch tote Endpunkte.

Direktzugriff auf Docker Hub? Technisch möglich – aus China aber oft extrem langsam. Hunderte Megabyte können eine halbe Stunde dauern; Timeout ist normal.

Im Dezember 2025 noch verfügbare Mirror

Trotz des Ausfalls der großen Anbieter betreiben Communities und Einzelpersonen weiterhin kostenlose Docker-Mirror. Ich habe kürzlich getestet und diese Liste für Dezember 2025 zusammengestellt.

Verfügbare Mirror

Empfehlung: Xuanyuan und DaoCloud haben sich in meinen Tests als stabil erwiesen. Die kostenlose Version docker.xuanyuan.me ist bereits schnell; für mehr Stabilität lohnt sich die Pro-Version.

Wichtige Hinweise

1. Community-Mirror ohne Cloud-Backing. Im Gegensatz zu Aliyun oder Tencent können diese Dienste jederzeit eingestellt werden. Bitte verantwortungsvoll nutzen.

2. Nicht jedes Image wird beschleunigt. Manche Mirror bieten nur Basis-Images (nginx, mysql, redis) oder Whitelist-Beschränkungen. Timeout bei seltenen Images? Anderen Mirror probieren oder Docker Hub direkt ansprechen.

3. Mehrere Mirror konfigurieren. daemon.json unterstützt mehrere registry-mirrors; Docker versucht sie der Reihe nach. Fallback erhöht die Erfolgsrate.

Die Mirror-URLs stammen aus dem GitHub-Projekt dongyubin/DockerHub, das die Liste laufend aktualisiert – zum Bookmarken empfohlen.

Alibaba Cloud - Top-Wahl für Entwickler, exklusiv 15 % Rabatt auf Lighthouse-Server

15 % Rabatt sichern →Anzeige

daemon.json Schritt für Schritt konfigurieren

Mit den Mirror-URLs geht es an die Konfiguration: eine JSON-Datei bearbeiten und Docker neu starten. Für die drei gängigsten Systeme:

Linux (am häufigsten)

Die meisten Server und Entwicklungsmaschinen laufen unter Linux.

1. Konfigurationsdatei erstellen oder bearbeiten

Pfad: /etc/docker/daemon.json (Datei bei Bedarf anlegen)

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

2. Konfiguration eintragen

Drei Mirror als Fallback:

{
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.m.daocloud.io",
    "https://docker.1ms.run"
  ]
}

Speichern und beenden (vi: ESC, dann :wq und Enter).

3. Docker neu starten

sudo systemctl daemon-reload
sudo systemctl restart docker

Beide Befehle sind nötig – sonst greift die Konfiguration nicht.

macOS (Docker Desktop)

Unter macOS geht das bequem über die Oberfläche.

1. Docker Desktop öffnen

Menüleiste: Docker-Symbol → Settings (oder Preferences)

2. Docker Engine

Links Docker Engine wählen – JSON-Editor erscheint.

3. JSON anpassen

registry-mirrors ergänzen (bei bestehenden Einträgen Komma nicht vergessen):

{
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.m.daocloud.io"
  ],
  "andere bestehende Einstellungen": "unverändert lassen"
}

4. Anwenden und neu starten

Apply & Restart – Docker startet neu und übernimmt die Einstellungen.

Windows (Docker Desktop)

Unter Windows analog zu macOS über Docker Desktop.

KiloClaw - Managed OpenClaw für Unternehmen: AI-Agent-Orchestrierung und smartes Modell-Routing

Jetzt starten →Anzeige

1. Einstellungen öffnen

Taskleiste: Docker-Symbol → Settings

2. Docker Engine

Links Docker Engine wählen.

3. JSON anpassen

Gleiche registry-mirrors-Konfiguration wie unter macOS.

4. Anwenden und neu starten

Apply & Restart und warten, bis Docker bereit ist.

Konfigurationshinweise

• Gültiges JSON. Häufigster Fehler: überzählige oder fehlende Kommas – JSON-Validator nutzen.
• Veraltete Mirror entfernen. Aliyun- und NetEase-Einträge löschen – sie funktionieren nicht mehr.
• Mehrere Fallbacks. 2–3 Mirror erhöhen die Erfolgsrate bei instabilen Diensten.

Konfiguration prüfen

Vor dem ersten großen Pull prüfen, ob die Einstellungen aktiv sind.

Methode 1: docker info

docker info | grep -A 5 "Registry Mirrors"

Bei Erfolg etwa:

Registry Mirrors:
  https://docker.xuanyuan.me/
  https://docker.m.daocloud.io/
  https://docker.1ms.run/

Stehen Ihre Mirror-URLs in der Ausgabe? Wenn nicht: JSON-Format und Docker-Neustart prüfen.

Methode 2: Pull-Test

docker pull nginx:latest

nginx ist ein Standard-Basis-Image – praktisch jeder Mirror führt es.

Bei funktionierender Konfiguration läuft der Download in Sekunden (nginx ~100 MB+). Statt zehn Minuten Timeout deutlich schneller.

Mein Test mit Xuanyuan: nginx von 0 auf 100 % in unter 30 Sekunden.

Immer noch langsam?

Siehe Abschnitt „Häufige Probleme“ weiter unten.

Häufige Probleme

Auch bei korrekter Konfiguration treten manchmal Fehler auf. Typische Fälle und Lösungen:

Problem 1: docker info zeigt keine Mirror

Symptom: docker info | grep "Registry Mirrors" liefert nichts oder leere Ausgabe.

🔥 Verschwende keine Monate für ungenutzte Produkte! Teste deine SaaS-Nutzenversprechen mit Adsterra bei kleinem Budget →

Jetzt testen →Anzeige

Ursachen und Lösungen:

1. Ungültiges daemon.json – häufigste Ursache. JSON ist streng: ein Komma oder Anführungszeichen zu viel reicht.

   • Lösung: z. B. JSONLint zur Prüfung nutzen.
   • Typische Fehler: Komma nach dem letzten Array-Element, fehlende schließende Klammer.

2. Docker nicht neu gestartet – Änderungen ohne Neustart wirken nicht.

   • Lösung: Linux sudo systemctl restart docker; Docker Desktop Apply & Restart.

3. Dateirechte – Docker kann daemon.json nicht lesen.

   • Lösung: sudo chmod 644 /etc/docker/daemon.json

Problem 2: Weiterhin Timeout

Symptom: Mirror in docker info sichtbar, aber docker pull schlägt fehl.

Ursachen und Lösungen:

1. Image nicht auf der Whitelist – nicht jedes Image wird beschleunigt.

   • Lösung: nginx oder redis testen; bei Erfolg anderen Mirror oder Proxy nutzen.

2. Mirror vorübergehend offline – Community-Dienste können unter Last ausfallen.

   • Lösung: mehrere Mirror eintragen (automatischer Fallback) oder später erneut versuchen.

3. Lokales Netzwerk – Firewall, Proxy, DNS.

   • Lösung: ping docker.xuanyuan.me testen, Firewall-Regeln prüfen.

Problem 3: Docker startet nach Neustart nicht

Symptom: systemctl restart docker schlägt fehl.

Ursachen und Lösungen:

1. Fehlerhaftes daemon.json blockiert Start
   • Lösung: Logs mit journalctl -u docker.service prüfen.
   • Notfall: daemon.json umbenennen, Docker starten, Konfiguration korrigieren.

sudo mv /etc/docker/daemon.json /etc/docker/daemon.json.bak
sudo systemctl restart docker

Problem 4: Bestimmte Images lassen sich nicht ziehen

Symptom: nginx/redis funktionieren, private oder spezielle Registry-Images nicht.

Lösung:

• Mirror beschleunigen in der Regel nur öffentliche Docker-Hub-Images. Private Registrys (gcr.io, quay.io) brauchen andere Wege:
  1. HTTP-Proxy in daemon.json (http-proxy, https-proxy)
  2. VPN oder Proxy-Dienst
  3. Community-Mirror für gcr.io o. Ä.

Wenn nichts hilft

1. HTTP-Proxy in daemon.json für ausgehenden Traffic
2. Private Registry mit Harbor o. Ä. und manueller Synchronisation
3. Anderen Zeitpunkt wählen – Peak-Zeiten können stören

Schritt für Schritt analysieren – meist findet sich die Ursache.

Entscheidungstabelle für 2026

Weiterführend: Docker Pulls beobachtbar machen

• Docker Hub: Nutzung und Limits (offizielle Doku)
• Docker-Mirror-Speedtest und Auto-Switching
• Docker-Zugriff auf den Host
• Docker-Logmanagement und Fehlersuche

Fazit

Kurz zusammengefasst:

Kernpunkte:

• Seit dem 6. Juni 2024 sind Aliyun, NetEase, Tencent Cloud und andere große Mirror in China ausgefallen
• Verfügbar sind vor allem Community-Mirror wie Xuanyuan und DaoCloud
• Konfiguration: daemon.json mit registry-mirrors, dann Docker neu starten
• Mehrere Mirror als Fallback eintragen
• Bei Problemen: JSON-Format, Docker-Status und Netzwerk prüfen

Community-Mirror sind weniger stabil als frühere Cloud-Angebote, lösen aber das akute Problem. Wie lange sie halten, ist ungewiss – bookmarken Sie dongyubin/DockerHub für aktuelle Listen.

Hat Ihnen der Artikel geholfen? Teilen Sie ihn gern mit anderen, die dasselbe Problem haben. Fragen gerne in die Kommentare – ich antworte, wenn ich kann.

Abschließend: Diese kostenlosen Community-Ressourcen verdienen respektvollen Umgang. Bitte nicht missbrauchen.