Cómo configurar la caché y el almacenamiento temporal de Immich

Configura la caché y el almacenamiento temporal de Immich separando primero el estado duradero de la biblioteca de los derivados generados, la caché de modelos reutilizable y los datos temporales desechables del contenedor.

Las miniaturas y los vídeos codificados pueden parecer una caché porque Immich puede regenerarlos, pero son recursos de trabajo persistentes cuya reconstrucción puede ser grande y costosa. Las descargas de modelos tienen un ciclo de vida diferente, mientras que los registros y los datos temporales de la capa escribible no deberían consumir silenciosamente el disco de arranque. Asigna el almacenamiento según su función y, después, prueba el comportamiento de limpieza y reinicio.

Clasifica cada función de almacenamiento antes de moverla

Crea un inventario con al menos cuatro clases: originales y estado necesario de la aplicación; miniaturas y vistas previas generadas; vídeos codificados generados; y datos de modelos, registros o ejecución temporal. Para cada clase, registra la ruta actual, el tamaño, la tasa de crecimiento, la política de copias de seguridad, el coste de reconstrucción y el servicio que escribe en ella.

Un informe de usuario sobre el crecimiento de miniaturas y vídeos generados demuestra por qué las miniaturas y los vídeos codificados deben medirse por separado. Las proporciones individuales no son universales, porque la combinación de medios y la configuración del procesamiento modifican la cantidad producida.

No etiquetes un directorio como «caché» simplemente porque eliminarlo libera espacio. Si su pérdida provoca días de regeneración, interrumpe la reproducción activa o elimina un estado que tu plan de recuperación espera conservar, merece una función persistente explícita aunque la aplicación pueda recrearlo técnicamente.

Coloca los datos generados de alta actividad donde la latencia y la resistencia sean adecuadas

Las miniaturas y las vistas previas se utilizan para la navegación interactiva y suelen implicar muchas lecturas pequeñas, mientras que los vídeos codificados pueden consumir mucha más capacidad secuencial. Un SSD rápido puede mejorar la actividad con muchos derivados, pero solo si mover esa función elimina la espera medida en lugar de crear otro volumen pequeño que se llene inesperadamente.

La explicación de ZimaSpace sobre el crecimiento del almacenamiento de miniaturas ofrece una lección de almacenamiento aplicable: el almacenamiento activo de una aplicación puede llenarse aunque los originales estén en otro lugar. Las rutas específicas de Immich son diferentes, pero el requisito de supervisar la función escribible real es el mismo.

Si los archivos multimedia principales permanecen en almacenamiento HDD o NAS mientras los derivados se trasladan a un SSD, supervisa los niveles mínimos de espacio libre y verifica cada montaje después de reiniciar. Un nivel rápido para derivados solo es útil cuando tiene el tamaño suficiente para el crecimiento normal y su fallo no puede confundirse con la pérdida de los originales autorizados.

Conserva deliberadamente la caché de modelos, pero trátala como reconstruible

Los modelos de aprendizaje automático se descargan o preparan para inferencias repetidas y pueden consumir una cantidad considerable de almacenamiento. Conservar la caché de modelos evita descargas y tareas de inicio innecesarias, especialmente con conexiones lentas, pero no debe confundirse con la base de datos ni con los originales familiares en la jerarquía de recuperación.

Un debate de la comunidad sobre la arquitectura de almacenamiento de Immich ilustra por qué los operadores separan los datos rápidos similares a una caché del almacenamiento masivo de fotos. Usa estas disposiciones solo como ejemplos; verifica las rutas y los montajes actuales en tu propia definición de Compose antes de mover nada.

Si se pierde la caché de modelos, la recuperación aceptable normalmente consiste en recrearla o volver a descargarla, siempre que el servicio pueda acceder al origen necesario y disponga de suficiente espacio en disco. Documenta ese comportamiento para que una herramienta de copias de seguridad no consuma por accidente capacidad externa limitada protegiendo una caché grande y regenerable.

-15% OFF

ZimaBoard 2 - Mini servidor doméstico para tu gran idea

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Mantén acotadas las capas escribibles, los registros y el espacio temporal

Las capas escribibles de los contenedores no deben convertirse en un lugar no documentado para derivados persistentes, transcodificaciones temporales o registros grandes. Inspecciona el uso del disco de Docker y los montajes de los contenedores para que cada ruta grande en crecimiento esté deliberadamente conservada o sea intencionadamente desechable. Un aumento inexplicable de la capa escribible es un síntoma de configuración, no un objetivo de limpieza predeterminado.

El flujo de trabajo de 2026 de Docker HQ para una limpieza segura del disco de Docker hace hincapié en auditar antes de podar y proteger los volúmenes que puedan contener bases de datos. Aplica aquí esa precaución: nunca ejecutes comandos de limpieza generales en un host de Immich en producción hasta conocer la propiedad de cada volumen y capa.

Configura la rotación de registros, mantén las rutas temporales en un almacenamiento con suficiente margen para picos y supervisa tanto los inodos como el uso en bytes cuando se creen muchos archivos pequeños. Si una ruta temporal se llena, la solución correcta es limitar o trasladar esa función, no eliminar directorios desconocidos hasta que la aplicación consiga iniciarse.

Valida los cambios de almacenamiento con pruebas de reinicio, reconstrucción y espacio libre

Después de cambiar las rutas, abre recursos antiguos y recientes, explora varios álbumes, reproduce un vídeo, ejecuta una tarea de miniaturas o de aprendizaje automático y carga un archivo nuevo controlado. Confirma que las escrituras llegan a los dispositivos previstos y que la base de datos sigue haciendo referencia a archivos multimedia legibles.

Reinicia los contenedores y después el host. Una configuración correcta vuelve a montar automáticamente cada función, conserva los derivados y la caché de modelos esperados, mantiene los datos temporales como desechables e informa de suficiente espacio libre en cada nivel activo. Supervisa el almacenamiento durante un periodo de carga normal para confirmar que el crecimiento aparece donde estaba previsto.

Revierte el cambio de ruta si Immich crea directorios duplicados, informa de recursos ausentes o escribe silenciosamente en la capa del contenedor porque un montaje falló. Al escalar el problema, incluye los mapas de montajes, los tamaños de las rutas, la propiedad, el espacio libre del sistema de archivos, el uso de disco de los contenedores y la tarea exacta que escribió por primera vez en la ubicación incorrecta.