Instalar a aplicação Tailscale e concluir uma ligação de autenticação do dispositivo não garante que o contentor ZimaOS permaneça ligado. Neste tópico resolvido de outubro de 2025, o dispositivo podia ser adicionado ao Tailscale, mas nunca apresentava o estado de ligação esperado na lista de dispositivos de administração do Tailscale.
A solução veio de outros utilizadores da comunidade, e não de uma conta de funcionário da IceWhale. Um utilizador identificou a entrada do Tailscale na App Store do ZimaOS que funcionava no seu ambiente, alterou a configuração da respetiva interface Web e forneceu uma nova chave de autenticação do Tailscale. Uma resposta posterior acrescentou um passo de recuperação importante para estados persistentemente problemáticos: remover a antiga pasta AppData do Tailscale antes de reinstalar a aplicação.
O tópico utilizou uma entrada específica do Tailscale na App Store
A App Store do ZimaOS apresentava duas entradas relacionadas com o Tailscale. O membro da comunidade que prestou ajuda indicou que, na altura, apenas a entrada destacada à esquerda tinha funcionado na sua própria migração para o ZimaOS 1.5.
Esta foi uma observação de 2025, não uma classificação permanente dos pacotes atuais da App Store. As definições das aplicações podem mudar, por isso compare os detalhes dos pacotes atuais antes de presumir que a mesma entrada continua a ser necessária.
Defina o caminho da interface Web utilizado pela configuração da comunidade
O membro que prestou ajuda alterou o destino da interface Web da aplicação Tailscale para apontar para o caminho de administração de início de sessão do Tailscale:
login.tailscale.com com o caminho /admin para o atalho da interface Web.Esta definição controla o atalho aberto a partir do ZimaOS. Não deve ser confundida com o estado de rede do próprio daemon do Tailscale.
Utilize a sua própria chave de autenticação atual do Tailscale
O guia da comunidade obteve depois uma chave de autorização do Tailscale e colocou-a na variável de ambiente TS_AUTHKEY da aplicação. Não copie uma chave de autenticação de uma captura de ecrã, publicação num fórum, cópia de segurança ou outra máquina. As chaves de autenticação são credenciais e devem ser geradas e geridas para a sua própria tailnet.
A documentação atual do Tailscale é compatível com implementações em contentores e parâmetros de autenticação para o Docker:
Documentação do Tailscale para Docker
Se a reinstalação não ajudar, a AppData antiga pode continuar a ser reutilizada
Um segundo utilizador da comunidade tinha uma instalação do Tailscale que funcionava anteriormente e depois deixou de funcionar. A atualização, o reinício, a eliminação da aplicação e a reinstalação não resolveram inicialmente o problema.
O passo que finalmente funcionou para esse utilizador foi:
- eliminar a aplicação Tailscale do ZimaOS;
- aceder à localização AppData do ZimaOS;
- remover a antiga pasta de dados da aplicação
tailscale; - reinstalar o Tailscale a partir da App Store;
- repetir os passos funcionais de configuração e autenticação.
Aviso: eliminar uma pasta AppData remove o estado persistente da aplicação. Faça uma cópia de segurança de tudo o que possa vir a precisar antes de a eliminar e confirme que está a eliminar a pasta do Tailscale, e não os dados de outra aplicação.
Porque é que eliminar apenas a aplicação pode não repor o Tailscale
As aplicações em contentores mantêm frequentemente o estado fora do sistema de ficheiros descartável do contentor. Isto permite que as definições sobrevivam a atualizações ou à recriação do contentor, mas também significa que um estado incorreto ou obsoleto pode sobreviver a um ciclo normal de desinstalação e reinstalação se o diretório AppData persistente ficar intacto.
O resultado posterior deste tópico é, por isso, útil para distinguir dois níveis de recuperação: reinstalar primeiro o contentor e só considerar a eliminação do estado persistente quando uma reinstalação normal continuar a reutilizar a mesma configuração problemática.
Este tópico resolvido era sobre ligar o nó, não sobre encaminhamento de sub-redes
O problema aqui era o facto de o nó Tailscale nunca ficar ligado. É diferente de uma discussão posterior no ZimaOS em que o Tailscale se ligava com sucesso, mas não anunciava rotas de sub-rede. Se o seu dispositivo já estiver online no Tailscale e apenas os serviços da LAN remota estiverem inacessíveis, investigue o encaminhamento de sub-redes em vez de repetir este procedimento focado na autenticação.
Perguntas frequentes sobre a ligação do Tailscale no ZimaOS
Porque é que o meu dispositivo Tailscale aparece registado, mas nunca fica ligado?
No caso resolvido de 2025, a configuração funcional da comunidade envolveu a entrada adequada da App Store, a respetiva configuração da interface Web e uma chave de autenticação válida do Tailscale.
Devo eliminar imediatamente a AppData do Tailscale?
Não. A eliminação da AppData foi um passo de recuperação posterior, utilizado depois de as tentativas normais de atualização, reinício, desinstalação e reinstalação terem falhado. Remove o estado persistente, por isso faça primeiro uma cópia de segurança.
É seguro reutilizar a chave de autenticação apresentada numa captura de ecrã antiga?
Não. Gere e faça a gestão da sua própria chave para a sua tailnet. Trate as chaves de autenticação como credenciais.
Foi esta uma solução oficial da IceWhale?
Não. O tópico foi marcado como resolvido através de diagnóstico da comunidade. É uma evidência prática útil, mas os passos não foram publicados como um procedimento oficial de suporte da IceWhale.
