¿Por qué un escaneo de la biblioteca multimedia no encuentra películas en un recurso compartido montado?
Un análisis multimedia omite películas cuando el servidor no puede recorrer la ruta montada, ve una ruta diferente o rechaza los archivos durante la identificación.
En un NAS doméstico, que «el recurso compartido esté montado» puede significar únicamente que el shell del host puede ver un directorio. El proceso del servidor multimedia puede estar dentro de Docker, usar otra ruta de enlace, ejecutarse con un UID diferente o analizar un punto de montaje local vacío que quedó después de que se desconectara el recurso compartido remoto. Diagnostica una película ausente desde el almacenamiento hasta la aplicación en lugar de iniciar repetidamente análisis completos que no pueden reparar un fallo de ruta, permisos, nombres o análisis sintáctico.
Demuestra que el recurso compartido montado contiene la película ahora mismo
Comprueba la ruta exacta de origen de la biblioteca desde el host y muestra una película ausente por su nombre de archivo completo. Confirma el tipo de sistema de archivos, el origen del montaje, las opciones de montaje, el espacio libre y el recuento de archivos conocidos, en lugar de confiar únicamente en que exista el directorio del punto de montaje.
Un recurso compartido de red desconectado puede dejar un directorio local vacío normal en el mismo punto de montaje, lo que permite que un análisis termine sin encontrar contenido multimedia. Un informe de Jellyfin describe un análisis que pareció completarse correctamente aunque la ruta de destino resolvía cero elementos.
Lee una pequeña parte del archivo ausente y muestra sus directorios principales. Si el recurso compartido no está disponible, restaura el montaje antes de analizar y configura el servicio multimedia para que se inicie solo después de que el sistema de archivos remoto esté disponible. No añadas el punto de montaje local vacío como una segunda ruta de biblioteca.
Comprueba la ruta desde dentro del contenedor del servidor multimedia
Entra en el contenedor en ejecución e inspecciona la ruta exacta configurada en la biblioteca. El host puede usar /mnt/media/movies, mientras que el contenedor la ve como /media/movies; solo la ruta del contenedor debe configurarse en la aplicación.
El contenido nuevo puede seguir siendo invisible aunque los elementos antiguos continúen reproduciéndose si el contenedor en ejecución ya no ve la ruta actual del host o recibe contenido obsoleto del montaje. Un caso de Jellyfin informó que el contenido nuevo no aparecía después de análisis repetidos.
Compara la definición del montaje del contenedor con el montaje efectivo mostrado por el entorno de ejecución. Verifica que el origen del enlace sea el recurso compartido realmente montado, no un directorio principal ni una ruta obsoleta. Recrea el contenedor solo después de confirmar que sus montajes de configuración persistente y de la base de datos no han cambiado.
Prueba el recorrido de directorios con el usuario real del servicio
Usa el UID y el GID del servidor multimedia para mostrar cada directorio desde la raíz de la biblioteca hasta el archivo de la película. No basta con poder leer el archivo; el proceso también necesita permiso de ejecución en cada directorio principal para recorrer la ruta.
Un problema de visibilidad de la biblioteca de Jellyfin identifica la falta de permisos de lectura y ejecución de directorios como causa directa de que los elementos no aparezcan. El límite importante es el permiso para recorrer directorios, no que una cuenta de administrador pueda explorar el recurso compartido.
Corrige la regla de propiedad, grupo o ACL más específica que proporcione al servicio acceso de solo lectura al contenido multimedia. La guía de ZimaSpace sobre los permisos después de mover archivos ofrece el flujo de trabajo relacionado cuando el recurso compartido funciona mediante SMB, pero no dentro del contenedor.
Compara una película ausente con una película detectada
Elige dos carpetas bajo el mismo recurso compartido montado: una película que la biblioteca detecta y otra que omite. Compara el nombre de archivo, la extensión, la profundidad de la carpeta, las mayúsculas y minúsculas, los caracteres especiales, el tamaño del archivo, el uso de enlaces simbólicos, los permisos, las marcas de tiempo y si el archivo está completo.
Algunos fallos del escáner afectan a elementos concretos y no a todo el recurso compartido. Un caso de Jellyfin informó de películas que aparecían únicamente después de ser movidas a otra carpeta, lo que demuestra por qué resulta más útil comparar de forma controlada un elemento detectado con uno ausente que realizar otro análisis global.
Cambia el nombre o mueve únicamente un elemento de prueba copiado a una estructura sencilla, como Movies/Movie Name (Year)/Movie Name (Year).mkv. Si la copia aparece, inspecciona los nombres de la carpeta original, los marcadores ocultos, los permisos o el comportamiento del sistema de archivos antes de modificar toda la biblioteca.
Lee el registro del escáner en la primera ruta ausente
Inicia un análisis específico y sigue el registro desde el momento en que el escáner entra en el directorio afectado. Busca mensajes de acceso denegado, directorio no encontrado, errores de E/S, archivos no compatibles, fallos de detección, restricciones de la base de datos, errores del proveedor de metadatos y cancelaciones del análisis.
Un análisis completo puede detenerse u omitir trabajo después de una excepción relacionada con una ruta, mientras que la interfaz de usuario solo muestra una biblioteca incompleta. Jellyfin ha documentado análisis afectados por una excepción de directorio ausente, por lo que el primer error es más importante que el indicador de progreso final.
Corrige el primer error reproducible y vuelve a ejecutar el análisis más pequeño posible. No elimines la base de datos de la biblioteca, los metadatos ni la caché hasta demostrar que la ruta y los permisos son correctos; los reinicios destructivos pueden eliminar pruebas de diagnóstico sin reparar el recurso compartido montado.
Verifica la solución con una importación controlada y un reinicio
Añade una película de prueba con un nombre limpio al mismo recurso compartido, analiza la biblioteca afectada y confirma que aparece una sola vez con la ruta y los metadatos correctos. Después, reinicia el contenedor y reinicia el host.
Después del reinicio, confirma que el recurso compartido remoto se monta antes que el servicio multimedia, que el contenedor ve la ruta con su contenido, que el usuario del servicio puede recorrerla y que el escáner detecta un archivo de prueba nuevo sin cambios manuales en los permisos.
La reparación solo está completa cuando las películas realmente ausentes aparecen desde su ubicación montada prevista, no se analiza ningún directorio de respaldo vacío y el resultado se mantiene después de volver a montar el recurso, recrear el contenedor y reiniciar el host. Elimina la copia de prueba después de confirmar que la ruta original de la biblioteca es estable.
Productos recomendados
Soporte y Consejos
Más para leer
¿Puede Plex compartir una GPU con otro contenedor de Docker?
Plex y otro contenedor suelen poder acceder a la misma GPU, pero debes probar la compatibilidad de los controladores, la asignación de dispositivos, la...
Cómo saber si un error de Plex proviene del cliente o del servidor
Reproduce el mismo elemento en otro cliente, compara la ruta de la sesión y recopila pruebas del servidor solo después de que el alcance...
Cómo configurar la caché de Plex y el almacenamiento temporal para la transcodificación
Protege el estado persistente de Plex mientras colocas los archivos temporales de transcodificación en un almacenamiento local adecuado; después, verifica la limpieza, el espacio...
