Checklist per la mappatura di utenti e gruppi dei container nelle condivisioni NAS

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.

L’approccio sicuro consiste nel trattare la verifica della mappatura degli ID numerici, dall’esportazione NAS al mount sull’host fino al processo del container in esecuzione, come una sequenza di verifiche osservabili, non come un singolo comando.

Su un host Linux per container che usa condivisioni NAS basate su SMB o NFS, il rischio concreto è che un container veda un percorso montato dal NAS, ma che le letture o le scritture non riescano a causa di errori di permesso. Registra l’identità attuale e il punto di ripristino, inizia dal controllo discriminante meno invasivo, interpreta i risultati positivi e negativi prima di modificare un’altra variabile e fermati se lo storage diventa instabile o se rischia di essere esposta l’unica copia recuperabile. Il flusso di lavoro seguente termina solo quando il carico di lavoro originale funziona oppure le prove raggiungono una soglia che richiede un’escalation.

Identifica l’identità effettiva del processo nel container

Controlla la documentazione dell’immagine, l’impostazione Compose user, le variabili d’ambiente, il comportamento dell’entrypoint e UID, GID e gruppi supplementari del processo dell’applicazione in esecuzione. Le variabili chiamate PUID e PGID sono convenzioni delle immagini, non funzionalità universali di Docker, quindi verifica che questa immagine le supporti.

Un caso della community LinuxServer sui problemi di permessi di PUID e PGID nei container dimostra che valori PUID e PGID apparentemente corretti possono comunque impedire l’accesso a un bind mount. Considera il caso come un promemoria a controllare il processo in esecuzione e il mount, non come prova che tutte le immagini adottino la stessa logica di inizializzazione.

Registra i valori numerici con id all’interno del container e sull’host. Se l’applicazione viene eseguita come root solo perché in precedenza si sono verificati problemi di permessi, fermati: l’accesso root nasconde il difetto di mappatura e aumenta l’impatto di un servizio compromesso.

Traccia la proprietà dal NAS al mount sull’host

Sul NAS, controlla il proprietario numerico, il gruppo, i permessi, l’ACL e l’ACL predefinito della directory di destinazione. Sull’host del container, controlla gli stessi oggetti montati e confronta i valori numerici. Se i nomi sono diversi ma i numeri coincidono, le etichette sono solo estetiche; se i numeri sono diversi, il percorso di autorizzazione è effettivamente diverso.

Per NFS, includi le opzioni di esportazione, la versione NFS, la mappatura degli ID, la soppressione dei privilegi di root e l’identità con cui il client monta la condivisione. Per SMB, includi le credenziali di montaggio, l’identità mappata lato server, le opzioni di presentazione uid o gid e specifica se vengono usate le estensioni Unix o la traduzione degli ACL.

Non modificare contemporaneamente gli ACL del server e le opzioni di montaggio del client. La fase è superata quando un file di test ha un proprietario numerico noto e l'host rileva una mappatura stabile dopo lo smontaggio, il nuovo montaggio e il riavvio.

Verifica il bind mount e i gruppi supplementari

Verifica che il percorso sorgente del container corrisponda al montaggio host previsto e non a una directory locale vuota creata prima del montaggio della condivisione di rete. Esamina il montaggio a runtime, quindi prova a elencare, leggere, creare, rinominare ed eliminare file come utente dell'applicazione in una sottodirectory usa e getta.

Un caso su Server Fault documenta una discordanza dei permessi ACL NFS anche quando le voci del proprietario e dell'ACL sembrano allineate, a dimostrazione del fatto che occorre controllare la maschera ACL, la mappatura del server e l'identità effettiva. Acquisisci l'output di getfacl sia sulla directory che sul file creato.

Se è previsto l'accesso tramite gruppo, aggiungi il gruppo numerico supplementare supportato e ricrea il container, perché i gruppi del processo vengono impostati all'avvio. Consulta la guida di ZimaSpace sulla diagnosi del percorso vuoto nel container quando l'applicazione si avvia su un percorso vuoto; si tratta di un problema di ordine di montaggio, non di ACL.

Applica la correzione d'identità più circoscritta e ripeti i test

Preferisci allineare l'UID, il GID o il gruppo supplementare supportato dall'applicazione ai criteri del NAS. Usa un gruppo condiviso e un ACL ereditato quando più servizi collaborano. Evita permessi di scrittura per tutti, modifiche ricorsive della proprietà su dataset non correlati e container privilegiati come scorciatoie.

Ricrea il container, rimonta la condivisione se sono cambiate le opzioni di mappatura e ripeti le stesse operazioni. Riavvia una volta l'host per verificare che l'ordine di montaggio e l'identità numerica restino invariati dopo l'avvio. Verifica che i file appena creati restino scrivibili dagli utenti previsti, senza concedere al container diritti non necessari.

Chiudi la checklist quando l'app supera il carico di lavoro originale, le operazioni negate restano negate e la proprietà rimane stabile dopo il riavvio. Segnala il problema se gli spazi dei nomi utente, le mappature rootless o i servizi di identità del NAS riscrivono gli ID in un modo non supportato dall'immagine scelta.

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.