Solução da comunidade

O ZimaOS Realtek 2.5GbE não tem rede durante a instalação: resolução de problemas do controlador

A November 2025 installation case where an ASUS B850M board's onboard Realtek 2.5GbE worked in Proxmox, Unraid, and Kubuntu but not during ZimaOS's second install stage. A community reply suspected r8169 versus r8125 binding, while the user ultimately bypassed the issue with an Intel X540-T1 NIC.

Este caso de instalação de novembro de 2025 é valioso porque o utilizador realizou testes cruzados invulgarmente completos antes de pedir ajuda. O controlador Realtek 2.5GbE integrado numa ASUS TUF Gaming B850M-PLUS WIFI7 funcionava normalmente com Proxmox, Unraid e Kubuntu na mesma máquina, utilizando o mesmo cabo, as mesmas portas do switch e o mesmo NVMe. Apenas o ZimaOS não conseguiu ativar a interface durante a segunda fase da instalação.

Essas evidências desviam o diagnóstico do router ou do cabo e apontam para a revisão exata da NIC, a associação do controlador do kernel ou o ambiente do instalador. No entanto, o tópico de origem não chegou a uma causa-raiz confirmada pela engenharia da IceWhale, pelo que a explicação do controlador deve continuar a ser considerada um diagnóstico da comunidade.

O hardware e a falha eram altamente específicos

A máquina indicada utilizava um AMD Ryzen 7 8700G, 64 GB de DDR5, um disco de sistema NVMe de 512 GB e a ligação Ethernet Realtek de 2,5 Gb integrada na motherboard. A primeira fase da instalação do ZimaOS, iniciada pela pen USB, foi concluída normalmente e copiou o sistema para o NVMe.

A falha ocorria apenas depois de o instalador pedir ao utilizador para remover a pen USB e arrancar a partir do NVMe instalado. Nessa altura, o ambiente da segunda fase precisava de rede para concluir o aprovisionamento, mas a interface Ethernet não obtinha portadora nem uma concessão DHCP.

O que o utilizador observou durante a segunda fase

  • O router nunca mostrava uma concessão DHCP para a instalação do ZimaOS.
  • Não era possível fazer ping à máquina e não aparecia nenhuma interface Web do ZimaOS.
  • Uma verificação da sub-rede não encontrou nenhum endereço novo de servidor.
  • ip a apresentava apenas a interface de loopback ou uma interface do tipo Ethernet sem portadora e sem endereço IPv4.
  • Várias pens USB de instalação novas produziram o mesmo resultado.

Estes sintomas são diferentes dos de uma interface funcional que apenas tem o IP estático incorreto. A própria ligação não ficava utilizável no ambiente ZimaOS instalado.

Porque são importantes os outros sistemas operativos

A mesma NIC integrada funcionou imediatamente no Proxmox, Unraid e Kubuntu. O router atribuiu endereços DHCP, os LEDs da ligação comportaram-se normalmente e a máquina ficou acessível sem instalar controladores adicionais.

Isso não prova que o ZimaOS tenha um erro genérico com a Realtek. Prova, sim, que a NIC física, a cablagem e o percurso através do switch eram capazes de funcionar, o que torna menos útil trocar repetidamente os cabos depois de esses controlos já terem sido aprovados.

A teoria do r8169 versus r8125 veio da comunidade

Um participante da comunidade suspeitou que esta implementação específica de Realtek 2.5GbE precisava de r8125 enquanto o ZimaOS o associava a r8169ou, de outra forma, ao falhar a associação ao controlador esperado durante o arranque da segunda fase.

Isso é plausível para algumas revisões Realtek, mas nenhum funcionário da IceWhale confirmou, no tópico público, o ID do dispositivo, o módulo carregado ou uma regressão do kernel. Evite reformular a teoria como «o ZimaOS utiliza o controlador errado» sem os resultados reais do diagnóstico.

As três verificações só de leitura solicitadas pela comunidade

O participante que respondeu pediu:

lspci -nn | grep -i ethernet
ip a
dmesg | grep -i -e r8169 -e r8125 -e realtek

Estes comandos são úteis porque não modificam a instalação. Em conjunto, mostram o ID do dispositivo PCI, quais as interfaces de rede que o Linux criou e se os controladores Realtek relevantes comunicaram erros de deteção ou de ligação.

Num sistema atual, compare também a interface com o estado Ethernet esperado no painel de Rede do ZimaOS atual. Se o kernel nunca criar uma interface utilizável, o problema é anterior à configuração na interface Web.

Uma listagem de compatibilidade ao nível da família não é uma garantia para todas as revisões

O autor da publicação original ficou compreensivelmente frustrado porque a família Realtek 2.5GbE aparecia nas informações de compatibilidade da IceWhale, o que influenciou a compra da placa-mãe. Os controladores de rede vendidos com nomes de marketing semelhantes podem ainda diferir nos IDs PCI, nas revisões do silício, no firmware, nos componentes PHY ou na cablagem da placa.

Por conseguinte, um relatório de compatibilidade de elevada qualidade deve incluir o identificador exato lspci -nn identificador, não apenas “Realtek 2.5GbE”.

O único resultado confirmado foi uma solução alternativa com uma Intel X540-T1

Seis dias depois, o utilizador original informou que tinha comprado uma NIC Intel X540-T1 e afirmou que esta contornou o problema. Esse é o único resultado confirmado pela pessoa que teve a falha.

A solução alternativa prova que o ZimaOS podia continuar a instalação quando outra NIC compatível fornecia a ligação de rede. Não identifica o motivo exato pelo qual o dispositivo Realtek integrado falhou.

O que este tópico não estabelece

  • Não prova que todas as NIC da classe RTL8125 falhem no ZimaOS.
  • Não prova que o DHCP tenha sido a causa principal.
  • Não confirma um módulo específico do kernel em falta.
  • Não demonstra que a licença vitalícia do utilizador tenha afetado o suporte de hardware.
  • Não contém uma correção oficial final do controlador por parte da IceWhale.

Um caminho de resolução de problemas melhor atualmente

  1. Registe o ID PCI exato da NIC.
  2. Confirme os LEDs de ligação e o comportamento da porta do router.
  3. Verifique se o Linux cria uma interface Ethernet.
  4. Verifique as mensagens do controlador correspondente ao controlador exato.
  5. Compare o comportamento com outra imagem Linux recente, se necessário.
  6. Se uma segunda NIC conhecida como compatível permitir que o ZimaOS conclua a instalação, preserve os diagnósticos do controlador que falhou para um relatório de compatibilidade, em vez de reinstalar repetidamente.

FAQ de instalação da Realtek 2.5GbE

A NIC integrada estava fisicamente avariada?

Os testes cruzados apontam contra essa conclusão. Funcionou imediatamente em vários outros sistemas operativos.

O r8169 era definitivamente o controlador errado?

Não. Tratava-se de uma teoria da comunidade que o tópico público nunca confirmou com o resultado solicitado.

Que solução alternativa foi confirmada?

O utilizador original instalou uma placa de rede Intel X540-T1 e conseguiu contornar o problema de instalação.

Devo substituir a minha NIC antes de recolher os registos?

Se possível, recolha primeiro o ID PCI, o estado da interface e as mensagens relevantes do controlador. Esses detalhes são muito mais úteis para determinar se uma versão atual do ZimaOS ainda apresenta a mesma lacuna de compatibilidade.