Se o instalador do ZimaOS permanecer em «A procurar o endereço de rede» e nunca receber um endereço IP, determine primeiro se o controlador Ethernet é detetado e estabelece ligação. Neste caso de dezembro de 2025, um sistema Gigabyte X870I Aorus Pro Ice utilizava um controlador Realtek RTL8125D 2.5GbE e o instalador nunca avançou para um endereço de rede utilizável.
Um membro da comunidade atribuiu essa falha específica ao suporte de controladores na versão do instalador disponível na altura e sugeriu utilizar temporariamente Ethernet por USB. O tópico não incluía uma confirmação por parte da engenharia da IceWhale nem um teste posterior numa versão atual do ZimaOS, pelo que não deve ser transformado numa afirmação permanente de que o RTL8125D não é suportado.
O instalador não tinha nenhum endereço para apresentar
O utilizador chegou à fase da instalação que procura um endereço, mas não recebeu nenhum IP. Isto é diferente de um navegador não conseguir abrir o ZimaOS depois de o anfitrião já ter obtido uma concessão DHCP válida.
Verifique primeiro a ligação física: o cabo, a porta do switch ou do router e os LEDs de ligação. Em seguida, consulte a lista de clientes DHCP do router. Se a máquina nunca aparecer, a falha ocorre antes do navegador e pode envolver a deteção da placa de rede, a associação do controlador, o DHCP ou o caminho físico da rede.
A explicação sobre o RTL8125D foi um diagnóstico da comunidade
O utilizador indicou que o controlador integrado era um Realtek RTL8125D. Uma resposta da comunidade afirmou que o kernel do instalador do ZimaOS utilizado no final de 2025 não incluía suporte funcional para esse controlador e que o controlador não podia simplesmente ser injetado no instalador em execução.
Essa explicação era compatível com o sintoma, mas o tópico não apresentava registos do kernel, lspci -k nem uma declaração oficial de compatibilidade. Além disso, antecede versões posteriores do ZimaOS. Utilize-a como padrão de diagnóstico histórico, não como prova relativa à imagem atual.
A documentação atual do ZimaOS descreve genericamente hardware x86-64, mas não fornece uma tabela exaustiva de compatibilidade de placas de rede. Se tiver hoje o mesmo controlador, teste o instalador mais recente antes de presumir que a limitação antiga ainda se aplica.
Um adaptador Ethernet USB temporário pode isolar o problema
A solução prática proposta no tópico foi instalar através de um adaptador Ethernet USB compatível. A resposta mencionava famílias comuns de placas de rede USB, como RTL8153 e AX88179. O autor original encomendou um adaptador, mas não voltou a publicar o resultado final da instalação.
Um adaptador temporário é útil porque separa a compatibilidade do controlador de rede do resto da instalação. Se o ZimaOS obtiver um endereço e concluir a configuração através de Ethernet USB, o percurso da placa de rede integrada torna-se o principal suspeito. Se o adaptador USB também não obtiver uma concessão DHCP, investigue o switch, o router, a cablagem, a VLAN e o serviço DHCP antes de culpar o controlador integrado.
Teste novamente com o instalador atual antes de tirar conclusões com base num controlador antigo
O ZimaOS tem continuado a adicionar e rever controladores de rede. Por exemplo, o ZimaOS 1.7.1 adicionou explicitamente suporte para be2net a determinadas placas de rede Emulex e melhorou a rede do Docker, demonstrando que o suporte de rede muda entre versões. O registo de alterações da versão 1.7.1 não afirma especificamente que tenha corrigido o RTL8125D.
As notas de lançamento atuais do ZimaOS 1.7.1 constituem uma referência de versão mais adequada do que uma suposição de um fórum de dezembro de 2025.
O que registar se o instalador mais recente continuar a falhar
Se o mesmo problema ocorrer numa versão atual, registe o modelo e a revisão da placa-mãe, o controlador exato da placa de rede, a versão da imagem do ZimaOS, se os LEDs de ligação acendem, se o router atribui uma concessão e se um adaptador Ethernet USB conhecido por funcionar tem êxito.
Se conseguir aceder a uma shell, recolha lspci -nnk, ip link e as mensagens relevantes do kernel sem modificar os controladores. Estes dados permitem distinguir entre «dispositivo não detetado», «controlador não associado», «ligação inativa» e «falha do DHCP», que são falhas muito diferentes, embora o instalador possa apresentar o mesmo ecrã de espera.
