Si el instalador de ZimaOS permanece en «Buscando una dirección de red» y nunca recibe una dirección IP, determina primero si el controlador Ethernet se detecta y establece el enlace. En este caso de diciembre de 2025, un sistema Gigabyte X870I Aorus Pro Ice utilizaba un controlador Realtek RTL8125D 2.5GbE y el instalador nunca llegó a obtener una dirección de red utilizable.
Un miembro de la comunidad atribuyó ese fallo concreto a la compatibilidad de controladores de la compilación del instalador disponible en ese momento y sugirió usar temporalmente Ethernet por USB. El hilo no incluía una confirmación de ingeniería de IceWhale ni una prueba posterior con el ZimaOS actual, por lo que no debe convertirse en una afirmación permanente de que RTL8125D no es compatible.
El instalador no tenía ninguna dirección que mostrar
El usuario llegó a la fase de instalación que busca una dirección, pero no recibió ninguna IP. Esto es distinto de que un navegador no pueda abrir ZimaOS después de que el equipo ya haya obtenido una concesión DHCP válida.
Comprueba primero el enlace físico: el cable, el puerto del conmutador o del router y los indicadores LED del enlace. Después, consulta la lista de clientes DHCP del router. Si el equipo nunca aparece, el fallo se encuentra por debajo del navegador y puede deberse a la detección de la tarjeta de red, la asociación del controlador, DHCP o la ruta física de red.
La explicación sobre RTL8125D fue un diagnóstico de la comunidad
El usuario indicó que el controlador integrado era un Realtek RTL8125D. Una respuesta de la comunidad afirmó que el núcleo del instalador de ZimaOS utilizado a finales de 2025 no incluía compatibilidad funcional con ese controlador y que el controlador no podía inyectarse simplemente en el instalador en ejecución.
La explicación encajaba con el síntoma, pero el hilo no mostraba registros del núcleo, lspci -k ni una declaración oficial de compatibilidad. Además, es anterior a versiones posteriores de ZimaOS. Úsala como un patrón de diagnóstico histórico, no como una prueba sobre la imagen actual.
La documentación actual de ZimaOS describe de forma general el hardware x86-64, pero no proporciona una tabla exhaustiva de compatibilidad de tarjetas de red. Si tienes hoy el mismo controlador, prueba el instalador más reciente antes de asumir que la antigua limitación sigue vigente.
Un adaptador Ethernet USB temporal puede ayudar a aislar el problema
La solución práctica propuesta en el hilo fue instalar mediante un adaptador Ethernet USB compatible. La respuesta mencionaba familias habituales de tarjetas de red USB, como RTL8153 y AX88179. El autor original de la publicación pidió un adaptador, pero no volvió para informar del resultado final de la instalación.
Un adaptador temporal es útil porque separa la compatibilidad del controlador de red del resto de la instalación. Si ZimaOS obtiene una dirección y completa la configuración mediante Ethernet USB, la ruta de la tarjeta de red integrada se convierte en la principal sospechosa. Si el adaptador USB tampoco obtiene una concesión DHCP, investiga el conmutador, el router, el cableado, la VLAN y el servicio DHCP antes de culpar al controlador integrado.
Vuelve a probar con el instalador actual antes de aplicar una conclusión antigua sobre el controlador
ZimaOS ha seguido incorporando y revisando controladores de red. Por ejemplo, ZimaOS 1.7.1 añadió explícitamente compatibilidad con be2net para determinadas tarjetas de red Emulex y mejoró las redes de Docker, lo que demuestra que la compatibilidad de red cambia entre versiones. El registro de cambios de la versión 1.7.1 no afirma específicamente que se haya corregido RTL8125D.
Las notas de la versión actual de ZimaOS 1.7.1 ofrecen un límite de versión más fiable que basarse en una suposición de un foro de diciembre de 2025.
Qué registrar si el instalador más reciente sigue fallando
Si el mismo problema ocurre en una compilación actual, registra el modelo y la revisión de la placa base, el controlador exacto de la tarjeta de red, la versión de la imagen de ZimaOS, si aparecen los indicadores LED del enlace, si el router concede una dirección y si funciona un adaptador Ethernet USB conocido por funcionar correctamente.
Si puedes acceder a un shell, recopila lspci -nnk, ip link y los mensajes pertinentes del núcleo sin modificar los controladores. Esos resultados permiten distinguir entre «dispositivo no detectado», «controlador no asociado», «enlace desactivado» y «fallo de DHCP», que son problemas muy diferentes aunque el instalador muestre la misma pantalla de espera.
