Come configurare la cache e l’archiviazione temporanea di Immich

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Configura la cache e lo storage temporaneo di Immich separando innanzitutto i dati permanenti della libreria dai derivati generati, dalla cache dei modelli riutilizzabile e dai dati temporanei realmente eliminabili del container.

Miniature e video codificati possono sembrare una cache perché Immich è in grado di rigenerarli, ma sono risorse di lavoro persistenti che possono diventare ingombranti e costose da ricreare. I download dei modelli hanno un ciclo di vita diverso, mentre i log e i dati temporanei del livello scrivibile non dovrebbero occupare di nascosto il disco di avvio. Assegna lo storage in base al ruolo, quindi verifica il comportamento durante la pulizia e il riavvio.

Classifica ogni ruolo di storage prima di spostarlo

Crea un inventario con almeno quattro categorie: originali e stato applicativo necessario; miniature e anteprime generate; video codificati generati; dati di modelli, log o runtime temporanei. Per ogni categoria, annota il percorso attuale, le dimensioni, il tasso di crescita, la politica di backup, il costo di ricostruzione e il servizio che vi scrive.

La segnalazione di un utente sulla crescita di miniature e video codificati generati dimostra perché miniature e video codificati vadano misurati separatamente. I rapporti specifici non sono universali, perché la quantità prodotta varia in base al tipo di contenuti multimediali e alle impostazioni di elaborazione.

Non definire una directory «cache» solo perché eliminarla libera spazio. Se la sua perdita comporta giorni di rigenerazione, interrompe la riproduzione in corso o rimuove dati che il piano di ripristino prevede di conservare, merita un ruolo persistente esplicito, anche se l’applicazione è tecnicamente in grado di ricrearla.

Colloca i dati generati con un’elevata frequenza di modifica dove latenza e durata sono adeguate

Le miniature e le anteprime servono per la navigazione interattiva e comportano spesso numerose letture di piccole dimensioni, mentre i video codificati possono occupare molta più capacità sequenziale. Un SSD veloce può migliorare le attività che usano molti derivati, ma solo se spostare quel ruolo elimina l’attesa misurata, invece di creare un altro piccolo volume che si riempie inaspettatamente.

La spiegazione di ZimaSpace sulla crescita dello spazio occupato dalle miniature offre una lezione di storage applicabile anche altrove: lo spazio attivo delle app può esaurirsi anche quando gli originali si trovano altrove. I percorsi specifici di Immich sono diversi, ma resta necessario monitorare il ruolo effettivamente scrivibile.

Se i file multimediali principali restano su HDD o su uno storage NAS mentre i derivati vengono spostati su SSD, monitora i livelli minimi di spazio libero e verifica ogni mount dopo il riavvio. Un livello rapido per i derivati è utile solo se ha spazio sufficiente per la normale crescita e se un suo guasto non può essere scambiato per la perdita degli originali autorevoli.

Mantieni la cache dei modelli in modo deliberato, ma considerala ricostruibile

I modelli di machine learning vengono scaricati o preparati per l’inferenza ripetuta e possono occupare una quantità significativa di spazio. Mantenere la cache dei modelli evita download e operazioni di avvio non necessari, soprattutto con connessioni lente, ma non va confusa con il database o con gli originali di famiglia nella gerarchia di ripristino.

Una discussione della community sull'architettura di storage di Immich mostra perché gli operatori separano i dati simili a una cache veloce dallo storage per le foto in grandi quantità. Usa queste configurazioni solo come esempi: prima di spostare qualsiasi cosa, verifica i percorsi e i mount attuali nella tua definizione Compose.

Se la cache dei modelli viene persa, in genere è accettabile ricrearla o scaricarla di nuovo, purché il servizio possa accedere alla fonte necessaria e disponga di spazio su disco sufficiente. Documenta questo comportamento affinché uno strumento di backup non consumi per errore la limitata capacità offsite per proteggere una cache di grandi dimensioni rigenerabile.

Mantieni entro limiti definiti i livelli scrivibili, i log e lo spazio temporaneo

I livelli scrivibili dei container non dovrebbero diventare una destinazione non documentata per derivati persistenti, transcodifiche temporanee o log voluminosi. Controlla l'utilizzo del disco Docker e i mount dei container, in modo che ogni percorso in forte crescita venga salvato intenzionalmente o sia intenzionalmente temporaneo. Un picco inspiegabile nel livello scrivibile indica un problema di configurazione, non è automaticamente qualcosa da eliminare.

Il flusso di lavoro Docker HQ del 2026 per una pulizia sicura del disco Docker sottolinea l'importanza di verificare prima di eliminare e di proteggere i volumi che potrebbero contenere database. Applica la stessa cautela: non eseguire mai comandi di pulizia indiscriminata su un host Immich di produzione prima di aver identificato la funzione di ogni volume e livello.

Imposta la rotazione dei log, mantieni i percorsi temporanei su storage con margine sufficiente per i picchi e monitora anche l'utilizzo degli inode, oltre a quello in byte, quando vengono creati molti file di piccole dimensioni. Se un percorso temporaneo si riempie, la soluzione corretta è limitare o spostare quel ruolo, non eliminare directory sconosciute finché l'applicazione non si avvia per caso.

Convalida le modifiche allo storage con test di riavvio, ricostruzione e spazio libero

Dopo aver modificato i percorsi, apri risorse vecchie e recenti, sfoglia diversi album, riproduci un video, avvia un job per una miniatura o di machine learning e carica un nuovo file di prova. Verifica che i dati vengano scritti sui dispositivi previsti e che il database faccia ancora riferimento a contenuti multimediali leggibili.

Riavvia i container e poi l'host. Una configurazione corretta rimonta automaticamente ogni ruolo, conserva i derivati previsti e la cache dei modelli, mantiene temporanea l'area di lavoro e segnala spazio libero sufficiente su ogni livello attivo. Monitora lo storage durante un normale periodo di utilizzo per confermare che i dati crescano nelle posizioni previste.

Annulla una modifica al percorso se Immich crea directory duplicate, segnala risorse mancanti o scrive silenziosamente nel livello del container perché un mount non è riuscito. In caso di escalation, includi la mappatura dei mount, le dimensioni dei percorsi, i proprietari, lo spazio libero sul filesystem, l'utilizzo del disco del container e il job esatto che ha scritto per primo nella posizione errata.

Assistenza e consigli

Altre letture

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.