Solução da comunidade

O Wi-Fi do ZimaOS apresenta o estado de rede errado: interface sem fios não suportada e falhas reais de encaminhamento

A June 2025 ZimaOS report where Wi-Fi and a static IP worked at the NetworkManager level while the dashboard and server screen still showed incomplete network status, followed by an official statement that Wi-Fi was not supported at that time and later routing-focused troubleshooting.

Um aviso de estado da rede nem sempre é o mesmo que uma falha de rede. Neste tópico de junho de 2025, o utilizador original conseguia ligar-se ao ZimaOS por Wi-Fi através de um IP estático e verificar a interface sem fios por SSH, enquanto o ecrã do servidor físico continuava a apresentar «A procurar endereço de rede» e a interface Web não assinalava o Wi-Fi como ativo.

Zima-Giorgio deu a resposta oficial central: naquela altura, o ZimaOS não suportava oficialmente Wi-Fi. Isto torna muito mais fácil compreender o estado incorreto do painel: uma ligação sem fios funcional do NetworkManager estava fora do caminho de gestão de rede suportado pelo produto.

A interface sem fios podia funcionar mesmo quando o ZimaOS não a representava corretamente

O autor original confirmou que wlan0 estava ligada e tinha o endereço estático esperado. Conseguia abrir o painel do ZimaOS através desse endereço, mas o painel e o ecrã ligado continuavam a apresentar um estado de rede incompleto ou incorreto.

Painel de rede do ZimaOS a mostrar uma entrada de IP estático sem fios wlan0 que não está assinalada como ativa, enquanto uma rede virtual remota está ativa
A interface Web apresentava wlan0, mas não a mostrava como uma ligação ativa, embora o utilizador conseguisse aceder ao servidor por Wi-Fi.
Saída do nmcli no terminal do ZimaOS a mostrar a wlan0 ligada ao Wi-Fi, enquanto a interface Web apresentava incorretamente o estado sem fios
A saída do terminal no mesmo relatório mostrava a wlan0 num estado ligado, confirmando a discrepância entre o NetworkManager e a apresentação do estado no ZimaOS.

Esta é uma forte evidência de uma incompatibilidade de gestão/interface nessa configuração de 2025, não de que a ligação sem fios estivesse efetivamente desligada.

Posição oficial em 2025: o Wi-Fi não era suportado

A resposta de Zima-Giorgio foi curta, mas decisiva: nessa altura, o ZimaOS não suportava oficialmente Wi-Fi.

Isto significa que os utilizadores que configurassem manualmente a rede sem fios podiam ficar com uma ligação tecnicamente funcional que a interface do ZimaOS não compreendia nem apresentava de forma consistente.

Não trate o apk ou o apt como um caminho normal para atualizar o ZimaOS

O autor original tentou comandos de gestores de pacotes depois de descobrir que o apt não estava disponível. Essa experiência não resolveu a discrepância da interface. O ZimaOS é um sistema operativo do tipo appliance, com o seu próprio processo de atualização, pelo que não se devem promover atualizações arbitrárias dos pacotes do sistema base como solução para problemas relacionados com o estado da rede.

Utilize os processos de atualização e as opções de configuração suportados pelo ZimaOS para a versão que está a utilizar.

Uma resposta posterior revelou um problema diferente: ausência de rota predefinida

Em janeiro de 2026, outro utilizador entrou no tópico com falhas de ligação ao Home Assistant. A situação parecia semelhante à primeira vista, mas a tabela de encaminhamento publicada não continha uma rota IPv4 predefinida normal. Isso é uma falha de conectividade real, não apenas um indicador incorreto na interface.

Esta distinção é fundamental:

  • se o acesso por SSH e à Web funcionar através da interface esperada, mas o ícone da interface estiver incorreto, o problema pode estar na apresentação do estado;
  • se o sistema não tiver uma rota predefinida e não conseguir alcançar endereços IP públicos, o anfitrião não tem efetivamente um caminho de gateway utilizável.

As redes atuais do ZimaOS estão centradas nas definições de Ethernet

A documentação atual de redes do ZimaOS descreve interfaces Ethernet físicas, DHCP, configuração de IP estático, velocidade da ligação e acesso remoto através de Definições > Rede.

definições atuais de Ethernet, DHCP, IP estático e Acesso remoto no ZimaOS

Consulte a documentação atual para verificar se o suporte sem fios foi alterado para o seu hardware e versão, em vez de presumir que a declaração de suporte de junho de 2025 permanecerá inalterada para sempre.

Utilize Ethernet quando a fiabilidade da rede for essencial

Para serviços como o Home Assistant, câmaras, armazenamento ou outras cargas de trabalho sempre ativas, a comunidade recomendou repetidamente a utilização de Ethernet quando possível. Essa recomendação está alinhada com o suporte historicamente mais sólido do produto para redes com fios.

Perguntas frequentes sobre o estado do Wi-Fi no ZimaOS

Porque é que o utilizador conseguia ligar-se por SSH através do Wi-Fi enquanto o ZimaOS continuava a indicar «A procurar endereço de rede»?

A interface sem fios estava a funcionar ao nível das redes Linux, mas o ZimaOS não suportava oficialmente Wi-Fi nessa versão de 2025 e não representava corretamente a interface na sua UI.

Um ícone de Wi-Fi incorreto significa que a rede está realmente desligada?

Não necessariamente. O utilizador original conseguia aceder ao painel. As respostas posteriores mostraram que uma falha real deve ser distinguida pelo comportamento do encaminhamento e do gateway, e não apenas pelo indicador da interface.

A falha do Home Assistant na resposta posterior foi causada pelo erro de estado do Wi-Fi?

A tabela de encaminhamento publicada apontava para um problema real de ausência de rota predefinida, que é diferente da inconsistência de apresentação original.

Devo configurar serviços críticos do ZimaOS através de Wi-Fi?

Para as versões históricas discutidas neste tópico, a Ethernet era o caminho suportado mais seguro. Consulte a documentação atual relativa à sua versão exata antes de depender do Wi-Fi.