Gemenskapslösning

ZimaOS kan inte nå Docker Hub: Kontrollera systemklockan och NTP

After upgrading to ZimaOS v1.4.1, a ZimaBlade user could not download apps because ZimaOS reported that Docker Hub was unreachable. Disabling IPv6 did not help; the user later traced the failure to an unsynchronized system clock.

En ZimaBlade-användare rapporterade att ZimaOS v1.4.1 inte längre kunde installera appar och visade ett anslutningsfel mot Docker Hub, trots att det lokala nätverket fungerade. Ett första förslag om att inaktivera IPv6 löste inte problemet.

Den slutliga lösningen var systemklockan: användaren upptäckte att nätverkstidssynkronisering inte var aktiv, vilket gjorde att ZimaOS-klockan gick fel. När tidssynkroniseringen återställdes fungerade åtkomsten till Docker Hub igen.

Varför felaktig tid kan se ut som ett nätverksfel

Containerregister använder HTTPS. Om värddatorns klocka visar en tid som avviker kraftigt från den verkliga tiden kan certifikatvalidering och autentiserade förfrågningar misslyckas på sätt som ser ut som vanliga problem med internetanslutningen. Därför utesluter en fungerande LAN-anslutning inte ett tidsrelaterat fel.

Kontrollera tiden innan du bygger om nätverket

Kontrollera först den aktuella tiden och synkroniseringsstatusen från en terminal:

timedatectl

På ett system som använder systemd:s tidsinställningar kan nätverkstidssynkronisering aktiveras med:

timedatectl set-ntp true

Den aktuella dokumentationen om timedatectl:s NTP-kontroller beskriver både statusutdata och kontrollen set-ntp. Vilken tidstjänst som finns tillgänglig i en viss ZimaOS-version kan variera, så använd kommandot som ett diagnostikverktyg i stället för att blint ersätta systemkonfigurationen.

En praktisk checklista för Docker Hub

  1. Bekräfta att ZimaOS-instrumentpanelen har normal LAN-anslutning.
  2. Kontrollera datum, tid, tidszon och om systemklockan är synkroniserad.
  3. Starta om efter att tidssynkroniseringen har återställts om registerförfrågningar fortfarande använder gammal status.
  4. Gå först därefter vidare till felsökning av DNS, IPv4/IPv6, brandvägg, internetleverantör eller proxy.

Versionskontext

Den här rapporten kom från ZimaOS v1.4.1 under 2025. Värdet i tråden ligger i det diagnostiska mönstret, inte i ett påstående om att aktuella ZimaOS-versioner har ett känt Docker Hub-fel. Det officiella svaret angav uttryckligen att detta inte var ett känt problem i v1.4.1.

Aktuell tid och registerkontext

Kraven för ZimaOS App Store är användbara när en misslyckad appinstallation verkar bero på resurser eller kompatibilitet, medan den första Docker-appen beskriver det normala arbetsflödet för att hämta appar. Om felet uppstår under installationen eller vid första åtkomsten på maskinvara från tredje part innehåller felsökningen för ZimaOS-installation en bredare checklista för diagnostik av nätverk och uppstart.

timedatectl:s NTP-kontroller bekräftar att timedatectl kan rapportera om nätverkstidssynkronisering är aktiv och aktivera den med set-ntp true när en kompatibel synkroniseringstjänst finns tillgänglig. Dockumentationen om Docker-registercertifikat beskriver certifikatbaserad registerautentisering och TLS, vilket är anledningen till att klockans giltighet bör kontrolleras tidigt i checklistan när HTTPS-åtkomst till ett register oväntat misslyckas.

Sammanfattning

Om ZimaOS anger att Docker Hub inte kan nås trots att den normala nätverksåtkomsten verkar fungera bör du kontrollera systemklockan tidigt. I det här communityfallet var NTP-synkronisering – inte IPv6 – den avgörande lösningen.