Solution communautaire

ZimaOS bloqué sur « Recherche d’une adresse réseau » avec RTL8125D

A December 2025 installation on a Gigabyte X870I board stalled at network discovery. The community suspected missing RTL8125D support in that installer build and suggested temporary USB Ethernet.

Si l’installateur de ZimaOS reste bloqué sur « Recherche d’une adresse réseau » et n’obtient jamais d’adresse IP, déterminez d’abord si le contrôleur Ethernet est détecté et si la liaison est établie. Dans ce cas de décembre 2025, un système Gigabyte X870I Aorus Pro Ice utilisait un contrôleur Realtek RTL8125D 2,5 GbE, et l’installateur ne parvenait jamais à obtenir une adresse réseau utilisable.

Un membre de la communauté a attribué cette défaillance précise à la prise en charge des pilotes dans la version de l’installateur disponible à l’époque et a suggéré d’utiliser temporairement un adaptateur Ethernet USB. Le fil ne contenait ni confirmation d’un ingénieur d’IceWhale ni test ultérieur avec la version actuelle de ZimaOS. Il ne faut donc pas en faire une affirmation définitive selon laquelle le RTL8125D ne serait pas pris en charge.

L’installateur n’avait aucune adresse à afficher

L’utilisateur a atteint l’étape d’installation qui recherche une adresse, mais n’a pas obtenu d’adresse IP. Cette situation est différente de celle où un navigateur ne parvient pas à ouvrir ZimaOS alors que l’hôte a déjà obtenu un bail DHCP valide.

Vérifiez d’abord la liaison physique : câble, port du commutateur ou du routeur, et voyants de liaison. Consultez ensuite la liste des clients DHCP du routeur. Si la machine n’y apparaît jamais, la défaillance se situe en amont du navigateur et peut concerner la détection de la carte réseau, l’association du pilote, le DHCP ou le chemin réseau physique.

L’explication concernant le RTL8125D était un diagnostic de la communauté

L’utilisateur a identifié le contrôleur intégré comme un Realtek RTL8125D. Une réponse de la communauté indiquait que le noyau de l’installateur ZimaOS utilisé fin 2025 n’intégrait pas de prise en charge fonctionnelle de ce contrôleur et précisait qu’il n’était pas possible d’injecter simplement le pilote dans l’installateur en cours d’exécution.

Cette explication correspondait aux symptômes, mais le fil ne présentait ni journaux du noyau, ni sortie de lspci -k, ni déclaration officielle de compatibilité. Il est également antérieur aux versions ultérieures de ZimaOS. Considérez-la comme un modèle de diagnostic historique, et non comme une preuve concernant l’image actuelle.

La documentation actuelle de ZimaOS décrit largement le matériel x86-64, mais ne fournit pas de tableau exhaustif de compatibilité des cartes réseau. Si vous utilisez aujourd’hui le même contrôleur, testez la dernière version de l’installateur avant de supposer que l’ancienne limitation s’applique toujours.

Un adaptateur Ethernet USB temporaire peut aider à isoler le problème

La solution pratique proposée dans le fil consistait à effectuer l’installation avec un adaptateur Ethernet USB pris en charge. La réponse mentionnait des familles courantes de cartes réseau USB, comme RTL8153 et AX88179. L’auteur du message initial a commandé un adaptateur, mais n’est pas revenu communiquer le résultat final de l’installation.

Un adaptateur temporaire est utile, car il permet de distinguer un problème de compatibilité du contrôleur réseau du reste de l’installation. Si ZimaOS obtient une adresse et termine la configuration via Ethernet USB, la carte réseau intégrée devient la principale suspecte. Si l’adaptateur USB n’obtient pas non plus de bail DHCP, examinez le commutateur, le routeur, le câblage, le VLAN et le service DHCP avant d’incriminer le contrôleur intégré.

Retestez avec l’installateur actuel avant de conclure à un problème d’ancien pilote

ZimaOS continue d’ajouter et de réviser ses pilotes réseau. Par exemple, ZimaOS 1.7.1 a explicitement ajouté la prise en charge de be2net pour certaines cartes réseau Emulex et amélioré la mise en réseau de Docker, ce qui montre que la prise en charge réseau évolue d’une version à l’autre. Le journal des modifications de la version 1.7.1 ne prétend pas spécifiquement corriger un problème lié au RTL8125D.

Les notes de version actuelles de ZimaOS 1.7.1 constituent une meilleure référence de version que de se fier à une supposition formulée sur un forum en décembre 2025.

Informations à recueillir si l’installateur actuel échoue encore

Si le même problème survient avec une version actuelle, notez le modèle et la révision de la carte mère, le contrôleur réseau exact, la version de l’image ZimaOS, la présence ou non de voyants de liaison, l’attribution ou non d’un bail par le routeur, ainsi que le fonctionnement éventuel d’un adaptateur Ethernet USB fiable.

Si vous pouvez accéder à un terminal, recueillez les sorties de lspci -nnk, ip link et les messages pertinents du noyau, sans modifier les pilotes. Ces informations permettent de distinguer un « périphérique non détecté », un « pilote non associé », une « liaison inactive » et un « échec du DHCP ». Il s’agit de défaillances très différentes, même si l’installateur peut afficher le même écran d’attente.