La generación de miniaturas llena el almacenamiento de la aplicación porque el servidor crea muchas imágenes derivadas y las guarda en una ruta de metadatos o caché con permisos de escritura.
Una biblioteca multimedia puede conservar vídeos de varios terabytes en un grupo de discos HDD, mientras el contenedor asigna la configuración, los metadatos y la caché a una unidad SSD o de arranque mucho más pequeña. Las imágenes de capítulos, las vistas previas de reproducción, los carteles, los fondos y los archivos temporales de extracción crecen según el tiempo de funcionamiento de la biblioteca y la configuración de generación, no solo según el tamaño de los archivos originales. La solución segura comienza por identificar el tipo y la ruta exactos de los archivos derivados antes de eliminar cualquier elemento que la base de datos aún espere.
Localiza el directorio que realmente está creciendo
Mide por separado los directorios de configuración, caché, metadatos, transcodificación y temporales de la aplicación multimedia. Ordena los subdirectorios por tamaño asignado y fecha de modificación reciente mientras se ejecuta una tarea de miniaturas.
La extracción de imágenes de capítulos se describe explícitamente en las cadenas de la interfaz de Jellyfin como lenta, exigente en recursos y potencialmente capaz de requerir varios gigabytes de espacio.
Confirma si el crecimiento se produce en el montaje enlazado del host, en un volumen con nombre o en la capa escribible del contenedor. Si crece la capa del contenedor, corrige la persistencia antes de limpiar; de lo contrario, el espacio puede desaparecer de la vista de la aplicación y seguir consumiendo el almacenamiento del sistema de Docker.
Identifica qué función de imágenes creó los archivos
Separa los carteles y fondos normales de las imágenes de capítulos, las vistas previas de reproducción, las miniaturas de vista previa de vídeo, los marcadores de introducción y las ilustraciones generadas por complementos. Cada función tiene un activador y una regla de retención diferentes.
La reproducción genera muestras visuales repetidas a lo largo de la línea de tiempo de un vídeo para que los clientes puedan mostrar vistas previas al desplazarse. Las cuadrículas de imágenes resultantes dependen principalmente de la duración total, el intervalo de muestreo, la resolución, la calidad y la disposición de las teselas, no de si el original es de 1080p o 4K.
Ejecuta manualmente una tarea programada mientras observas el directorio de destino. Relaciona los nombres de archivo nuevos y las entradas de la base de datos con la función que los produjo. No desactives todos los proveedores de metadatos cuando solo una tarea de vistas previas sea la responsable.
Comprueba el intervalo, la resolución, la calidad y el alcance de la biblioteca
Anota el ancho de las miniaturas, el intervalo de muestreo, la calidad de JPEG o WebP, las dimensiones de las teselas, el número de hilos y las bibliotecas incluidas en la generación. Los intervalos más cortos y las imágenes más grandes crean más píxeles almacenados por hora de vídeo.
La generación también puede reiniciarse después de cambiar una configuración o actualizar la aplicación. Un problema de Jellyfin describe casos en los que los usuarios no podían impedir que los datos de reproducción generados anteriormente volvieran a aparecer porque desactivar la función no limpió el contenido existente.
Cambia una sola configuración en una biblioteca de prueba pequeña y compara los bytes generados por hora de contenido. Usa esa proporción medida para estimar la biblioteca completa antes de iniciar otra tarea de extracción total.
| Cambio de configuración | Efecto probable en el almacenamiento | Compensación |
|---|---|---|
| Intervalo de muestreo más largo | Menos imágenes | Vistas previas al desplazarse menos precisas |
| Menor ancho de miniatura | Archivos más pequeños | Imágenes de vista previa más suaves en el televisor |
| Menor calidad de imagen | Archivos más pequeños | Más artefactos de compresión |
| Alcance más reducido de la biblioteca | Menos almacenamiento total | Sin vistas previas para las bibliotecas excluidas |
Selecciona una configuración que se ajuste a las pantallas y al comportamiento de desplazamiento reales de los clientes, en lugar de generar derivados de la máxima calidad para cada título.
Busca conjuntos de miniaturas obsoletos o huérfanos
Compara los elementos multimedia activos con los directorios generados después de reemplazar, cambiar de nombre, mover o eliminar archivos. Los conjuntos de vistas previas antiguos pueden permanecer cuando el archivo nuevo recibe un ID de elemento o un nombre de salida diferente.
Un informe de Jellyfin muestra que las imágenes de reproducción obsoletas almacenadas junto al contenido multimedia no se eliminaron cuando se generaron nuevas vistas previas, dejando datos de reproducción obsoletos junto al conjunto actual.
Usa primero la tarea de limpieza compatible con la aplicación y verifica que exista una copia de seguridad de la base de datos de metadatos. Si es necesaria una eliminación manual, prueba con un elemento huérfano y actualízalo antes de borrar árboles de directorios grandes cuyas referencias se desconozcan.
Verifica si las imágenes deben estar en el almacenamiento de la aplicación o junto al contenido multimedia
Algunos servidores multimedia pueden guardar las ilustraciones o los datos de reproducción junto a la biblioteca, mientras que otros conservan los derivados vinculados a la base de datos dentro de los metadatos de la aplicación. Cambiar la ubicación afecta a las copias de seguridad, los permisos, la migración y el comportamiento del contenido multimedia de solo lectura.
Guardar las vistas previas junto al contenido multimedia puede mejorar la portabilidad durante las migraciones, pero también puede multiplicar los archivos pequeños en un recurso compartido HDD grande y requerir acceso de escritura a la biblioteca. Un problema de migración de Jellyfin muestra que los archivos de reproducción almacenados localmente pueden no transferirse correctamente entre instancias.
Mantén los derivados vinculados a la base de datos y los que cambian con frecuencia en un volumen de aplicación dimensionado deliberadamente, salvo que la aplicación admita por completo las imágenes locales portátiles. Mantén el recurso compartido multimedia en modo de solo lectura cuando el diseño elegido no requiera acceso de escritura.
Mueve el volumen de la aplicación sin dividir el estado de la base de datos
Si la configuración es razonable pero el volumen de la aplicación es demasiado pequeño, detén el servidor multimedia y mueve las unidades completas de configuración, metadatos y caché conforme al diseño de montajes persistentes del contenedor. Conserva la propiedad, las ACL, los archivos de la base de datos y los enlaces simbólicos.
El artículo de ZimaSpace sobre volúmenes de aplicaciones SSD para metadatos y miniaturas explica por qué estas cargas de trabajo con archivos pequeños se benefician del almacenamiento rápido, mientras que el contenido multimedia original de gran tamaño puede permanecer en discos HDD.
No muevas solo la carpeta de imágenes más grande dejando atrás las rutas de la base de datos, a menos que la aplicación admita esa división. Inicia la instancia migrada de forma aislada y confirma que las miniaturas antiguas se resuelvan antes de generar otras nuevas.
Limpia de forma segura y establece una referencia de crecimiento
Pausa las tareas de miniaturas, haz una copia de seguridad de la base de datos de la aplicación y registra el recuento actual de archivos y los bytes por tipo de derivado. Elimina únicamente el contenido obsoleto confirmado o utiliza los controles compatibles de eliminación y regeneración de la aplicación.
Un SSD lleno puede afectar a algo más que las miniaturas. Un problema de Jellyfin relaciona un SSD agotado con posibles daños en la base de datos y una vista incompleta de la biblioteca, lo que demuestra por qué quedarse sin espacio libre puede poner en riesgo el estado de la aplicación.
Después de la limpieza, ejecuta la generación en una biblioteca, mide el crecimiento diario y configura alertas antes de que el volumen de la aplicación alcance su umbral de reserva. La reparación estará completa cuando las vistas previas esperadas funcionen, los datos obsoletos no vuelvan a aparecer y el crecimiento del almacenamiento coincida con el intervalo, la resolución, la calidad y el alcance de biblioteca elegidos.
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...

