Lista de verificación para la asignación de usuarios y grupos de contenedores en recursos compartidos 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.

El enfoque seguro consiste en tratar la comprobación de la asignación de identidad numérica desde la exportación del NAS, pasando por el montaje del host, hasta el proceso del contenedor en ejecución, como una secuencia de etapas verificables, no como un único comando.

En un host de contenedores Linux que utiliza recursos compartidos NAS mediante SMB o NFS, el riesgo práctico es que un contenedor pueda ver una ruta montada desde el NAS, pero las lecturas o escrituras fallen con errores de permisos. Registra la identidad actual y el punto de recuperación, empieza por el método de diagnóstico menos invasivo, interpreta los resultados satisfactorios y fallidos antes de cambiar otra variable, y detente si el almacenamiento se vuelve inestable o si se pondría en riesgo la única copia recuperable. El flujo de trabajo siguiente solo termina cuando la carga de trabajo original funciona o cuando las pruebas indican que hay que escalar el problema.

Identifica la identidad real del proceso del contenedor

Inspecciona la documentación de la imagen, la configuración user de Compose, las variables de entorno, el comportamiento del punto de entrada y los UID, GID y grupos suplementarios del proceso de aplicación en ejecución. Las variables llamadas PUID y PGID son convenciones de las imágenes, no funciones universales de Docker, así que confirma que esta imagen las admite.

Un caso de la comunidad LinuxServer sobre un problema de permisos de PUID y PGID en un contenedor demuestra que unos valores de PUID y PGID aparentemente correctos pueden dejar igualmente inaccesible un montaje enlazado. Usa el caso como recordatorio para inspeccionar el proceso en ejecución y el montaje, no como prueba de que todas las imágenes implementen la misma lógica de inicialización.

Registra los valores numéricos con id dentro del contenedor y en el host. Detente si la aplicación se ejecuta como root solo porque antes fallaban los permisos; el acceso de root oculta el defecto de asignación y aumenta el impacto de que un servicio se vea comprometido.

Rastrea la propiedad desde el NAS hasta el montaje del host

En el NAS, inspecciona el propietario numérico, el grupo, el modo, la ACL y la ACL predeterminada del directorio de destino. En el host del contenedor, inspecciona los mismos objetos montados y compara los valores numéricos. Si los nombres difieren, pero los números coinciden, las etiquetas son meramente cosméticas; si los números difieren, la ruta de autorización es realmente distinta.

Para NFS, incluye las opciones de exportación, la versión de NFS, la asignación de ID, la reducción de privilegios de root y la identidad de montaje del cliente. Para SMB, incluye las credenciales de montaje, la identidad asignada en el servidor, las opciones de presentación uid o gid y si se utilizan extensiones de Unix o traducción de ACL.

No cambies a la vez las ACL del servidor y las opciones de montaje del cliente. La etapa se supera cuando un archivo de prueba tiene un propietario numérico conocido y el host muestra una asignación estable después de desmontar, volver a montar y reiniciar.

Prueba el montaje bind y los grupos suplementarios

Confirma que la ruta de origen del contenedor corresponda al montaje esperado del host y no a un directorio local vacío creado antes de que se montara el recurso compartido de red. Inspecciona el montaje en tiempo de ejecución y luego prueba listar, leer, crear, cambiar el nombre y eliminar como usuario de la aplicación en un subdirectorio desechable.

Un caso de Server Fault documenta una discrepancia de permisos de ACL en NFS incluso cuando las entradas de propietario y ACL parecen coincidir, lo que ilustra por qué hay que inspeccionar la máscara de ACL, la asignación del servidor y la identidad efectiva. Captura la salida de getfacl tanto del directorio como del archivo creado.

Si se pretende permitir el acceso al grupo, añade el grupo numérico suplementario admitido y vuelve a crear el contenedor, porque los grupos del proceso quedan fijados al iniciarse. Usa la guía de ZimaSpace sobre diagnóstico de rutas vacías en contenedores cuando la aplicación se inicie con una ruta vacía; se trata de un problema de orden de montaje, no de ACL.

Aplica la solución de identidad más limitada y vuelve a probar

Es preferible ajustar el UID, el GID o el grupo suplementario admitido por la aplicación a la política del NAS. Usa un grupo compartido y una ACL heredada cuando colaboren varios servicios. Evita los permisos de escritura para todos, los cambios recursivos de propiedad en conjuntos de datos no relacionados y los contenedores con privilegios como atajos.

Vuelve a crear el contenedor, vuelve a montar el recurso compartido si cambiaron las opciones de asignación y repite las mismas operaciones. Reinicia el host una vez para comprobar que el orden de montaje y la identidad numérica se mantienen tras el arranque. Confirma que los archivos recién creados sigan siendo modificables por los clientes humanos previstos, sin conceder derechos innecesarios al contenedor.

Cierra la lista de comprobación cuando la aplicación supere su carga de trabajo original, las operaciones denegadas sigan denegadas y la propiedad se mantenga estable tras reiniciar. Escala el problema si los espacios de nombres de usuario, las asignaciones sin privilegios o los servicios de identidad del NAS reescriben los identificadores de una forma que la imagen elegida no pueda admitir.

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.