Solução da comunidade

Falhas dos ficheiros do ZimaOS através do Tailscale: isole a rota

A ZimaOS beta user could browse Files locally but received an Error loading message when opening the same Files app through a Tailscale IP.

Conclusão: Esta foi uma falha da interface de ficheiros específica da rota, não uma falha geral do armazenamento

O acesso local funcionava, enquanto a mesma aplicação Ficheiros falhava através do endereço Tailscale. Isto restringe o problema ao percurso remoto HTTP/WebSocket/sessão, e não aos discos ou à base de dados da aplicação Ficheiros. No caso original da versão 1.4.4-beta1, a atualização para a versão estável 1.4.4 removeu o erro.

Aplicação Ficheiros do ZimaOS a apresentar o erro de carregamento quando aberta através de um endereço Tailscale
O caso exclusivo da versão beta apresentava a estrutura da interface Ficheiros, mas não conseguia obter o conteúdo dos ficheiros através do endereço Tailscale.

Atualmente, o ZimaOS suporta oficialmente o Tailscale como método padrão de acesso remoto

O guia do Tailscale para o ZimaOS, de setembro de 2026, indica que qualquer dispositivo da tailnet pode aceder ao servidor ZimaOS através do respetivo endereço 100.x. Utilize esta configuração atual antes de aplicar soluções alternativas da era beta.

O guia de hardware do Tailscale fornece o contexto atual ao nível da aplicação.

Quando o painel de controlo abre, mas os Ficheiros apresentam o erro de carregamento

Abra as ferramentas de desenvolvimento do navegador e verifique os pedidos de API/WebSocket que falharam. Teste também o mesmo endereço 100.x a partir de outro cliente da tailnet. A documentação de encaminhamento e a referência da CLI do Tailscale ajudam a distinguir o acesso direto à tailnet do encaminhamento de sub-redes.

Não reinstale o ZimaOS como primeira solução

Um utilizador posterior, na versão 1.5.4, afirmou que a reinstalação resolveu um sintoma semelhante, mas esta é uma solução dispendiosa e não identifica a causa. Primeiro, atualize para a versão estável atual do ZimaOS, reinicie a aplicação Tailscale, verifique a rota 100.x e compare os pedidos do navegador local com os da tailnet.

Utilize o acesso remoto integrado como teste de controlo

Se o acesso remoto do ZimaClient funcionar enquanto os Ficheiros através do Tailscale não funcionam, terá fortes indícios de que o armazenamento e o serviço Ficheiros estão a funcionar corretamente. O guia de acesso remoto do ZimaClient é um percurso de controlo útil, e o guia de aplicações do ZimaOS é útil quando o próprio contentor do Tailscale precisa de ser atualizado.