Este tópico de rede de novembro de 2025 não é um caso normal de “o ZimaOS não tem rede”. O servidor estava online, tinha um endereço DHCP e transferia tráfego através de uma interface Ethernet Intel I226-V; no entanto, Definições > Rede apresentava uma secção Ligação vazia e não oferecia qualquer forma de configurar um IP estático. A máquina tinha também duas portas I226-V 2.5GbE e duas interfaces Intel X710 SFP+, o que tornava este sistema com várias NIC mais complexo do que o hardware para o qual a interface de rede do ZimaOS tinha sido originalmente otimizada.
A discussão original avançou por reservas no router, troca de portas, reinícios, ETHS experiências de configuração, testes da API e, por fim, um erro que levou um membro da equipa a suspeitar de lshw análise. A conversa pública terminou depois de o utilizador enviar informações sobre o hardware em privado, pelo que não existe uma correção final publicada.
A página Rede estava vazia, embora o servidor estivesse acessível
Esta distinção é essencial. O problema não era simplesmente “não existe um controlador Ethernet”, porque pelo menos uma interface Ethernet estava ativa e a transmitir tráfego.
O servidor tinha quatro portas de rede físicas
O hardware da fonte incluía:
- duas interfaces Intel I226-V 2.5GbE;
- duas interfaces Intel X710 SFP+;
- uma plataforma AMD Ryzen 7 PRO 8845HS;
- várias unidades NVMe e planeava utilizar discos HDD de grande capacidade.
Inicialmente, o utilizador ligou-se através de uma das portas 2.5GbE e recebeu um endereço DHCP aproximadamente 192.168.1.125.
Uma reserva no router não era a causa principal
Zima-Giorgio perguntou como é que o utilizador tinha obtido o endereço. O utilizador explicou que este foi atribuído por DHCP e que o router reservou depois esse IP.
Mais tarde, removeu a reserva conforme solicitado. O ZimaOS recebeu um endereço DHCP diferente, provando que a interface continuava a conseguir comunicar com o router, mas a página Rede continuava vazia.
Este resultado negativo é importante: a interface de utilizador em falta não foi corrigida simplesmente removendo a reserva de endereço fixo do router.
Alternar entre as duas portas I226-V não corrigiu a interface de utilizador
O utilizador perguntou-se se estar ligado à segunda interface 2.5GbE, em vez da primeira, estaria a causar confusão ao ZimaOS. Moveu o cabo para a outra porta I226-V, desligou e voltou a ligar a máquina, e obteve também aí um endereço funcional.
Definições > Rede continuava sem apresentar uma interface.
ifconfig confirmou uma interface Ethernet ativa
A fonte publicou posteriormente um resultado que mostrava eth0 como:
- ATIVA e EM EXECUÇÃO;
- endereço IPv4 atribuído
192.168.1.123; - a receber e transmitir pacotes;
- a indicar zero erros de portadora.
Isso é uma forte evidência de que a interface de rede Linux estava a funcionar, enquanto a camada de gestão do ZimaOS não conseguia enumerá-la corretamente.
O tópico passou então para a configuração ETHS do ZimaOS
O ficheiro interno zimaos.conf o ficheiro mostrava ETHS = em branco. As respostas da comunidade e de pessoas próximas da equipa experimentaram então inserir endereços PCI nesse campo e reiniciar os serviços do ZimaOS.
Essas edições não fizeram com que a página Rede voltasse a funcionar para o utilizador.
Uma tentativa de ETHS tinha como alvo as interfaces erradas
O utilizador reparou que os primeiros endereços PCI sugeridos correspondiam às portas SFP+, e não às interfaces 2.5GbE. Em seguida, tentou utilizar os endereços PCI do I226-V.
Mesmo depois de corrigir os dispositivos-alvo e reiniciar os serviços, a página de definições continuava sem apresentar as interfaces. Esta é outra razão para não apresentar a ETHS editar como uma solução comprovada.
O tópico revelou uma limitação histórica nas pressuposições de hardware
Uma resposta indicou que o trabalho anterior de compatibilidade com mesh/ecrãs tinha como alvo principal dispositivos ZimaCube e que outro hardware poderia necessitar de informações PCI explícitas. Esse comentário ajuda a explicar por que razão um mini servidor genérico com quatro NICs poderia acionar um percurso que hardware mais simples não acionava.
Não deve ser interpretado como um requisito atual de que todo o hardware ZimaOS de terceiros necessite de uma ETHS configuração.
A API local de interfaces de rede produziu um erro
Depois de as alterações de configuração falharem, o tópico testou a API de rede local do ZimaOS:
curl http://127.0.0.1/v2/zimaos/network/interfacesO erro devolvido desviou a investigação da configuração de IP estático para o serviço responsável por detetar ou serializar as informações de hardware.
O diagnóstico público final apontava para a análise do lshw
Uma resposta posterior indicou que o erro da API sugeria um problema na análise de lshw informações e pediu ao utilizador que recolhesse uma listagem completa do hardware para /DATA/lshw.logO utilizador enviou então o resultado em privado.
Como o tópico público termina aí, a página não deve inventar o resultado da engenharia. A última afirmação sustentada é que a equipa suspeitava de um problema na análise das informações de hardware e transferiu o diagnóstico detalhado para mensagens privadas.
O pedido do controlador Intel X710 era um tema separado
O utilizador também queria que as duas portas X710 SFP+ fossem suportadas e, eventualmente, esperava utilizar agregação de ligações. Zima-Giorgio disse que o pedido de integração do controlador seria encaminhado para análise.
Esse pedido não deve ser confundido com a interface I226-V funcional que já transportava a ligação de gestão do ZimaOS.
Não resolva uma interface em falta na IU forçando imediatamente o nmcli
O utilizador ponderou aplicar um IP estático através de nmcli porque a interface de utilizador estava em falta. Isso pode configurar a rede do Linux, mas não corrige a razão pela qual o ZimaOS não consegue enumerar a interface; além disso, as versões posteriores do ZimaOS disponibilizam controlos de IP estático suportados nas Definições.
Num sistema atual, utilize o comportamento atual da rede do ZimaOS como referência para o que deve aparecer nas Definições.
O ZimaOS atual deve apresentar as portas Ethernet físicas
As orientações atuais de rede indicam que as interfaces Ethernet físicas devem aparecer com o nome da interface, o estado da ligação, a velocidade negociada e o endereço IP atribuído. Se o Linux tiver uma interface funcional, mas a página Rede estiver vazia, recolha diagnósticos do serviço de gestão em vez de continuar a alterar o router.
O que recolher num caso semelhante atual
- a versão exata do ZimaOS;
-
lspci -nnpara todos os controladores de rede; - o resultado atual da interface e do endereço;
- o estado da ligação de cada porta física;
- a captura de ecrã da página Rede;
- resultados das APIs de rede relevantes do ZimaOS ou dos registos, quando solicitados pelo suporte;
- um inventário de hardware, como
lshwse o serviço de enumeração parecer falhar.
O que o tópico realmente comprova
O servidor conseguia ligar-se à rede através de uma interface Intel I226-V, enquanto as Definições do ZimaOS não a mostravam. Remover a reserva do router, alternar entre portas I226-V, desligar e voltar a ligar a alimentação e efetuar alterações manuais ETHS as alterações não corrigiram a apresentação. A investigação terminou com a suspeita de um lshw problema de análise com acompanhamento privado.
Perguntas frequentes sobre interfaces de rede em falta
O servidor estava realmente offline?
Não. Tinha um endereço DHCP e a interface Ethernet ativa estava a transmitir tráfego.
Remover a reserva do router resolveu a página Rede?
Não. O servidor recebeu um novo endereço DHCP, mas os controlos da interface continuaram ausentes.
Mudar para a outra porta I226-V resolveu o problema?
Não.
As alterações manuais a ETHS resolveram o problema?
Não foi confirmada nenhuma solução pública resultante dessas experiências.
Qual foi a última pista de diagnóstico pública?
Um erro da API orientou a discussão para uma possível lshw problema de análise de informação.
