Cómo evitar que cambien los permisos de las carpetas de datos de Immich

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.

Evitar la deriva de permisos en Immich significa establecer reglas predecibles de propiedad y acceso a los archivos antes de que distintos contenedores, protocolos NAS, actualizaciones o tareas de mantenimiento creen archivos con identidades diferentes.

La solución duradera no consiste en restablecer periódicamente los permisos de forma recursiva. Registra los UID/GID numéricos y el acceso que realmente necesita cada flujo de trabajo, define deliberadamente la propiedad de los puntos de montaje y la herencia de ACL, separa las rutas de solo lectura de las que permiten escritura y prueba la ruta de creación después de cada cambio. Se evita la deriva de permisos cuando el próximo archivo nuevo se crea correctamente sin recurrir de emergencia a `chown`, no cuando la biblioteca de hoy simplemente se puede leer.

Registra las identidades que leen y escriben en cada ruta de Immich

Enumera las rutas del host montadas en Immich e identifica qué procesos deben leer, crear, renombrar o eliminar archivos en cada una. Para cada proceso de escritura, registra su UID y GID numéricos en el host y dentro del contenedor. Los ID numéricos importan más que la coincidencia de los nombres de usuario, porque los archivos almacenan la propiedad como números.

Incluye en el inventario los procesos que escriben fuera de Immich. Las cargas mediante SMB, los clientes NFS, las herramientas de copia de seguridad, los scripts de importación, los contenedores de gestión de archivos multimedia y una consola de administrador pueden crear archivos en el mismo árbol. Si lo hacen con distintas identidades, la biblioteca puede acumular poco a poco propietarios y permisos que funcionan en una ruta, pero fallan en otra.

Guarda este mapa de identidades junto con la configuración de Compose. Así, podrás comparar una futura actualización de la imagen, migración del servidor o restauración de una cuenta de NAS con una referencia conocida como correcta, en vez de descubrir la discrepancia cuando empiecen a fallar las cargas nuevas.

Usa un modelo deliberado de propietario, grupo compartido y acceso mínimo

Decide qué identidad debe ser propietaria de los datos gestionados por la aplicación y qué grupo compartido, si lo hay, necesita acceso. Concede a cada flujo de trabajo solo los permisos de lectura o escritura que requiera. Evita que todo el árbol de Immich tenga permisos de escritura para todos solo porque un contenedor no puede crear una miniatura o mover un archivo importado.

Las discrepancias de UID/GID y los permisos demasiado amplios son causas frecuentes de fallos en los volúmenes compartidos. La opción más segura es hacer coincidir los permisos del contenedor y del volumen, en lugar de conceder acceso sin restricciones. Esto es importante en un servidor doméstico donde varios servicios pueden acceder al mismo conjunto de almacenamiento.

Si varios servicios necesitan acceso de escritura, usa un grupo compartido y permisos de grupo o ACL coherentes, en lugar de alternar la propiedad recursiva entre aplicaciones. Comprueba primero un directorio representativo. Los cambios recursivos amplios en toda la biblioteca de fotos deben ser el último recurso y hacerse con una copia de seguridad reciente, no como mantenimiento rutinario.

Haz que los permisos de los archivos nuevos sean predecibles

Los archivos existentes pueden parecer perfectos mientras que los nuevos empiezan a desviarse de inmediato porque las reglas de creación son incorrectas. Comprueba la ACL del directorio principal, las entradas de ACL predeterminadas, umask, la identidad del servicio y cualquier ajuste de creación de SMB o NFS que se aplique a la ruta. El objetivo de prevención es la herencia, no la limpieza.

Antes de cambiar los modos de forma recursiva, compara la propiedad numérica en el host con el UID/GID que realmente se ejecuta dentro del contenedor. Esta comprobación de UID/GID del montaje enlazado permite distinguir rápidamente una discrepancia de identidad de un permiso realmente ausente. Corrige la relación entre propietario y grupo en lugar de ocultar el problema con modos demasiado permisivos.

Crea un archivo de prueba pequeño mediante cada vía de escritura habitual: carga de Immich, flujo de trabajo de importación, transferencia SMB/NFS si se usa y restauración de una copia de seguridad. Inspecciona el propietario, el grupo, el modo y las ACL después de cada prueba. Si dos vías de creación producen resultados incompatibles, resuelve ese conflicto de políticas antes de importar más datos.

Evita que los cambios de montaje y las actualizaciones reescriban la propiedad

Considera cualquier edición de Compose, actualización de imagen, nuevo montaje del NAS o migración como un cambio sensible a los permisos. Antes de aplicarlo, registra el origen y el destino actuales del montaje, si la ruta es de solo lectura o de lectura y escritura, el usuario efectivo del contenedor y una muestra de la propiedad numérica de cada directorio importante.

Las transferencias y el almacenamiento en red pueden introducir identidades SMB/NFS, ID numéricos, herencia de ACL y comportamientos de umask diferentes. Usa los puntos de fallo por cambios de permisos en el NAS como lista de comprobación previa a los cambios siempre que los datos de Immich se muevan entre sistemas de archivos o métodos de acceso.

Después del cambio, compara las mismas muestras antes de ejecutar tareas masivas. Si la propiedad cambia de repente al iniciar el sistema, detén la pila e identifica qué punto de entrada, tarea de mantenimiento o identidad reasignada lo provocó. No permitas que una reescritura recursiva de la propiedad sin explicación continúe en una biblioteca grande.

Audita las desviaciones con pruebas pequeñas y repetibles

Programa una auditoría ligera de permisos o ejecútala después de las actualizaciones: comprueba algunos originales estables, una carga reciente, un derivado recién generado y cualquier montaje de biblioteca externa. Busca propietarios inesperados, falta de acceso al grupo, montajes de solo lectura que se hayan vuelto escribibles o ACL que ya no se hereden como se esperaba.

A continuación, realiza una prueba de escritura de extremo a extremo. Sube un archivo prescindible mediante el cliente habitual, deja que Immich lo procese, ábrelo y elimínalo desde la aplicación. Si tu configuración incluye bibliotecas externas o rutas de importación, añade un archivo representativo mediante esas rutas y confirma que Immich puede leerlo sin cambiar inesperadamente su propietario.

El ciclo de prevención solo está completo cuando los archivos nuevos siguen recibiendo la identidad y los permisos de acceso previstos después de reiniciar Immich y reiniciar el host. Si los permisos requieren una reparación manual después de cualquiera de estos eventos, el sistema sigue desviándose; corrige la regla de creación o la asignación de identidades antes de ampliar el acceso.

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.