I dati Immich obsoleti dopo una modifica del percorso di archiviazione possono avere tre cause diverse, che non vanno confuse: lo spostamento della directory principale dei contenuti gestiti, la modifica del percorso di importazione di una libreria esterna oppure un client che continua a mostrare dati memorizzati nella cache. Le versioni moderne di Immich possono riconciliare lo spostamento dei contenuti gestiti se la posizione configurata e il montaggio del volume restano coerenti, mentre gli spostamenti delle librerie esterne possono ancora essere trattati come nuove identità degli elementi.
Conserva il vecchio percorso e il database prima di avviare una nuova scansione. Per prima cosa, verifica quale percorso vede il container in esecuzione, poi stabilisci se è errato il record sul server di Immich o se è obsoleto solo un client. Da questa distinzione dipende se devi correggere un montaggio, ripristinare un percorso stabile visibile nel container, eseguire di nuovo la scansione di un sottoinsieme di prova o svuotare solo la cache del client.
Distingui lo spostamento della directory principale dei contenuti gestiti da quello della libreria esterna
Se hai cambiato la posizione sul server dei caricamenti gestiti da Immich, verifica che l'impostazione effettiva della posizione dei contenuti e il montaggio dal server al container siano stati modificati insieme. Lo spostamento dei contenuti gestiti nelle versioni moderne non va diagnosticato allo stesso modo della modifica del percorso di importazione di una libreria esterna.
La mappa dello stato persistente di Immich di ZimaSpace è utile in questo caso perché il database e i percorsi del filesystem costituiscono un unico perimetro di ripristino. I file corretti sul server non bastano se il container è montato in un'altra posizione.
Se la directory principale dei contenuti gestiti non corrisponde, correggi prima la configurazione dell'ambiente e la mappatura dei volumi, quindi riavvia il servizio prima di avviare le attività della libreria. Se il percorso modificato appartiene a una libreria esterna, mantieni intatto il database e verifica separatamente questo caso.
Quando possibile, mantieni stabile il percorso della libreria esterna nel container
Per una libreria esterna, il modo più sicuro per spostare i dati sul server è mantenere invariato il percorso di importazione visibile nel container. Se cambia il percorso mostrato a Immich, annota un piccolo gruppo di ID degli elementi, album, persone e vecchi percorsi prima di avviare una scansione, così potrai verificare se gli elementi esistenti sono stati ricollegati o ricreati.
Un report sulle modifiche al percorso della libreria esterna di Immich descrive file spostati trattati come nuovi elementi, con una nuova elaborazione e la perdita delle relazioni disponibili solo in Immich. È un caso legato a una specifica versione, ma avvalora la regola prudenziale secondo cui un percorso modificato nella libreria esterna non equivale automaticamente a una ridenominazione trasparente.
Se un sottoinsieme di prova compare come nuovi asset mentre i vecchi record risultano mancanti o nel cestino, interrompi la scansione completa. Se possibile, ripristina il vecchio percorso visibile al container oppure usa un metodo di migrazione compatibile con la versione; non riscrivere manualmente i percorsi nel database di produzione senza un backup verificato.
Non confondere questo caso con una migrazione del modello di archiviazione per i file gestiti da Immich. Il sintomo può sembrare simile nella cronologia, ma la proprietà dei file e il percorso di migrazione supportato sono diversi.
Distingui i percorsi memorizzati sul server dalla cache del client
Esamina lo stesso asset noto dal client web e da un altro client autenticato, quindi confronta il risultato con i log del server o con il percorso visibile al server. Se i processi lato server indicano ancora il vecchio percorso, svuotare la cache del browser non può correggere il record sottostante.
Un successivo problema di metadati relativi a un vecchio percorso di Immich ha mostrato che l’elaborazione continuava a fare riferimento a un precedente percorso della libreria esterna dopo una rinomina. È un forte indizio che occorre controllare i percorsi usati dai processi prima di attribuire la colpa all’interfaccia mobile o web.
Se il percorso sul server è corretto ma solo una vista web non è aggiornata, aggiorna o svuota la cache del client e verifica di nuovo il file originale. Le miniature memorizzate nella cache e lo stato non aggiornato del client possono far sembrare guasto un server funzionante; al contrario, un’anteprima memorizzata nella cache può far sembrare funzionante un percorso del server guasto.
Ripara il perimetro minimo del percorso e convalida una scansione controllata
Apporta una sola correzione reversibile: sincronizza l’impostazione dei media gestiti e il mount, ripristina il percorso del container precedente per la libreria esterna, correggi un percorso di importazione oppure svuota la cache di un client. Esegui un backup del database prima di qualsiasi azione che possa far rilevare nuovamente una grande libreria.
Esegui la scansione più limitata possibile e controlla se i record esistenti restano associati, gli errori relativi ai vecchi percorsi cessano e non compaiono duplicati degli asset con percorsi vecchi e nuovi. Poi apri alcuni originali, verifica le relazioni con album e persone, esegui una ricerca e riavvia lo stack.
Intervieni se i record dei percorsi vecchi e nuovi restano attivi contemporaneamente, una grande libreria esterna viene rielaborata inaspettatamente o le relazioni scompaiono mentre gli originali restano leggibili. Conserva la mappatura esatta dei mount prima e dopo, la versione di Immich, gli ID degli asset interessati, il comportamento del filesystem rispetto alle maiuscole e minuscole e il timestamp del backup del database.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



