Solução da comunidade

Corrija os mosaicos de aplicações do ZimaOS que não abrem, embora os URLs diretos funcionem

A ZimaOS user can open apps by typing the IP manually but not by clicking dashboard tiles; rebooting did not immediately fix it and the issue later cleared.

Um URL direto funcional isola a falha no percurso de lançamento

Se uma aplicação abrir quando introduz o IP do anfitrião e a porta, o contentor, a publicação da porta e a rota básica da LAN já estão a funcionar. O ramo com problemas é mais provavelmente o URL gerado pelo mosaico do ZimaOS, o tratamento dessa ligação pelo navegador ou metadados da aplicação temporariamente desatualizados.

A resposta da comunidade sugeriu que o iniciador fosse carregado antes do Docker e tivesse mantido uma rota desatualizada. Isso é plausível, mas não foi comprovado: o utilizador já tinha reiniciado o Docker e o gestor de aplicações, uma reinicialização completa não resolveu imediatamente o problema e os mosaicos começaram a funcionar cerca de um dia mais tarde. Mantenha essa incerteza ao diagnosticar a própria ligação.

Painel do ZimaOS onde os mosaicos das aplicações não abrem
As aplicações indicadas continuavam acessíveis ao introduzir manualmente o respetivo endereço IP e porta.

Compare o destino do mosaico com o endereço conhecido como funcional

Clique com o botão direito do rato no mosaico e copie o endereço da ligação sem o abrir. Compare o esquema, o nome do anfitrião, o IP, a porta e o caminho com o URL introduzido manualmente que funciona. Uma porta incorreta ou um endereço antigo do anfitrião aponta para metadados desatualizados da aplicação; uma diferença entre HTTP e HTTPS aponta para o tratamento do proxy ou da segurança do navegador.

Abra o URL copiado do mosaico num novo separador. Se falhar com um erro visível do navegador, registe o resultado exato. Se clicar não produzir sequer um separador, teste o bloqueio de pop-ups, a filtragem por extensões e o mesmo painel numa janela privada ou noutro navegador.

Não altere a rede do contentor até concluir esta comparação. Se o endereço copiado do mosaico estiver correto e funcionar quando colado, o problema está no evento de clique do painel ou no perfil do navegador. Se o endereço copiado estiver incorreto, o problema está a montante, nos metadados do iniciador.

Atualize primeiro apenas as camadas do cliente e dos metadados

Recarregue o painel sem utilizar a cache, termine sessão e inicie sessão novamente e teste um perfil de navegador limpo. Desative, uma de cada vez, as extensões que alteram páginas ou relacionadas com privacidade para a origem local do ZimaOS. Estas verificações reversíveis devem preceder os reinícios dos serviços do anfitrião.

Se todos os clientes limpos receberem o mesmo URL incorreto no mosaico, registe o nome da aplicação, a porta apresentada, o endereço copiado, o endereço funcional e a versão do ZimaOS. Reinicie a aplicação uma vez e dê tempo ao painel para a redescobrir. Depois, faça uma reinicialização organizada do ZimaOS como etapa de verificação, não como prova de uma correção.

Evite desligar a alimentação enquanto o armazenamento estiver ativo. O utilizador original tentou remover completamente a alimentação sem recuperação imediata, pelo que isso não deve ser recomendado como passo predefinido. Não limpe os dados da aplicação nem reinstale os contentores quando os respetivos URLs diretos continuam a funcionar.

Verifique o estado do contentor apenas se o percurso direto também começar a falhar

Verifique o estado da aplicação e a porta publicada no ZimaOS. Se o acesso direto continuar saudável, pare na fronteira do iniciador. Se o acesso direto também falhar, analise o primeiro erro relevante do registo do contentor e confirme que a porta continua associada à interface do anfitrião esperada.

Teste uma aplicação afetada e uma aplicação não afetada. Um único mosaico com uma porta antiga sugere metadados específicos da aplicação, enquanto todos os mosaicos a falhar num navegador sugerem um problema do cliente. Todos os mosaicos a falhar em vários clientes após uma atualização constituem evidência mais forte de um problema na camada do gestor de aplicações ou do painel.

Após qualquer recuperação, repita o teste de clique original no mesmo navegador, depois de recarregar o painel e após uma reinicialização normal. Recuperação significa que o mosaico abre consistentemente o mesmo endereço que o URL direto conhecido como funcional, não apenas que o estado do contentor aparece como “em execução”.

Escalone o problema com os dois URLs em vez de repor o sistema

Se o problema voltar, capture o URL copiado do mosaico e o URL que funciona manualmente, ocultando os detalhes privados do anfitrião conforme necessário. Inclua os carimbos de data e hora, o nome da aplicação, o navegador, as extensões, a versão do ZimaOS e se outro cliente apresenta o mesmo comportamento.

Indique se o problema surgiu após uma atualização da aplicação, uma alteração da porta, uma alteração do endereço do anfitrião, uma configuração de proxy ou uma atualização do ZimaOS. Esses fatores ajudam o suporte a reproduzir o mapeamento desatualizado, em vez de esperar que volte a desaparecer.

Pare antes de efetuar uma reposição de fábrica, eliminar a aplicação ou fazer uma limpeza abrangente do Docker enquanto o acesso direto funcionar. O tópico original terminou com uma recuperação espontânea e sem uma causa confirmada, pelo que uma reparação destrutiva eliminaria evidências sem visar uma falha verificada.

Perguntas frequentes

Reiniciar o Docker reconstrói todas as ligações das aplicações do ZimaOS?

O tópico não o comprova. O utilizador reiniciou o Docker e o gestor de aplicações, mas o problema manteve-se temporariamente.

Porque é que colar o URL do mosaico funciona quando clicar não funciona?

Esse resultado isola o tratamento do clique pelo navegador, as extensões ou o JavaScript do painel. Teste uma janela privada e outro navegador antes de alterar o servidor.

Devo reinstalar a aplicação afetada?

Não enquanto o URL direto funcionar e os dados estiverem intactos. Compare primeiro os endereços e recolha evidências sobre o iniciador.

As observações originais e a cronologia não resolvida encontram-se na discussão sobre os mosaicos de aplicações do ZimaOS.