Solution communautaire

ZimaOS Realtek 2,5 GbE n’a pas de réseau pendant l’installation : dépannage du pilote

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.

Ce cas d’installation de novembre 2025 est précieux, car l’utilisateur a effectué des tests croisés particulièrement rigoureux avant de demander de l’aide. Le contrôleur Realtek 2,5 GbE intégré de l’ASUS TUF Gaming B850M-PLUS WIFI7 fonctionnait normalement sous Proxmox, Unraid et Kubuntu sur la même machine, avec le même câble, les mêmes ports du commutateur et le même NVMe. Seul ZimaOS n’a pas réussi à activer l’interface pendant la deuxième étape de l’installation.

Ces éléments réorientent le dépannage : il faut délaisser le routeur ou le câble pour se concentrer sur la révision exacte de la carte réseau, l’association du pilote au noyau ou l’environnement de l’installateur. Le fil d’origine n’a toutefois pas abouti à une cause racine confirmée par l’ingénierie d’IceWhale ; l’explication par le pilote doit donc rester un diagnostic de la communauté.

Le matériel et la panne étaient très spécifiques

La machine concernée utilisait un AMD Ryzen 7 8700G, 64 Go de DDR5, un disque système NVMe de 512 Go et le contrôleur Ethernet Realtek 2,5 Gb intégré à la carte mère. La première étape de l’installation de ZimaOS, démarrée depuis la clé USB, s’est terminée normalement et a copié le système sur le NVMe.

L’échec ne s’est produit qu’après que l’installateur a demandé à l’utilisateur de retirer la clé USB et de démarrer depuis le NVMe installé. À ce moment-là, l’environnement de deuxième étape avait besoin du réseau pour terminer le provisionnement, mais l’interface Ethernet n’obtenait ni porteuse ni bail DHCP.

Ce que l’utilisateur a observé pendant la deuxième étape

  • Le routeur n’a jamais affiché de bail DHCP pour l’installation de ZimaOS.
  • La machine ne pouvait pas être jointe par ping et aucune interface web ZimaOS n’apparaissait.
  • Un balayage du sous-réseau n’a trouvé aucune nouvelle adresse de serveur.
  • ip a n’affichait soit que l’interface de bouclage, soit une interface de type Ethernet sans porteuse et sans adresse IPv4.
  • Plusieurs clés USB d’installation fraîchement préparées ont produit le même résultat.

Ces symptômes diffèrent de ceux d’une interface fonctionnelle qui aurait simplement une adresse IP statique incorrecte. La liaison elle-même ne devenait pas utilisable dans l’environnement ZimaOS installé.

Pourquoi les autres systèmes d’exploitation sont importants

La même carte réseau intégrée a immédiatement fonctionné sous Proxmox, Unraid et Kubuntu. Le routeur lui a attribué des adresses DHCP, les voyants de liaison se comportaient normalement et la machine était accessible sans installation supplémentaire de pilotes.

Cela ne prouve pas que ZimaOS présente un problème Realtek générique. Cela prouve en revanche que la carte réseau physique, le câblage et le chemin passant par le commutateur étaient capables de fonctionner, ce qui rend les changements répétés de câble moins utiles une fois ces vérifications déjà réussies.

La théorie r8169 contre r8125 venait de la communauté

Un intervenant de la communauté a supposé que cette implémentation Realtek 2.5GbE particulière nécessitait L’hypothèse r8169 contre r8125 venait de la communauté alors que ZimaOS le liait à r8169, ou échouait autrement à se lier au pilote attendu lors du démarrage de la deuxième étape.

C’est plausible pour certaines révisions Realtek, mais aucun employé d’IceWhale n’a confirmé publiquement, dans le fil de discussion, l’identifiant du périphérique, le module chargé ou une régression du noyau. Évitez de reformuler cette hypothèse en affirmant que « ZimaOS utilise le mauvais pilote » sans disposer des résultats réels du diagnostic.

