La transcodificación por hardware suele dejar de funcionar después de una actualización porque el contenedor recreado ya no ve el mismo dispositivo, grupo de permisos, capacidad del entorno de ejecución o conjunto de componentes de espacio de usuario compatible.
Es posible que la GPU del host siga funcionando, mientras que Plex, Jellyfin, Emby o una aplicación de cámara pase silenciosamente a usar la CPU después de sustituir la imagen. La primera tarea es comprobar que el dispositivo existe dentro del nuevo contenedor y que el usuario del servicio puede abrirlo. Después, hay que separar los problemas de asignación en el entorno de ejecución y permisos de las regresiones de códecs o controladores específicas de la imagen.
Confirma que la carga de trabajo realmente pasó a la codificación por software
Fuerza la transcodificación de un archivo y registra el panel del servidor multimedia, el registro de FFmpeg o del transcodificador, el uso de la CPU del host y la actividad del motor de la GPU. La reproducción directa no pone a prueba la ruta de hardware.
Un caso de la comunidad de LinuxServer recomienda comprobar un indicador explícito de hardware y la telemetría de la GPU, porque la actividad de la CPU por sí sola puede llevar a conclusiones erróneas. El indicador más útil es el uso activo del motor de la GPU durante una transcodificación controlada.
Si los registros muestran que el codificador por hardware se abre correctamente, investiga los filtros no compatibles, los subtítulos, el mapeo de tonos o la aceleración parcial. Si no se puede abrir el dispositivo, continúa con la detección en el host y el acceso desde el contenedor.
Compara los dispositivos de la GPU en el host y dentro del contenedor
Enumera los nodos de dispositivo esperados en el host y dentro del contenedor actualizado. Para VA-API de Intel o AMD, compara /dev/dri/card* y /dev/dri/renderD*; para NVIDIA, compara la visibilidad en el entorno de ejecución y los dispositivos que muestra su herramienta de administración.
Un caso de Quick Sync en Unraid muestra que el host puede necesitar el módulo de kernel correcto para que exista /dev/dri, y que el contenedor también necesita que se le pase ese dispositivo. A menudo, el elemento que falta es la asignación del dispositivo /dev/dri, y no la biblioteca multimedia ni la base de datos de la aplicación.
Si el dispositivo no está presente en el host, corrige primero el controlador, la BIOS, el kernel o el estado del hardware del host. Si existe en el host, pero no dentro del contenedor, compara la configuración de dispositivos antigua y nueva, ya sea en Compose o generada por la interfaz.
Verifica el acceso a los grupos render y video
Registra los ID numéricos de propietario y grupo de los nodos de dispositivo de la GPU en el host y, después, inspecciona los grupos asignados al usuario del servicio dentro del contenedor. Nombres como render pueden corresponder a distintos ID numéricos según la imagen.
Un caso de resolución de problemas de Jellyfin en Docker muestra una configuración funcional que coincide explícitamente con el ID del grupo de renderizado del host y comprueba los permisos de renderD128. Esa asignación numérica del grupo de renderizado puede cambiar cuando una imagen modifica sus usuarios o grupos internos.
Añade el grupo suplementario necesario mediante la definición del contenedor en vez de permitir el acceso de todos al dispositivo. Recrea el contenedor y prueba el acceso con el usuario real del servicio multimedia.
Revisa las opciones del entorno de ejecución y las capacidades específicas de la imagen
Compara las definiciones de la imagen anterior y la actual en cuanto a devices, group_add, la configuración del entorno de ejecución de la GPU, las variables de capacidad, el modo privilegiado y cualquier cambio en la plantilla del administrador de contenedores.
Un informe sobre Emby describe cómo dejó de funcionar la aceleración por hardware en Docker mientras la aplicación seguía disponible, lo que ilustra el cambio silencioso a la codificación por software tras perder acceso a la GPU que hace que este problema sea fácil de pasar por alto.
No resuelvas un problema puntual de acceso al dispositivo concediendo amplios privilegios. Restaura los permisos mínimos del dispositivo y del grupo que requiere la ruta de codificación.
Distingue una regresión de la imagen del contenedor de un fallo del host
Ejecuta una prueba sencilla de GPU o FFmpeg en el contenedor actualizado y compárala con la imagen anterior fijada usando los mismos puntos de montaje, asignaciones de dispositivos, archivo multimedia y configuración de la aplicación.
Si la imagen anterior funciona de inmediato y la nueva falla con un estado idéntico del entorno de ejecución, conserva los registros y considera que se trata de una regresión del espacio de usuario, del códec, de FFmpeg o de la aplicación. No vuelvas a modificar los permisos repetidamente cuando la comparación controlada de imágenes ya aísla la versión.
Borra únicamente las cachés de códecs regenerables documentadas cuando los registros apunten a ellas, y deja intactas la base de datos de la aplicación y los metadatos multimedia. Fija la imagen que se sabe que funciona hasta que se entienda o se corrija la regresión.
Valida toda la canalización después de la reparación
Prueba la decodificación y la codificación por hardware, la conversión de tonos, la inserción de subtítulos y al menos un cliente que fuerce la transcodificación. Confirma que el dispositivo GPU esperado aparece en los registros y que el host muestra actividad sostenida del motor.
El procedimiento de ZimaSpace para verificar la transcodificación real por hardware ofrece una prueba de finalización más sólida que activar una opción en la página de configuración.
El problema solo se considera resuelto cuando el contenedor actualizado o fijado conserva el acceso al dispositivo después de recrearse y reiniciarse, usa la GPU para la ruta de códec prevista y deja de recurrir al software sin avisar. Conserva el resumen criptográfico de la imagen anterior y la definición del entorno de ejecución como límite de reversión para la próxima actualización.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



