Cómo configurar los ID de usuario de los contenedores en varios recursos compartidos de NAS

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Configura los ID de usuario de los contenedores en varios recursos compartidos del NAS asignando la identidad numérica real de cada proceso del contenedor al propietario, grupo, ACL y modo de montaje de cada recurso compartido que necesite.

No obligues a que un solo UID sea propietario de todos los conjuntos de datos ni uses chmod 777 como método de integración. Un servidor multimedia puede necesitar acceso de solo lectura a las fotos, un descargador puede necesitar acceso de lectura y escritura a un recurso compartido de entrada, y un contenedor de copias de seguridad puede necesitar un destino protegido distinto. Usa la propiedad para asignar la responsabilidad principal y los grupos o las ACL para el acceso compartido.

Anota las tres identidades antes de cambiar los permisos

Para cada servicio, anota el UID/GID del propietario en el NAS, el usuario y los grupos numéricos del proceso dentro del contenedor, y cualquier convención de identidad específica de la imagen, como PUID/PGID. A menudo se confunden estos tres valores porque los nombres de usuario pueden parecer idénticos aunque los ID numéricos sean distintos.

Un artículo actual sobre PUID y PGID, que no son ajustes de Docker deja clara la diferencia: PUID y PGID son variables que interpretan determinadas imágenes de contenedor, no ajustes universales de Docker.

Verifica el proceso en ejecución con id dentro del contenedor e inspecciona los archivos del host para comprobar su propiedad numérica. No des por sentado que los valores escritos en Compose controlan realmente el proceso, salvo que la imagen admita ese método.

Usa un propietario principal y grupos compartidos para los datos entre servicios

Un recurso compartido que usa una sola aplicación puede tener un propietario específico. Los recursos compartidos en los que escriben varios servicios suelen ser más fáciles de gestionar con un grupo compartido definido deliberadamente o con una ACL que conceda únicamente las operaciones que necesitan esos servicios.

Una explicación práctica sobre la propiedad numérica de UID y GID muestra por qué los archivos montados con enlace siguen la propiedad numérica del host y por qué hacer coincidir o asignar deliberadamente esos ID evita archivos generados con propietario root y errores de permisos.

Por ejemplo, en un flujo de trabajo multimedia, el descargador puede ser propietario de sus archivos temporales, mientras que tanto el descargador como el organizador pertenecen al grupo media. Configura la herencia de directorios, las ACL predeterminadas o el comportamiento adecuado de umask para que los archivos nuevos mantengan automáticamente el acceso compartido.

Concede a cada recurso compartido solo los permisos de montaje que necesita el contenedor

La identidad es solo una capa. Un UID correctamente asignado sigue sin poder escribir en un montaje bind de solo lectura, y los permisos amplios sobre el sistema de archivos de un contenedor aún pueden limitarse de forma segura montando una biblioteca como solo lectura.

Una guía de 2026 sobre la configuración de usuarios en tiempo de ejecución explica cómo los montajes bind usan la propiedad del host y cómo los ajustes user: en tiempo de ejecución pueden hacer coincidir los ID de proceso, y también advierte que forzar un usuario puede interrumpir imágenes cuya lógica de inicio espera privilegios distintos.

Documenta cada ruta del host, ruta del contenedor, modo de montaje, operación requerida y servicio responsable. Usa montajes de solo lectura para las bibliotecas que un servicio solo consume y reserva el acceso de escritura para la ruta más pequeña que realmente lo necesite.

Gestiona deliberadamente los distintos modelos de ACL del NAS

Las ACL de SMB/NFSv4, las ACL POSIX, la asignación de identidades de NFS y los bits de modo Unix simples pueden mostrar distintas perspectivas del acceso. Un recurso compartido que funciona mediante SMB con un usuario del NAS puede aun así rechazar un proceso del contenedor que use una identidad numérica diferente en el host.

El artículo relacionado de ZimaSpace sobre cambios en los permisos del NAS explica por qué la herencia de ACL en el destino, la identidad SMB, el UID/GID del contenedor y umask deben diagnosticarse como capas independientes.

Cuando varios protocolos accedan al mismo conjunto de datos, elige un único modelo de permisos y documéntalo. Mezclar repetidamente los cambios de ACL de la interfaz gráfica del NAS con comandos de shell chmod y chown puede hacer que el siguiente archivo se comporte de forma distinta al anterior.

Prueba la creación de archivos desde cada servicio que escriba antes de aplicar los cambios recursivamente

Crea un directorio de prueba desechable con la propiedad y la ACL previstas. Desde cada contenedor, prueba solo las operaciones que requiere ese servicio: listar, leer, crear, cambiar el nombre y eliminar. Luego inspecciona en el NAS el propietario numérico, el grupo, el modo y la ACL heredada del archivo nuevo.

Si los archivos antiguos funcionan, pero los recién creados fallan para otro servicio, corrige el proceso de creación: pertenencia a grupos, ACL predeterminada, umask o modo de archivo específico de la aplicación. Reparar recursivamente los datos antiguos no impide que el mismo desajuste vuelva a producirse mañana.

Pasa a producción solo después de que cada servicio que escriba cree archivos que el siguiente servicio necesario pueda usar sin permisos elevados. Un diseño limpio de UID/GID es recuperable porque la asignación está documentada y puede repetirse, no porque todos los contenedores se ejecuten por casualidad con el mismo usuario.

Soporte y consejos

Más para leer

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.