En diciembre de 2025, un tutorial de la comunidad de IceWhale publicó una extensión independiente del kernel abierto de NVIDIA para GPU RTX 50XX en una versión específica del kernel de ZimaOS. Posteriormente, un usuario confirmó que una RTX 5060 Ti de 16 GB expuso controles de la GPU a los contenedores. Otros usuarios informaron que el mismo procedimiento fallaba en ZimaOS 1.6.1 o no conseguía que una RTX 5090 funcionara.
Esto convierte la publicación en un procedimiento histórico específico de una versión, no en un comando atemporal del «último controlador de NVIDIA».
El procedimiento histórico exacto
La publicación original indicaba a los usuarios que iniciaran una sesión SSH, cambiaran a root y ejecutaran:
cd /var/lib/extensions/
wget https://github.com/jerrykuku/staff/releases/download/v0.1.3/nvidia-open-kernel-580.105.08-linux-6.12.25.raw -O nvidia-open-kernel-580.105.08-linux-6.12.25.raw
systemd-sysext refresh
install-nvidia-kernel-openNo ejecutes este bloque únicamente porque la GPU sea un modelo RTX 50XX. El nombre del archivo apunta explícitamente al kernel de Linux 6.12.25, y el comando auxiliar debe existir en la compilación de ZimaOS instalada. Haz una copia de seguridad de los datos de las aplicaciones y confirma que dispones de una vía de recuperación mediante la consola local antes de modificar las extensiones del kernel.
Haz coincidir la compilación de ZimaOS antes de instalar
- Registra la versión exacta y el kernel de ZimaOS.
- Confirma que la GPU aparece en
lspci. - Comprueba si existe
install-nvidia-kernel-open. - Confirma que el número de kernel de la extensión coincide con el kernel en ejecución.
- Lee las respuestas más recientes del hilo original para detectar regresiones.
Un usuario de ZimaOS 1.6.1 informó de Package not installed para una extensión del sistema y de install-nvidia-kernel-open: command not found. Esa es una señal para detenerse, no un motivo para improvisar otro instalador con privilegios de root.
Los controladores no pueden solucionar la ausencia de un dispositivo PCIe
Si lspci no muestra el dispositivo NVIDIA, primero soluciona los problemas de Oculink, la integridad del adaptador, la alimentación del dock, la conexión del cable y el entrenamiento del enlace PCIe. El hilo relacionado sobre la detección de Oculink demuestra por qué los ventiladores y los LED no prueban que el dispositivo haya sido enumerado.
Lo que confirmó el éxito con la RTX 5060 Ti
El éxito demostró que una combinación concreta de modelo y software funcionaba. No demostró que funcionara con Stable Diffusion, con todas las tarjetas RTX 50XX, con todos los docks ni con todas las versiones posteriores de ZimaOS.
Verifica las tres capas después de reiniciar
-
Host:
lspcidetecta la GPU ynvidia-smiinforma de ella. - Contenedor: la configuración de la aplicación de ZimaOS concede acceso a la GPU NVIDIA.
-
Aplicación: la carga de trabajo selecciona CUDA, NVENC o el backend de GPU correspondiente, y muestra un proceso en
nvidia-smi.
No uses la extensión RTX 50XX con tarjetas NVIDIA antiguas
Un usuario de una GTX 1050 Ti instaló esta extensión y perdió el acceso a NVML hasta que un miembro del equipo de IceWhale le recomendó ejecutar uninstall-nvidia-kernel-open y reiniciar. Usa la extensión únicamente con el hardware y la versión del sistema para los que fue creada.
Usa el hilo original como referencia para las actualizaciones
Como IceWhale no ha publicado un comando independiente de la versión para RTX 50XX en la guía general de instalación actual, vuelve al tutorial original sobre RTX 50XX antes de cada intento. Incluye en la solicitud de soporte la versión de ZimaOS, el kernel, el modelo de GPU, el método de conexión, la salida de lspci, la salida de nvidia-smi y el texto completo del error.
Preguntas frecuentes sobre RTX 50XX en ZimaOS
¿La extensión 6.12.25 es válida para todas las versiones de ZimaOS?
No. El nombre del archivo y los informes posteriores de fallos demuestran que es específica de una versión.
¿Ver «NVIDIA Corporation Device» garantiza que el controlador funciona?
No. La enumeración del dispositivo en el host se realizó correctamente, pero nvidia-smi también debe comunicarse con el controlador.
¿Debo instalar el controlador antes de que la GPU aparezca en lspci?
No. Primero soluciona la enumeración del hardware.
