¿Por qué cambian los propietarios de los archivos de un contenedor después de copiar los datos de la aplicación?

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.

Los propietarios de archivos del contenedor cambian después de una copia cuando no se conservan los valores numéricos de UID/GID o cuando el entorno de ejecución de destino los reasigna o modifica.

En un NAS doméstico, el mismo archivo puede mostrar un nombre de usuario en el host y otro dentro de un contenedor porque la propiedad se almacena como números, mientras que cada entorno resuelve esos números mediante una base de datos de cuentas distinta. Las copias realizadas mediante una interfaz gráfica, un recurso compartido SMB, un archivo, una shell de root, una herramienta de migración o un punto de entrada del contenedor también pueden reemplazar la propiedad. Diagnostica primero la identidad numérica y, después, distingue entre el comportamiento de copia, la configuración del usuario en tiempo de ejecución, los scripts de inicio, los espacios de nombres de usuario y la asignación del sistema de archivos de red antes de cambiar los permisos de todo el árbol de datos de la aplicación.

Compara los UID y GID numéricos antes de comparar los nombres de usuario

Inspecciona el origen y el destino con la propiedad numérica, no solo con los nombres. Registra el UID, el GID, el modo, las ACL, los atributos extendidos y el sistema de archivos de un archivo representativo y de su directorio principal, tanto en el host como dentro del contenedor.

Los montajes vinculados de Docker exponen archivos del host a procesos que pueden usar una base de datos de usuarios distinta. Un debate de la comunidad de Docker sobre permisos explica por qué el acceso fiable depende de la coincidencia de UID/GID numéricos, y no solo de que coincidan los nombres de usuario.

Si los números son idénticos, pero los nombres mostrados difieren, es posible que la propiedad no haya cambiado. Corrige la documentación o la asignación de cuentas en lugar de reescribir los datos de forma recursiva. Si los números difieren, conserva las pruebas y continúa con las etapas de copia y ejecución.

Determina si la copia conservó o restableció la propiedad

Anota la ruta exacta de copia: administrador de archivos del host, cp, rsync, archivo tar, cliente SMB/NFS, restauración de copia de seguridad, comando de copia de Docker o contenedor temporal de migración. Cada método tiene valores predeterminados distintos para el propietario, el grupo, las ACL y los atributos extendidos.

Una copia ejecutada como root puede conservar la propiedad numérica cuando se usan opciones de archivo explícitas, mientras que otra herramienta puede crear todos los archivos de destino con la cuenta que realiza la copia. Un problema reciente durante una migración de contenedor muestra cómo los datos de una aplicación copiados pueden volverse ilegibles cuando el UID de destino es distinto de la identidad de ejecución de la aplicación.

Repite la operación con un directorio de prueba pequeño e inspecciona la propiedad justo antes de que se inicie la aplicación. Si los números ya son incorrectos, corrige el método de copia o restaura los indicadores. Si solo cambian después del inicio, no modifiques la copia e investiga el punto de entrada del contenedor.

Haz coincidir el usuario del entorno de ejecución del contenedor con el propietario del almacenamiento del host

Inspecciona el usuario efectivo dentro del contenedor en ejecución y el propietario numérico del directorio de datos de la aplicación montado mediante bind. Comprueba también user: en Compose, los grupos suplementarios, las variables de PUID/PGID de la plataforma y los ajustes de cuenta específicos de la imagen.

Ejecutar con un usuario no root dentro del contenedor no concede automáticamente acceso a un directorio del host que pertenece a otra identidad numérica. Un caso del foro de Docker resuelve esta incompatibilidad haciendo coincidir el usuario del contenedor y los permisos del host, en lugar de hacer que el directorio permita escritura a cualquiera.

Elige un modelo de propiedad estable para la aplicación y documéntalo en Compose. Añade solo los grupos necesarios para el acceso compartido. Evita chmod 777, porque oculta la discrepancia de identidad, debilita el aislamiento y no conserva el propietario previsto para los archivos futuros.

Comprueba si el punto de entrada cambia la propiedad durante el inicio

Muchas imágenes se ejecutan brevemente como root, crean los directorios que faltan, aplican un UID/GID configurado y cambian la propiedad de forma recursiva antes de retirar los privilegios. Ese comportamiento puede hacer que una copia correcta parezca cambiar por sí sola después del primer inicio del contenedor.

Los entornos de ejecución y las imágenes de contenedores también pueden ofrecer opciones de montaje que cambian la propiedad. Un problema de Podman señala que la opción :U puede reescribir la propiedad de origen, mientras que los scripts de punto de entrada pueden realizar un cambio recursivo similar durante el inicio de la aplicación.

Inicia el contenedor una vez con los registros visibles y supervisa un pequeño subárbol de prueba. Busca en el punto de entrada y en las notas de la versión de la imagen las operaciones de chown, la migración de usuarios, PUID/PGID y los pasos para corregir permisos. Desactiva o limita ese comportamiento solo si la imagen admite una alternativa estable.

Ten en cuenta Docker sin privilegios, los espacios de nombres de usuario y los sistemas de archivos de red

Docker sin privilegios y la reasignación de espacios de nombres de usuario traducen los ID del contenedor a otro rango del host. Las opciones de montaje de NFS, CIFS y algunos NAS también pueden aplicar root-squash de forma independiente o asignar todos los archivos a un UID y GID configurados.

Un informe de permisos de Docker sin privilegios muestra archivos con una propiedad inesperada porque la identidad del contenedor se asigna a través de un rango subordinado del host. La pista para el diagnóstico es la asignación de propiedad de espacios de nombres de usuario, no un fallo de copia convencional.

Comprueba si la ruta de datos es local, NFS, CIFS, FUSE u otro sistema de archivos montado; luego registra su comportamiento en cuanto a UID/GID, root-squash y ACL. Prueba por separado la creación de archivos con la propiedad correspondiente desde el host y el contenedor. No ejecutes chown de forma recursiva en un recurso compartido de red hasta comprender la política de identidad del servidor.

Repara la propiedad con una identidad de aplicación conocida

Detén la aplicación, haz una copia de seguridad de los metadatos actuales y define los UID, GID, modos de directorio, modos de archivo, ACL y etiquetas de seguridad exactos que espera la imagen. Corrige solo las rutas propiedad de la aplicación; excluye los medios compartidos y los conjuntos de datos no relacionados.

La guía de ZimaSpace sobre cómo distinguir los errores de permisos de los montajes de solo lectura es el siguiente paso si la propiedad es correcta, pero aún no se puede escribir.

Reinicia el contenedor y crea, modifica y elimina un archivo de prueba con el usuario real del servicio. Luego, vuelve a crear el contenedor y repite la prueba. La reparación solo estará completa cuando la propiedad se mantenga estable después de copiar, iniciar, reiniciar y volver a crear el contenedor, y la aplicación pueda leer y escribir sin excepciones de permisos generales.

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.