Solución de la comunidad

Wi-Fi RTL8188CE en ZimaOS: comprobaciones del controlador y soluciones más seguras

A DIY ZimaOS user could not detect an RTL8188CE card on kernel 6.12.25; IceWhale said it would try to integrate support.

Si una tarjeta Realtek RTL8188CE es invisible en ZimaOS, determina primero si el dispositivo PCIe se detecta y si el kernel incluye el módulo rtl8192ce antes de intentar compilar un controlador antiguo de GitHub. RTL8188CE es compatible con el controlador ascendente de Linux rtl8192ce, pero eso no demuestra que el módulo o el firmware estén incluidos en todas las compilaciones de ZimaOS.

El hilo comunitario de 2025 terminó con IceWhale diciendo que intentaría integrar la compatibilidad, no con una solución verificada por un usuario. La documentación actual de compatibilidad de ZimaOS enumera adaptadores probados, como Intel AX210, pero no RTL8188CE, por lo que esta tarjeta aún debe considerarse un caso de compatibilidad que hay que verificar, y no hardware plug-and-play garantizado.

Paso 1: Comprueba si PCIe detecta la tarjeta Wi-Fi

Ejecuta:

lspci -nn | grep -i -E 'network|wireless'

Si RTL8188CE no aparece en absoluto, el problema está por debajo de NetworkManager. Vuelve a insertar la tarjeta, comprueba la ranura y, si es posible, prueba la tarjeta en otro sistema.

Paso 2: Comprueba el controlador de Linux esperado

El kernel de Linux ascendente identifica rtl8192ce como el controlador PCIe para el hardware RTL8192CE y RTL8188CE. La documentación de controladores inalámbricos de Linux documenta esta correspondencia.

Comprueba si el kernel de ZimaOS tiene el módulo:

modinfo rtl8192ce
lsmod | grep rtl8192ce

Si modinfo indica que no se encuentra el módulo, un árbol de código fuente de terceros antiguo probablemente no sea la solución más limpia en un sistema operativo appliance.

Paso 3: Inspecciona los mensajes del kernel

Ejecuta:

dmesg | grep -i -E 'rtl|firmware|wifi|wlan'

Esto permite distinguir entre «falta el controlador», «el controlador se cargó, pero falló el firmware» o «el dispositivo se inicializó, pero NetworkManager no creó una interfaz utilizable».

Paso 4: Comprueba si NetworkManager detecta la red Wi-Fi

Si el controlador se carga correctamente, comprueba:

ip link
nmtui

Si existe una interfaz inalámbrica, pero no aparecen SSID, el problema ha pasado de la detección de PCIe/controlador al firmware, la regulación, la radio o el comportamiento de NetworkManager.

Por qué el antiguo controlador de GitHub no es la mejor primera solución

El hilo de origen enlazaba a un controlador RTL8188CE mantenido por la comunidad cuya compatibilidad documentada con el kernel está rezagada respecto a los kernels modernos. El propio kernel de Linux ya incluye compatibilidad con RTL8188CE mediante rtl8192ce. Sustituir los módulos inalámbricos integrados en el kernel por una compilación externa más antigua puede crear incompatibilidades de versiones y es posible que se pierda en la siguiente actualización de ZimaOS.

Como ZimaOS utiliza un sistema de tipo appliance, evita tratarlo como Ubuntu y ejecutar un procedimiento largo de instalación de paquetes y compilación, salvo que IceWhale documente específicamente ese flujo para tu versión.

Usa un adaptador de compatibilidad conocida cuando la fiabilidad sea importante

La lista de adaptadores de red de ZimaOS actual incluye el Intel AX210 entre los adaptadores probados. La guía de Wi-Fi para AX210 independiente ofrece un flujo de trabajo de referencia compatible.

Si la conexión Wi-Fi es esencial para un servidor y el módulo RTL8188CE no está presente en tu compilación, cambiar a hardware compatible conocido suele ser más seguro que mantener un módulo del kernel externo.

Cómo informar correctamente sobre la ausencia del controlador

Incluye la versión de ZimaOS, uname -r, lspci -nn salida de modinfo rtl8192ce resultado y la salida pertinente de dmesg líneas. Esto indica al equipo de soporte si falta el hardware, si se omitió el módulo o si falla la inicialización del firmware.

La guía de solución de problemas de ZimaOS proporciona un marco de escalado más amplio.

Preguntas frecuentes

¿Qué controlador de Linux utiliza RTL8188CE?

La documentación ascendente sobre redes inalámbricas de Linux asigna los dispositivos PCIe RTL8188CE a rtl8192ce controlador.

¿Eso significa que RTL8188CE funcionará garantizadamente en ZimaOS?

No. La compatibilidad del kernel ascendente no garantiza que una compilación concreta de ZimaOS incluya el módulo, el firmware o una integración probada para ese adaptador.

¿Debería compilar el controlador rtl8188ce de GitHub?

No como primer paso. Comprueba primero el módulo integrado en el kernel. Un controlador externo puede dejar de funcionar tras las actualizaciones del kernel y es más difícil de mantener en ZimaOS.

¿Por qué no aparece la tarjeta en nmtui?

Si no existe ninguna interfaz inalámbrica, es posible que el controlador no se haya cargado o que no se detecte el dispositivo. Diagnostica la compatibilidad con PCIe y el kernel antes de revisar la configuración de NetworkManager.