Come configurare le librerie esterne di Immich come sorgenti di sola lettura

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.

Una libreria esterna di Immich indicizza le foto già archiviate al di fuori della directory di caricamento gestita. Montare la sorgente in sola lettura protegge gli originali da errori dell'applicazione o dell'operatore, ma Immich ha comunque bisogno di spazio di archiviazione scrivibile per le miniature, i video codificati, i dati del profilo e lo stato del database.

La configurazione utilizza quindi due zone di attendibilità: le cartelle sorgente immutabili e i dati generati scrivibili. Una piccola libreria di prova dovrebbe superare i test di rilevamento, metadati, miniature, nuova scansione e rimozione prima di aggiungere un archivio di grandi dimensioni. La stessa libreria di prova dimostra anche che il percorso nel container, la proprietà dei file e il piano di ripristino sono coerenti.

Mappa separatamente lo spazio di archiviazione sorgente e quello gestito

Scegli un percorso sull'host per l'archivio esistente e un percorso distinto nel container, ad esempio /external/family-photos. Non inserirlo nella directory di archiviazione dei caricamenti di Immich, perché gli asset esterni e quelli gestiti seguono regole del ciclo di vita diverse.

Il flusso di lavoro delle librerie esterne di Immich richiede che il server possa accedere al percorso che verrà assegnato a un utente. Annota entrambi i lati del mount, così l'amministratore non inserirà nell'applicazione un percorso disponibile solo sull'host.

Verifica che le posizioni scrivibili di Immich per i caricamenti, le miniature, i video codificati e i dati del database siano soggette alle normali procedure di backup e al monitoraggio dello spazio libero. Gli originali in sola lettura non proteggono i dati generati né i record degli asset che rendono utilizzabile la libreria.

Applica un mount di sola lettura al container

Aggiungi l'archivio come bind mount con il flag di sola lettura in Compose o nel gestore dei container. Una configurazione tipica mappa /srv/photos/archive sull'host in /external/archive nel container con :ro.

Concedi al processo del container i permessi di attraversamento e lettura su ogni directory padre. La sola lettura non significa che i permessi siano superflui: senza il permesso di esecuzione su una directory, i file non possono essere individuati, anche se sono leggibili singolarmente.

Se la sorgente è una condivisione di rete, stabilizza il mount dell'host prima dell'avvio del container. La guida all'affidabilità delle condivisioni di rete in Immich illustra la differenza tra un percorso disponibile e una dipendenza affidabile per l'applicazione.

Aggiungi una libreria esterna di prova ed esegui la scansione

Crea o seleziona l’utente Immich proprietario, aggiungi una libreria esterna e inserisci il percorso di importazione visibile dal container. Inizia con una directory che contenga copie o originali non critici, invece di selezionare l’intero archivio.

Avvia una scansione e verifica che compaia il numero previsto di foto e video. Apri le risorse nelle cartelle annidate, controlla date e luoghi e verifica che le miniature e le anteprime codificate vengano salvate nell’archivio gestito, non accanto agli originali.

Sull’host, confronta le date di modifica o gli hash della sorgente di prova prima e dopo la scansione. Prova anche a creare un file nel percorso montato dall’interno del container: l’operazione dovrebbe non riuscire, mentre la lettura dovrebbe funzionare.

Verifica la nuova scansione, i file mancanti e il ripristino

Aggiungi un file alla sorgente host, avvia una nuova scansione e verifica che compaia. Poi sposta temporaneamente un file di prova fuori dalla sorgente, avvia un’altra scansione e osserva come la versione di Immich installata contrassegna o rimuove il record della risorsa prima di ripetere la procedura sui dati reali.

Esegui il backup del database e dei dati scrivibili di Immich secondo il tuo normale piano di ripristino. Gli originali esterni richiedono un backup indipendente, perché il montaggio dell’applicazione in sola lettura non protegge da guasti del disco, eliminazioni dal lato host o danneggiamento dei dati.

La condizione da soddisfare è che Immich possa indicizzare e visualizzare l’archivio, ma non possa scriverci e che il sistema possa essere ricostruito senza trattare la sorgente esterna come caricamenti gestiti. Interrompi la procedura se compaiono file generati accanto agli originali o se un montaggio mancante viene scambiato per una libreria vuota.

Domande frequenti

Un montaggio in sola lettura impedisce a Immich di eliminare l’originale? Impedisce le scritture tramite quel montaggio del container. Non protegge dall’eliminazione dal lato host, da un’altra condivisione scrivibile, da guasti del file system o da un amministratore che modifica la modalità di montaggio.

Dove vengono salvate le miniature di una libreria esterna? Restano nell’archivio scrivibile gestito da Immich. Mantieni questa posizione separata dagli originali in sola lettura e includila nel piano di ripristino insieme al database.

Diversi utenti possono indicizzare la stessa cartella esterna? Evita che più utenti se ne contendano la gestione finché non hai verificato il comportamento della versione specifica. L’indicizzazione duplicata può creare confusione sulla gestione e sulla condivisione.

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.