Solução da comunidade

Aplicações do ZimaOS em falta no ecrã inicial: o que verificar

A ZimaOS 1.6.1 user lost all app icons across multiple browsers; after updating to 1.6.2, the apps returned.

Se todas as aplicações desaparecerem do ecrã inicial do ZimaOS, mas o servidor e os dados continuarem acessíveis, não presuma que o NAS está a falhar ou que as suas aplicações foram eliminadas. Comece por verificar a versão exata do ZimaOS, se os contentores Docker ainda existem e se o sintoma se limita a uma regressão do frontend/painel.

O caso original é um bom exemplo: no ZimaOS 1.6.1, o utilizador não conseguia ver aplicações em vários navegadores e receava uma falha iminente do sistema. Depois de atualizar para a versão 1.6.2, as aplicações voltaram a aparecer. Esta é uma recuperação verificada pelo utilizador, mas o tópico não contém uma declaração da IceWhale que prove que todos os casos de aplicações desaparecidas correspondiam a um erro universal da versão 1.6.1.

Passo 1: Verifique se as aplicações desapareceram realmente

Abra o terminal e inspecione o Docker:

docker ps -a

Se os seus contentores continuarem listados, é provável que as definições e os dados das aplicações ainda existam, mesmo que o ecrã inicial esteja vazio.

Se o próprio Docker devolver um erro, o problema é mais profundo do que o painel e deve ser diagnosticado como uma questão relacionada com um serviço ou com o armazenamento.

Passo 2: Verifique a versão exata do ZimaOS

O utilizador do caso original utilizava a versão 1.6.1 e comunicou que a atualização para a versão 1.6.2 restaurou os ícones das aplicações. As notas de lançamento do ZimaOS 1.6.2 descrevem melhorias mais abrangentes de estabilidade e correções relacionadas com o armazenamento, embora não documentem especificamente o sintoma de aplicações desaparecidas do utilizador.

Se já estiver numa versão estável mais recente, não faça downgrade para a versão 1.6.2 apenas porque esta resolveu um caso histórico.

Passo 3: Teste o painel numa sessão limpa do navegador

Utilize uma janela privada/anónima e faça uma atualização forçada da página. Durante o teste, desative bloqueadores de conteúdos agressivos ou filtros de scripts para o endereço local do ZimaOS.

O utilizador do caso original já tinha experimentado o Brave, o Firefox e o Chrome, o que tornou menos provável um simples problema de cache de um único navegador. Ainda assim, esta verificação continua a ser útil nos casos atuais.

Passo 4: Teste através do endereço IP e do nome do anfitrião

Abra tanto o endereço IP direto da LAN como o seu nome de anfitrião local habitual. Se um deles carregar o painel das aplicações e o outro não, investigue o DNS, os recursos frontend armazenados em cache ou o armazenamento do navegador específico da origem.

Se ambos apresentarem um ecrã inicial vazio enquanto os contentores Docker continuam a funcionar corretamente, concentre-se no serviço frontend/backend de listagem de aplicações do ZimaOS, em vez de reinstalar as aplicações Docker.

Passo 5: Verifique o armazenamento antes de reiniciar repetidamente

O utilizador do caso original também mencionou que os discos desapareciam de forma intermitente e que era necessário reiniciar diariamente. Este é um sintoma prioritário separado, porque a ausência do armazenamento AppData pode impedir que as aplicações sejam enumeradas ou iniciadas.

Verifique Definições → Armazenamento e confirme que a localização AppData está montada. O atual guia de configuração do armazenamento do ZimaOS explica os indicadores atuais do estado dos discos e das matrizes.

Não reinstale aplicações até saber que os respetivos dados estão seguros

Se os contentores e o AppData ainda existirem, reinstalar a partir da App Store pode criar caminhos duplicados, novos volumes ou confusão sobre os dados pertencentes a cada instância.

O guia de resolução de problemas de aplicações Docker ajuda a distinguir o desaparecimento da interface da perda efetiva de contentores.

Como distinguir uma falha da interface de uma falha da aplicação

Sintoma Camada provável
Ecrã inicial vazio, com contentores presentes e em execução Interface do painel/lista de aplicações ou metadados do backend
Contentores presentes, mas parados Problema de configuração da aplicação/Docker ou de dependências
Contentores ausentes, mas AppData presente Caminho de recuperação através dos metadados/reinstalação da aplicação
Armazenamento AppData ausente Problema de montagem, permissões ou disco
Painel e terminal indisponíveis Falha do sistema, da rede ou de um serviço

Quando atualizar e quando recolher registos

Se estiver disponível uma versão estável mais recente do ZimaOS e a sua cópia de segurança estiver atualizada, a atualização é razoável, especialmente se o problema tiver começado imediatamente após uma atualização anterior. No entanto, se o armazenamento estiver degradado ou o disco do sistema estiver a falhar, corrija ou proteja primeiro a camada de dados.

Se o problema persistir na versão estável mais recente, recolha os erros da consola do navegador, o resultado de docker ps -a, o estado atual do armazenamento, a versão do ZimaOS e os registos relevantes do sistema e dos serviços de aplicações para enviar ao suporte.

Perguntas frequentes

O ZimaOS 1.6.2 corrigiu os ícones de aplicações desaparecidos?

Corrigiu o caso original do utilizador na versão 1.6.1. O tópico não prova que todos os problemas de aplicações desaparecidas tivessem a mesma causa.

As minhas aplicações foram eliminadas se o ecrã inicial estiver vazio?

Não necessariamente. Verifique docker ps -a e o armazenamento AppData antes de reinstalar qualquer coisa.

A cache do navegador pode ocultar todas as aplicações do ZimaOS?

Um frontend desatualizado pode causar problemas na interface, por isso vale a pena testar uma atualização forçada ou uma janela privada. Se todos os navegadores limpos apresentarem o mesmo comportamento, investigue o lado do servidor.

Devo comprar discos de cópia de segurança antes de atualizar?

Manter cópias de segurança é aconselhável em qualquer caso, mas um painel vazio, por si só, não prova uma perda iminente de dados. Verifique primeiro o estado do sistema e do armazenamento.