Les trois vérifications en lecture seule demandées par la communauté

L’intervenant a demandé :

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

Ces commandes sont utiles, car elles ne modifient pas l’installation. Ensemble, elles révèlent l’identifiant du périphérique PCI, les interfaces réseau créées par Linux et indiquent si les pilotes Realtek concernés ont signalé des erreurs lors de la détection ou de la liaison.

Pour un système actuel, comparez également l’interface avec l’état Ethernet attendu dans le panneau Réseau actuel de ZimaOS. Si le noyau ne crée jamais d’interface utilisable, le problème se situe en amont de la configuration de l’interface web.

Une liste de compatibilité au niveau de la famille ne garantit pas toutes les révisions

L’auteur du message était compréhensiblement frustré, car la famille Realtek 2.5GbE figurait dans les informations de compatibilité d’IceWhale, ce qui a influencé l’achat de la carte mère. Des contrôleurs réseau vendus sous des appellations commerciales similaires peuvent malgré tout différer par leurs identifiants PCI, leurs révisions de silicium, leur micrologiciel, leurs composants PHY ou le câblage de la carte.

Un rapport de compatibilité de qualité devrait donc inclure l’identifiant exact lspci -nn identifiant, et pas seulement « Realtek 2,5 GbE ».

Le seul résultat confirmé était une solution de contournement avec une Intel X540-T1

Six jours plus tard, l’utilisateur d’origine a indiqué avoir acheté une carte réseau Intel X540-T1 et a déclaré qu’elle avait permis de contourner le problème. C’est le seul résultat confirmé par la personne ayant rencontré la défaillance.

La solution de contournement prouve que ZimaOS pouvait poursuivre l’installation lorsqu’une autre carte réseau compatible fournissait la connexion réseau. Elle n’identifie pas la raison exacte pour laquelle le périphérique Realtek intégré a échoué.

Ce que ce fil n’établit pas

  • Il ne prouve pas que toutes les cartes réseau de la classe RTL8125 échouent sous ZimaOS.
  • Il ne prouve pas que DHCP était la cause principale.
  • Il ne confirme pas la présence d’un module de noyau spécifique manquant.
  • Il ne montre pas que la licence à vie de l’utilisateur a eu une incidence sur la prise en charge matérielle.
  • Il ne contient pas de correctif officiel définitif du pilote IceWhale.

Une meilleure méthode de dépannage aujourd’hui

  1. Notez l’ID PCI exact de la carte réseau.
  2. Vérifiez les voyants de liaison et le comportement du port du routeur.
  3. Vérifiez si Linux crée une interface Ethernet.
  4. Examinez les messages du pilote correspondant au contrôleur exact.
  5. Comparez si nécessaire le comportement avec une autre image Linux récente.
  6. Si une seconde carte réseau connue comme compatible permet à ZimaOS de terminer l’installation, conservez les informations de diagnostic du contrôleur défaillant pour un rapport de compatibilité au lieu de réinstaller sans cesse.

FAQ d’installation des cartes réseau Realtek 2,5 GbE

La carte réseau intégrée était-elle physiquement défectueuse ?

Les tests croisés tendent à l’infirmer. Il a fonctionné immédiatement sous plusieurs autres systèmes d’exploitation.

r8169 était-il définitivement le mauvais pilote ?

Non. Il s’agissait d’une hypothèse de la communauté que le fil public n’a jamais confirmée avec les résultats demandés.

Quelle solution de contournement a été confirmée ?

L’utilisateur d’origine a installé une carte réseau Intel X540-T1 et a pu contourner le problème d’installation.

Dois-je remplacer ma carte réseau avant de recueillir les journaux ?

Si possible, recueillez d’abord l’ID PCI, l’état de l’interface et les messages pertinents du pilote. Ces informations sont bien plus utiles pour déterminer si une version actuelle de ZimaOS présente toujours le même problème de compatibilité.