Come bloccare UID/GID del container e proprietà dei volumi prima degli aggiornamenti delle app self-hosted

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.

È meno probabile che gli aggiornamenti delle app self-hosted creino file di proprietà di root quando la distribuzione fissa un contratto utente numerico e convalida la proprietà dei volumi prima di sostituire il container.

L’obiettivo preventivo è smettere di considerare il nome utente interno dell’immagine come un’identità di archiviazione stabile. Registra l’UID e il GID effettivi che scrivono i dati persistenti, associli alle directory dell’host o ai volumi denominati, mantieni le impostazioni PUID/PGID o degli spazi dei nomi utente e testa la nuova immagine su un piccolo percorso scrivibile prima della distribuzione completa. In questo modo, un aggiornamento dell’immagine non potrà cambiare silenziosamente la proprietà numerica di configurazioni, caricamenti, database o metadati dei contenuti multimediali.

Registra l’UID e il GID numerici prima dell’aggiornamento

Registra l’utente del processo in esecuzione, il gruppo primario, i gruppi supplementari e la proprietà numerica di file rappresentativi in ogni volume scrivibile. Salva il digest o la versione dell’immagine insieme a questa configurazione di riferimento della proprietà.

Le linee guida di Docker sulla creazione delle immagini affermano che gli ID espliciti evitano variazioni tra le build, perché agli utenti assegnati automaticamente all’immagine possono essere attribuiti ID numerici diversi nelle varie build.

Registra i numeri, non solo nomi come app o media. Una nuova immagine può riutilizzare lo stesso nome utente cambiandone l’UID, mentre i file sull’host memorizzano la proprietà numerica.

Fissa l’utente di runtime nel contratto di distribuzione

Se l’immagine supporta l’esecuzione diretta con un account non root, specifica esplicitamente l’utente e il gruppo previsti in Compose o nella configurazione di runtime. Se l’immagine richiede una fase di inizializzazione con privilegi root, documenta quale processo successivo scrive effettivamente i dati persistenti.

La specifica delle immagini Open Container definisce User come valore predefinito a runtime, il che significa che un’immagine modificata può cambiare l’identità a runtime, a meno che la distribuzione non la sovrascriva o la convalidi intenzionalmente.

Non forzare un UID non root arbitrario sulle immagini che richiedono un modello di inizializzazione supportato. Il contratto deve seguire il design documentato dell’applicazione, mantenendo prevedibile la proprietà risultante dei file persistenti.

Mantieni PUID e PGID allineati alla proprietà sull’host

Per le immagini che espongono le variabili PUID e PGID, fissa questi valori nella configurazione Compose o dell’ambiente sotto controllo versione e assicurati che le directory dei volumi sull’host siano di proprietà dell’account di servizio corrispondente.

LinuxServer spiega che PUID mappa le scritture del container, così i file creati nei volumi mappati restano gestibili anche fuori dal container.

Prima dell’aggiornamento, confronta gli ID configurati con quelli restituiti da id sull’host e con la proprietà dei file esistenti. Non copiare alla cieca un valore di esempio come 1000 su un server dove quell’ID appartiene a un’altra persona o a un servizio.

Tieni conto dei namespace utente e della mappatura rootless

Docker o Podman rootless possono far apparire un processo come root all’interno del container, pur mappandolo su un UID non root dell’host. Registra la modalità del namespace e la configurazione degli UID/GID subordinati prima di interpretare le modifiche alla proprietà.

Le opzioni di runtime di Podman mostrano che keep-id mantiene la mappatura dell’utente quando un container deve accedere in modo prevedibile ai file montati dall’host.

Non «correggere» un proprietario che sembra root all’interno del container prima di aver controllato l’ID numerico sull’host. Root nel namespace e root sull’host non sono sempre la stessa identità.

Verifica preliminarmente la nuova immagine su un volume di test

Prima di sostituire il container di produzione, esegui la nuova immagine con gli UID/GID previsti e una directory temporanea che riproduca i permessi di produzione. Consenti all’inizializzazione all’avvio di creare un file e una directory, quindi controllane la proprietà sull’host.

La guida di Red Hat per il debug dei volumi rootless dimostra che la proprietà sull’host segue la mappatura degli UID, e che il nome utente mostrato all’interno del container non è una prova sufficiente.

Se il canary crea file con una proprietà di root imprevista o rimappata, interrompi il rilascio e confronta l’utente dell’immagine, l’entrypoint, il namespace e le impostazioni dei mount. È molto più sicuro che scoprire il problema dopo che una migrazione ricorsiva all’avvio ha modificato un intero albero di foto o database.

Verifica i gruppi supplementari e i percorsi scrivibili

Alcune app richiedono un UID del servizio principale e l’accesso tramite un gruppo condiviso per file multimediali, download o dispositivi. Registra gli ID di questi gruppi e verifica tutti i percorsi scrivibili, non solo la directory di configurazione.

Kubernetes usa controlli espliciti runAsUser e runAsGroup, illustrando lo stesso principio di proprietà di Linux anche al di fuori di una semplice implementazione Docker Compose.

La policy di aggiornamento è completa quando la nuova immagine crea file con la proprietà host prevista in tutti i percorsi persistenti e supera una ricreazione del container. L’articolo correlato di ZimaSpace sui file di proprietà di root dopo gli aggiornamenti dell’immagine descrive la procedura di ripristino da seguire se un rilascio ha già prodotto dati di proprietà di root.

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.