O ZimaOS não consegue aceder ao Docker Hub: verifique o relógio do sistema e o NTP

Um utilizador da ZimaBlade comunicou que o ZimaOS v1.4.1 já não conseguia instalar aplicações e apresentava um erro de conectividade com o Docker Hub, apesar de a rede local estar a funcionar. Uma sugestão inicial para desativar o IPv6 não resolveu o problema.

A solução acabou por ser o relógio do sistema: o utilizador descobriu que a sincronização da hora através da rede não estava ativa, pelo que o relógio do ZimaOS estava incorreto. Depois de repor a sincronização da hora, o acesso ao Docker Hub voltou a funcionar.

Porque é que um relógio incorreto pode parecer um erro de rede

Os registos de contentores utilizam HTTPS. Se o relógio do anfitrião estiver muito afastado da hora real, a validação de certificados e os pedidos autenticados podem falhar de formas que parecem problemas comuns de conectividade à Internet. Por isso, uma ligação LAN funcional não exclui uma falha relacionada com a hora.

Verifique a hora antes de reconstruir a rede

Num terminal, comece por verificar o relógio atual e o estado da sincronização:

timedatectl

Num sistema que utilize os controlos de hora do systemd, a sincronização da hora através da rede pode ser ativada com:

timedatectl set-ntp true

Os controlos NTP do timedatectl documentam tanto o resultado do estado como o controlo set-ntp. O serviço de hora exato disponível numa determinada versão do ZimaOS pode variar, por isso utilize o comando como diagnóstico, em vez de substituir cegamente a configuração do sistema.

Uma lista de verificação prática para o Docker Hub

1. Confirme que o painel do ZimaOS tem conectividade LAN normal.
2. Verifique a data, a hora, o fuso horário e se o relógio do sistema está sincronizado.
3. Reinicie o sistema depois de repor a sincronização da hora, caso os pedidos ao registo continuem a utilizar dados obsoletos.
4. Só depois avance para a resolução de problemas relacionados com DNS, IPv4/IPv6, firewall, ISP ou proxy.

Contexto da versão

Este relatório surgiu no ZimaOS v1.4.1, em 2025. O valor desta discussão está no padrão de diagnóstico, não numa afirmação de que as versões atuais do ZimaOS tenham um erro conhecido no Docker Hub. A resposta oficial afirmou explicitamente que não se tratava de um problema conhecido do v1.4.1.

Contexto da hora atual e do registo

Os requisitos da ZimaOS App Store são úteis quando uma instalação de aplicação falha e parece tratar-se de um problema de recursos ou compatibilidade, enquanto a primeira aplicação Docker explica o fluxo normal de obtenção de aplicações. Se a falha ocorrer durante a instalação ou o primeiro acesso em hardware de terceiros, o guia de resolução de problemas de instalação do ZimaOS fornece uma lista de verificação mais abrangente para o diagnóstico da rede e do arranque.

Os controlos NTP do timedatectl confirmam que o timedatectl pode indicar se a sincronização da hora através da rede está ativa e pode ativá-la com set-ntp true quando estiver disponível um serviço de sincronização compatível. A documentação dos certificados de registo do Docker explica a autenticação de registos baseada em certificados e o TLS, razão pela qual a validade do relógio deve estar no início da lista de verificação quando o acesso a um registo HTTPS falha inesperadamente.

Em resumo

Se o ZimaOS indicar que o Docker Hub está inacessível enquanto o acesso normal à rede parece estar a funcionar, verifique primeiro o relógio do sistema. Neste caso da comunidade, a sincronização NTP — e não o IPv6 — foi a solução decisiva.