Solução da comunidade

ZimaClient no Mac bloqueado a ligar-se: o que tentar primeiro

A Mac client stayed on Connecting after ZimaOS upgrades; rebooting and reinstalling did not help, but signing out and back in restored the verified case.

Se o ZimaClient no macOS ficar preso em “A ligar”, termine a sessão no cliente e inicie sessão novamente antes de reinstalar a aplicação ou alterar o servidor ZimaOS. Essa ação exata resolveu o caso de origem verificado da versão 2.1.0, que esteve bloqueado durante várias horas.

No entanto, não considere terminar e iniciar sessão novamente uma solução universal para a causa principal. O mesmo tópico envolveu sintomas de ligação tanto no Mac como no Android após atualizações do ZimaOS, e a IceWhale perguntou especificamente sobre firewalls, VPNs, proxies, alterações de ISP e configuração da rede. Um bom processo de resolução de problemas separa o estado da conta/sessão da acessibilidade da rede.

Passo 1: Confirme que o servidor funciona localmente

Abra diretamente o painel do ZimaOS num navegador, utilizando o IP da LAN. Se o servidor funcionar localmente, mas o ZimaClient não conseguir ligar-se, concentre-se na camada do cliente/sessão/acesso remoto.

Passo 2: Termine a sessão e inicie sessão novamente

O utilizador original já tinha reinstalado o ZimaClient e reiniciado o ZimaOS sem sucesso. Terminar a sessão no ZimaClient e autenticar-se novamente restabeleceu a ligação.

Isto sugere que havia um estado antigo do cliente/sessão envolvido, mas o tópico não comprovou exatamente qual token ou estado de rede foi alterado.

Passo 3: Verifique o acesso remoto no ZimaOS

O atual guia de acesso remoto do ZimaOS indica que o acesso remoto pode ser ativado ou desativado em Definições → Rede.

Certifique-se de que está ativado se espera utilizar o ZimaClient fora de casa.

Passo 4: Teste na mesma LAN

As orientações atuais de configuração inicial do ZimaOS recomendam que a primeira ligação seja feita na mesma rede. Se o ZimaClient não conseguir ligar-se nem localmente, a travessia de NAT remoto não é o primeiro problema a investigar.

Passo 5: Verifique VPN, proxy, firewall e alterações de rede

O suporte da IceWhale perguntou especificamente se o utilizador tinha alterado o firewall, a VPN/proxy, o ISP ou a administração da rede antes da falha.

Desative temporariamente os clientes VPN/proxy que possam estar em conflito durante o diagnóstico e confirme que a permissão de rede local do macOS permite ao ZimaClient detetar dispositivos.

Passo 6: Reinicie os processos bloqueados do ZimaClient

O atual guia de instalação do ZimaClient recomenda utilizar o Monitor de Atividade para fechar os processos relacionados com o Zima quando a aplicação parece estar em execução, mas não funciona corretamente.

Passo 7: Recolha os registos antes de voltar a reinstalar

A documentação atual indica que os registos do ZimaClient no macOS se encontram em:

~/Library/Application Support/Zima/logs

Recolha-os imediatamente após reproduzir o problema, para que o suporte possa distinguir falhas de deteção, autenticação e rede remota.

Utilize ferramentas VPN padrão como alternativa

O ZimaOS atual também suporta Tailscale, WireGuard Easy, Firefly e NetBird como opções alternativas de rede remota. Estas não substituem a cópia de segurança nem a integração com o Finder do ZimaClient, mas podem fornecer um percurso de rede privado separado.

O guia de ligação remota ajuda a comparar essas camadas.

Distinguir autenticação de conectividade

Se o Mac conseguir detetar o servidor, mas a autenticação falhar, compare a mesma conta do ZimaOS na interface web local. Se a conta funcionar no navegador, mas não no ZimaClient, é provável que o problema esteja no estado do cliente/sessão e não na própria palavra-passe.

Se nem o navegador nem o cliente conseguirem aceder ao servidor através do IP, resolva primeiro os problemas do servidor ou da LAN.

Verifique a permissão de rede local no macOS

O macOS pode restringir a capacidade de uma aplicação detetar dispositivos na rede local. Se o ZimaClient não apresentar um dispositivo ZimaOS próximo, reveja a permissão de Rede local da aplicação nas definições de Privacidade e segurança do macOS e reinicie o cliente depois de a alterar.

Reponha apenas a camada que está avariada

Não reponha o servidor ZimaOS, o Remote ID, a palavra-passe e a instalação do cliente todos ao mesmo tempo. Altere uma camada de cada vez, para saber o que resolveu efetivamente o problema.

O caso de origem é um bom exemplo: reiniciar o servidor e reinstalar o cliente não ajudou; terminar e iniciar sessão novamente ajudou. Estas evidências apontam para o estado da sessão e não para uma instalação do servidor danificada.

Quando utilizar um percurso remoto alternativo

Se o ZimaClient continuar indisponível, mas o próprio servidor estiver saudável, um percurso Tailscale ou WireGuard configurado separadamente pode manter o acesso de administração disponível enquanto recolhe os registos. Utilize-o como um percurso de rede independente, não como prova de que o problema do ZimaClient foi resolvido.

Perguntas frequentes

Porque é que reinstalar o ZimaClient não ajudou?

Uma reinstalação pode deixar inalteradas as condições da conta/sessão ou da rede. No caso de origem verificado, terminar e iniciar sessão novamente foi a ação que restabeleceu o serviço.

Porque é que o SMB pode funcionar enquanto o ZimaClient falha?

O SMB na LAN e a conectividade remota/de sessão do ZimaClient são camadas diferentes. Uma pode funcionar enquanto a outra está avariada.

Onde estão os registos do ZimaClient no Mac?

A documentação oficial atual indica ~/Library/Application Support/Zima/logs.

Devo repor a palavra-passe do ZimaOS?

Não apenas porque o ZimaClient apresenta “A ligar”. Primeiro verifique o início de sessão direto, termine e inicie sessão novamente, verifique o estado da rede e consulte os registos.