Solução da comunidade

Definir um IP estático no ZimaOS: use primeiro a interface gráfica e recorra ao nmcli quando necessário

The original 2024 tutorial used nmcli to set a manual IPv4 address. By 2025 users reported that static IP configuration was available in Settings; a 2026 ZimaBoard 2 user still needed nmcli once when eth1 would not open in the UI.

Este tópico de longa duração abrange várias gerações do ZimaOS, pelo que a receita original de CLI de 2024 não deve ser considerada a predefinição atual. Respostas posteriores indicaram explicitamente que a configuração de IP estático tinha sido transferida para as definições Web, enquanto, em junho de 2026, um utilizador do ZimaBoard 2 relatou um caso em que a interface não permitia editar eth1 até o NetworkManager ser ajustado manualmente.

Utilize primeiro a interface atual do ZimaOS

Se for possível editar a porta Ethernet pretendida nas Definições atuais, utilize a interface em vez de recriar um perfil de ligação a partir de um comando antigo do fórum. Isto reduz o risco de selecionar a interface errada ou de deixar perfis duplicados do NetworkManager.

O fluxo de resolução de problemas do ZimaOS é útil quando o painel ou o próprio endereço de rede não está acessível, enquanto a visão geral do Zima Client abrange o comportamento atual de descoberta e ligação do Zima. Em hardware com duas portas, o hardware do ZimaBoard 2 fornece o contexto atual do hardware Ethernet antes de decidir qual interface deverá utilizar o endereço fixo.

Se tiver de utilizar o nmcli, identifique primeiro o perfil

Não cole cegamente um nome de ligação antigo. Comece por inspecionar os perfis atuais:

nmcli connection show
nmcli device status

Os exemplos de IP estático do NetworkManager apresentam o padrão atualmente suportado para a configuração manual de IPv4. As definições IPv4 do NetworkManager confirmam que ipv4.method manual requer pelo menos um endereço e que um gateway configura a rota predefinida normal.

Porque é que a cópia e colagem antiga falhou para alguns utilizadores

O tópico documentou dois erros fáceis de cometer: o nome da ligação ativa nem sempre era exatamente Wired connection 1 e o editor do fórum tinha convertido aspas retas em aspas tipográficas.

Terminal do ZimaOS a apresentar um erro de ligação desconhecida do nmcli causado por um nome de ligação copiado
Captura de ecrã da comunidade que mostra por que motivo o nome exato da ligação do NetworkManager e os carateres de aspas são importantes nos comandos de CLI.

Se um comando indicar que a ligação é desconhecida, copie o ID exato da ligação apresentado por nmcli connection show. Não presuma que eth0, eth1, Wired connection 1 ou um nome de perfil com o prefixo Zima seja universal.

Considere antes uma reserva DHCP

Se o seu único objetivo for que o ZimaOS mantenha o mesmo endereço na LAN, uma reserva DHCP no router pode ser mais simples, pois o anfitrião continua a utilizar o endereçamento automático enquanto o router atribui consistentemente o mesmo endereço. Isto também reduz a probabilidade de criar um conflito de endereços fora do conjunto DHCP.

Em resumo

Utilize primeiro a interface de rede atual do ZimaOS. Mantenha o método antigo com nmcli como alternativa para uma porta que a interface não consiga editar e inspecione sempre o perfil de ligação atual antes de o modificar. Para um servidor doméstico normal, uma reserva DHCP no router é frequentemente a opção menos sujeita a problemas.