Perché Immich ricrea i file mancanti con il proprietario sbagliato?

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.

Immich non dovrebbe ricreare silenziosamente un originale sorgente mancante come funzionalità generica di recupero. Se un oggetto eliminato ricompare, verifica innanzitutto se si tratta di una miniatura generata, un video codificato, un file di profilo, un sidecar XMP o un altro file scrivibile: questi possono essere ricreati o riscritti da processi diversi e acquisire un proprietario differente.

Usa un solo oggetto rigenerato usa e getta e la sua cartella principale. Confronta gli UID/GID numerici e le ACL sull'host con l'identità effettiva del processo di scrittura nel container, quindi determina se a crearlo è stato davvero Immich, una funzionalità che scrive tramite un sidecar, un protocollo NAS o un altro processo dell'host. Evita chown o chmod ricorsivi con permessi 777 finché non hai identificato il processo di scrittura.

Confronta il file ricreato con la cartella principale e un file adiacente noto funzionante

Registra il proprietario, il gruppo, la modalità, l'ACL, gli attributi estesi se pertinenti e gli UID/GID numerici del file ricreato, della sua cartella principale e di un file precedente che funziona correttamente. I nomi possono trarre in inganno tra NAS e container; gli ID numerici rivelano se «immich» su un sistema corrisponde alla stessa identità sull'altro.

Il flusso di lavoro di ZimaSpace per le operazioni sui file spostati su un NAS si applica direttamente: i nuovi oggetti sono regolati dall'ACL di destinazione, dall'identità del container, dalla mappatura del protocollo e dalle regole di creazione. Un file sostitutivo può quindi essere leggibile, ma avere comunque un proprietario che compromette il flusso di lavoro di un altro strumento. Se il file ricreato corrisponde all'ereditarietà della cartella principale e solo il nome visualizzato sembra insolito, verifica l'ID numerico prima di modificare qualsiasi cosa. Se differisce sia dalla cartella principale sia dai file noti funzionanti, verifica l'identità del processo che scrive: il problema potrebbe trovarsi nella configurazione del container e non nell'ACL del filesystem.

Identifica il processo e l'UID/GID effettivo che scrive il file sostitutivo

Avvia una rigenerazione sicura mentre controlli i log e il filesystem pertinenti. Verifica l'utente effettivo e i gruppi all'interno del container che esegue la scrittura. Se a creare il file è invece un sidecar, uno strumento per i metadati, un processo di backup o uno script sull'host, controlla quel servizio anziché modificare l'identità di runtime di Immich.

La proprietà dei file nel container è numerica, non basata sui nomi. Una spiegazione della proprietà dei file in Docker mostra perché lo stesso file montato con bind può visualizzare nomi utente diversi sull'host e nel container quando le mappature UID/GID non corrispondono. Usa gli ID numerici come riferimento comune.

Una discussione sulla proprietà delle librerie esterne di Immich documentava la scrittura di file sidecar XMP come root in una distribuzione. È un caso concreto che invita a verificare l'utente effettivo che scrive e l'identità di runtime supportata, non l'affermazione che ogni installazione attuale di Immich scriva come root ogni file rigenerato.

Se il container viene eseguito intenzionalmente come utente non root, verifica che l'UID/GID esista davvero sull'host o sul NAS e che abbia l'accesso necessario al percorso montato. Un nome utente simbolico all'interno di un container non corrisponde automaticamente a un account host con lo stesso nome.

Correggi la regola di creazione invece di continuare a correggere i file esistenti

Correggi il confine più circoscritto di cui hai conferma: allinea UID/GID del servizio, se supportato, correggi il gruppo della directory padre o l'ereditarietà ACL, imposta un umask adeguato oppure modifica la mappatura della condivisione NAS che fornisce l'identità errata. Mantieni la possibilità per Immich e per qualsiasi altro lettore autorizzato di accedere agli originali e ai file generati.

Non usare i permessi di scrittura per tutti come soluzione predefinita. Nascondono la mancata corrispondenza delle identità ed estendono inutilmente l'accesso in scrittura. Allo stesso modo, non modificare ricorsivamente la proprietà di PostgreSQL, cache dei modelli, caricamenti e librerie esterne con un solo comando: quei percorsi potrebbero dover usare identità di servizio diverse.

Se una libreria esterna deve essere immutabile, valuta di montarla in sola lettura e di conservare altrove lo stato scrivibile dell'app, ma solo se le funzionalità che usi non richiedono di scrivere file sidecar in quella posizione. La decisione riguarda la proprietà desiderata e il comportamento di scrittura, non l'obbligo di assegnare ogni file dell'archivio fotografico allo stesso account.

Ricrea un file e convalida dopo un riavvio

Rimuovi soltanto un oggetto generato temporaneo o un file sidecar di test che possa essere ricreato senza rischi, quindi esegui di nuovo l'esatta operazione di Immich. Verifica il nuovo proprietario, gruppo, ACL e la leggibilità sia da Immich sia dall'altro programma che prima non riusciva ad accedere. Durante questo test, non modificare i file multimediali originali.

Riavvia il container, quindi riavvia una volta l'host per verificare che l'identità e i mount corretti persistano dopo le modifiche al ciclo di vita. Una riparazione riuscita crea automaticamente il file di test successivo con la proprietà prevista; non dipende da uno script chown eseguito dopo l'avvio che può entrare in conflitto con le scritture di Immich.

Fermati e ripristina la configurazione salvata se le modifiche alla proprietà si propagano inaspettatamente al database o ai file originali, oppure se il servizio perde l'accesso in lettura/scrittura dopo il riavvio. Segnala il problema includendo gli ID numerici, l'output ACL, le opzioni di mount, l'utente effettivo del container, lo snippet Compose e il tipo esatto di file ricreato da Immich.

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.