Porque é que as aplicações do ZimaOS abrem como páginas em branco?
Em fevereiro de 2026, um utilizador do ZimaOS comunicou que quase todas as aplicações, exceto o Plex, abriam como uma página em branco a partir do painel. A pista de diagnóstico importante foi o facto de as mesmas aplicações continuarem a abrir quando o utilizador introduzia manualmente o endereço IP do ZimaOS e a porta da aplicação.
Esse comportamento sugere que os próprios contentores das aplicações podem continuar em execução. O problema pode estar entre o iniciador do painel, o estado do navegador e a camada de encaminhamento ou proxy local utilizada para abrir a aplicação.
O que resolveu o problema no tópico original?
A solução confirmada foi simples: o utilizador limpou a cache do navegador e comunicou que as aplicações voltaram a funcionar normalmente. Isto faz do estado do navegador a primeira coisa a testar quando o acesso direto através de IP:PORT funciona, mas o lançamento a partir do painel do ZimaOS produz apenas uma página em branco.
O que deve verificar primeiro?
- Confirme se a aplicação afetada continua a abrir diretamente utilizando o endereço IP local e a porta atribuída.
- Abra o painel do ZimaOS numa janela privada ou anónima do navegador. Se a aplicação funcionar aí, os dados em cache do navegador são um forte suspeito.
- Limpe os dados em cache do site relativos ao painel do ZimaOS e volte a carregá-lo.
- Experimente outro navegador ou dispositivo cliente para determinar se o problema acompanha o servidor ou apenas um perfil de navegador.
- Só avance para a resolução de problemas do iniciador, proxy ou contentor se limpar o estado do navegador não resolver o problema.
Porque é importante o acesso direto através do IP e da porta?
Se a própria interface Web de uma aplicação continuar a responder diretamente, isso indica que o serviço está acessível e que o contentor não está completamente parado. Isto direciona a investigação para a forma como o ZimaOS lança ou encaminha a aplicação, em vez de culpar imediatamente a própria aplicação.
Isto não é uma garantia universal: uma aplicação pode continuar a apresentar falhas parciais mesmo quando a respetiva porta Web responde. Ainda assim, é uma divisão inicial útil no processo de resolução de problemas.
Quando poderá ser algo mais do que a cache do navegador?
Se a página em branco aparecer em vários navegadores limpos, ou se o acesso direto através do IP e da porta também falhar, o problema já não é igual ao caso comunitário resolvido. Verifique se a aplicação está em execução, se a porta atribuída mudou e se existe algum proxy inverso ou configuração de rede entre o navegador e o ZimaOS.
As versões atuais do ZimaOS continuam a melhorar o arranque das aplicações, a transferência de imagens e o comportamento da App Store. Se o problema começar imediatamente após uma atualização, registe a versão do ZimaOS e as versões das aplicações afetadas antes de alterar a implementação.
Para consultar o comportamento atual das aplicações e as opções de instalação, veja o guia da App Store do ZimaOS.
Perguntas frequentes
Devo reinstalar todas as aplicações se o painel as abrir como páginas em branco?
Não inicialmente. No tópico resolvido, os contentores estavam acessíveis diretamente e limpar a cache do navegador corrigiu o problema de lançamento a partir do painel.
Porque é que o Plex continuou a funcionar quando as outras aplicações não funcionavam?
O tópico não estabelece uma razão definitiva. O resultado importante é que o problema geral desapareceu depois de a cache do navegador ter sido limpa.
Um URL com IP e porta a funcionar prova que o contentor está completamente saudável?
Não, mas mostra que o serviço Web está acessível e ajuda a distinguir um problema de lançamento ou do navegador de um serviço completamente parado.
E se limpar a cache não ajudar?
Teste outro navegador limpo, confirme se a aplicação continua a responder diretamente e, em seguida, investigue o estado da aplicação, as atribuições de portas, a rede e qualquer camada de proxy envolvida.
