ZimaOS kann Docker Hub nicht erreichen: Überprüfen Sie die Systemuhr und NTP

Ein ZimaBlade-Nutzer berichtete, dass ZimaOS v1.4.1 keine Apps mehr installieren konnte und einen Docker-Hub-Verbindungsfehler anzeigte, obwohl das lokale Netzwerk selbst funktionierte. Ein erster Vorschlag, IPv6 zu deaktivieren, brachte keine Abhilfe.

Die letztendliche Lösung war die Systemuhr: Der Nutzer stellte fest, dass die Netzzeitsynchronisierung nicht aktiv war und die ZimaOS-Uhr daher falsch ging. Nachdem die Zeitsynchronisierung wiederhergestellt worden war, funktionierte der Zugriff auf Docker Hub wieder.

Warum eine falsche Uhrzeit wie ein Netzwerkfehler aussehen kann

Container-Registries verwenden HTTPS. Wenn die Uhr des Hosts stark von der tatsächlichen Zeit abweicht, können die Zertifikatsprüfung und authentifizierte Anfragen auf eine Weise fehlschlagen, die wie gewöhnliche Probleme mit der Internetverbindung aussieht. Deshalb schließt eine funktionierende LAN-Verbindung einen zeitbezogenen Fehler nicht aus.

Zeit prüfen, bevor das Netzwerk neu konfiguriert wird

Prüfen Sie zunächst in einem Terminal die aktuelle Uhrzeit und den Synchronisierungsstatus:

timedatectl

Auf einem System, das die Zeitsteuerung von systemd verwendet, kann die Netzzeitsynchronisierung wie folgt aktiviert werden:

timedatectl set-ntp true

Die aktuellen NTP-Steuerungsoptionen von timedatectl dokumentieren sowohl die Statusausgabe als auch die Steuerung mit set-ntp. Der genaue Zeitdienst, der in einem bestimmten ZimaOS-Build verfügbar ist, kann variieren. Verwenden Sie den Befehl daher zur Diagnose, statt die Systemkonfiguration blind zu ersetzen.

Eine praktische Docker-Hub-Checkliste

1. Bestätigen Sie, dass das ZimaOS-Dashboard eine normale LAN-Verbindung hat.
2. Prüfen Sie Datum, Uhrzeit, Zeitzone und ob die Systemuhr synchronisiert ist.
3. Starten Sie das System nach der Wiederherstellung der Zeitsynchronisierung neu, falls Registry-Anfragen weiterhin veraltete Zustände verwenden.
4. Erst danach sollten Sie DNS, IPv4/IPv6, Firewall, Internetanbieter oder Proxy überprüfen.

Versionskontext

Dieser Bericht stammt aus dem Jahr 2025 und bezieht sich auf ZimaOS v1.4.1. Der Wert des Threads liegt im Diagnosemuster, nicht in der Behauptung, dass aktuelle ZimaOS-Versionen einen bekannten Docker-Hub-Fehler aufweisen. In der offiziellen Antwort wurde ausdrücklich erklärt, dass es sich nicht um ein bekanntes Problem von v1.4.1 handelte.

Kontext zu aktueller Zeit und Registry

Die Anforderungen des ZimaOS App Store sind hilfreich, wenn eine fehlgeschlagene App-Installation wie ein Ressourcen- oder Kompatibilitätsproblem aussieht. Die Anleitung zur ersten Docker-App erklärt den normalen Ablauf zum Abrufen von Anwendungen. Wenn der Fehler bei der Installation oder beim ersten Zugriff auf Hardware von Drittanbietern auftritt, bietet die ZimaOS-Installationsfehlerbehebung eine umfassendere Checkliste für Netzwerk- und Startdiagnosen.

Die NTP-Steuerungsoptionen von timedatectl bestätigen, dass timedatectl anzeigen kann, ob die Netzzeitsynchronisierung aktiv ist, und sie mit set-ntp true aktivieren kann, sofern ein kompatibler Synchronisierungsdienst verfügbar ist. Die Dokumentation zu Docker-Registry-Zertifikaten beschreibt die zertifikatsbasierte Registry-Authentifizierung und TLS. Deshalb sollte die Gültigkeit der Systemzeit früh in der Checkliste stehen, wenn der HTTPS-Zugriff auf eine Registry unerwartet fehlschlägt.

Fazit

Wenn ZimaOS meldet, dass Docker Hub nicht erreichbar ist, während der normale Netzwerkzugriff scheinbar funktioniert, sollten Sie die Systemuhr frühzeitig überprüfen. In diesem Community-Fall war die NTP-Synchronisierung – nicht IPv6 – die entscheidende Lösung.