Perché i proprietari dei file nei container cambiano dopo aver copiato i dati delle app?

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.

I proprietari dei file di un container cambiano dopo una copia quando i valori numerici di UID/GID non vengono preservati o il runtime di destinazione li rimappa o li riscrive.

Su un NAS domestico, lo stesso file può mostrare un nome utente sull’host e un altro all’interno di un container, perché la proprietà viene memorizzata come numero, mentre ogni ambiente risolve quel numero tramite un database degli account diverso. Anche le copie effettuate tramite interfaccia grafica, condivisione SMB, archivio, shell root, strumento di migrazione o entrypoint del container possono sostituire la proprietà. Per prima cosa, diagnostica l’identità numerica; poi distingui il comportamento della copia, le impostazioni dell’utente di runtime, gli script di avvio, gli spazi dei nomi utente e la mappatura del filesystem di rete, prima di modificare le autorizzazioni dell’intero albero dei dati dell’app.

Confronta UID e GID numerici prima di confrontare i nomi utente

Esamina l’origine e la destinazione usando la proprietà numerica, non solo i nomi. Registra UID, GID, modalità, ACL, attributi estesi e filesystem di un file rappresentativo e della relativa directory principale, sia sull’host sia all’interno del container.

I bind mount Docker espongono i file dell’host a processi che potrebbero usare un database utenti diverso. Una discussione della community Docker sulle autorizzazioni spiega perché l’accesso affidabile dipende dall’allineamento numerico di UID/GID, non solo dalla corrispondenza dei nomi utente.

Se i numeri sono identici ma i nomi visualizzati differiscono, la proprietà potrebbe non essere affatto cambiata. Correggi la documentazione o la mappatura degli account invece di riscrivere ricorsivamente i dati. Se i numeri differiscono, conserva le prove e prosegui con le fasi di copia e di runtime.

Verifica se la copia ha preservato o ricreato la proprietà

Annota il percorso esatto della copia: file manager dell’host, cp, rsync, archivio tar, client SMB/NFS, ripristino di un backup, comando di copia Docker o container temporaneo di migrazione. Ogni metodo ha impostazioni predefinite diverse per proprietario, gruppo, ACL e attributi estesi.

Una copia eseguita come root può preservare la proprietà numerica quando si usano opzioni di archiviazione esplicite, mentre un altro strumento può creare ogni file di destinazione con l’account che esegue la copia. Un recente problema di migrazione dei container mostra come i dati dell’app copiati possano diventare illeggibili quando l’UID di destinazione è diverso dall’identità di runtime dell’applicazione.

Ripeti l'operazione con una piccola directory di test e verifica la proprietà dei file subito prima dell'avvio dell'applicazione. Se i numeri sono già errati, correggi il metodo di copia o ripristina i flag. Se cambiano solo dopo l'avvio, lascia intatta la copia e analizza l'entrypoint del container.

Fai corrispondere l'utente del runtime del container al proprietario dello storage host

Controlla l'utente effettivo all'interno del container in esecuzione e il proprietario numerico della directory app-data montata tramite bind. Verifica anche user: in Compose, i gruppi supplementari, le variabili PUID/PGID della piattaforma e le impostazioni degli account specifiche dell'immagine.

L'esecuzione come utente non root nel container non concede automaticamente l'accesso a una directory host appartenente a un'altra identità numerica. Un caso discusso sul forum Docker risolve il problema facendo corrispondere l'utente del container ai permessi host, invece di rendere la directory scrivibile da chiunque.

Scegli un modello di proprietà stabile per l'applicazione e documentalo in Compose. Aggiungi solo i gruppi necessari per l'accesso condiviso. Evita chmod 777, perché nasconde la mancata corrispondenza delle identità, indebolisce la separazione e non mantiene la proprietà prevista per i file futuri.

Verifica se l'entrypoint modifica la proprietà dei file all'avvio

Molte immagini si avviano brevemente come root, creano le directory mancanti, applicano un UID/GID configurato e modificano ricorsivamente la proprietà dei file prima di abbandonare i privilegi. Questo comportamento può far sembrare che una copia corretta si modifichi da sola dopo il primo avvio del container.

I runtime e le immagini dei container possono anche offrire mount che modificano la proprietà dei file. Un problema di Podman segnala che l'opzione :U può riscrivere la proprietà dei file sorgente, mentre gli script entrypoint possono eseguire una modifica ricorsiva simile durante l'avvio dell'applicazione.

Avvia il container una volta con i log visibili e monitora una piccola sottodirectory di prova. Cerca nell’entrypoint e nelle note di rilascio dell’immagine riferimenti a chown, migrazione degli utenti, PUID/PGID e procedure di correzione dei permessi. Disattiva o limita quel comportamento solo se l’immagine supporta un’alternativa stabile.

Tieni conto di Docker rootless, degli user namespace e dei filesystem di rete

Docker rootless e la rimappatura degli user namespace traducono gli ID del container in un altro intervallo host. NFS, CIFS e alcune opzioni di mount NAS possono inoltre eseguire lo squash dell’utente root o assegnare a tutti i file UID e GID configurati.

Un rapporto sui permessi di Docker rootless mostra file con una proprietà imprevista perché l’identità del container viene mappata tramite un intervallo host subordinato. L’indizio diagnostico è la mappatura della proprietà tramite user namespace, non un errore di copia convenzionale.

Verifica se il percorso dei dati è locale, NFS, CIFS, FUSE o un altro filesystem montato, quindi annota il suo comportamento relativo a UID/GID, root squash e ACL. Verifica separatamente la creazione dei file con la proprietà corretta dall’host e dal container. Non eseguire chown ricorsivamente su una condivisione di rete prima di aver compreso le policy di identità lato server.

Ripara la proprietà dei file partendo da un’identità applicativa nota

Arresta l’applicazione, esegui un backup dei metadati attuali e definisci gli UID, i GID, i permessi delle directory, i permessi dei file, le ACL e le etichette di sicurezza esatti previsti dall’immagine. Correggi solo i percorsi di proprietà dell’applicazione, escludendo i contenuti multimediali condivisi o i dataset non correlati.

La guida di ZimaSpace su come distinguere gli errori di permesso dai mount in sola lettura è il controllo successivo quando la proprietà è corretta ma non è ancora possibile scrivere.

Riavvia il container e crea, modifica ed elimina un file di prova come utente effettivo del servizio. Poi ricrea il container e ripeti il test. La riparazione è completa solo quando la proprietà dei file rimane stabile dopo la copia, l’avvio, il riavvio e la ricreazione del container e l’applicazione può leggere e scrivere senza eccezioni di permessi troppo ampie.

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.