¿Por qué Immich pierde el acceso a los datos persistentes después de recrear la pila?

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.

Cuando Immich parece vacío o no puede leer la biblioteca tras recrear la pila, da por hecho que los datos persistentes antiguos están desconectados o son ilegibles antes de suponer que se eliminaron.

Recrear los contenedores puede cambiar la identidad del proyecto de Compose, la fuente del montaje enlazado, el volumen con nombre adjunto, el momento en que está disponible el recurso compartido de red o el UID/GID con el que se leen los datos. Detén la instancia que parece nueva antes de que escriba mucho estado nuevo, localiza en el host las rutas antiguas de la base de datos y los archivos multimedia, y compara la pila recreada con la última asignación que funcionaba correctamente. El objetivo es volver a conectar primero el estado existente; recurre a una copia de seguridad solo después de confirmar que ese estado realmente falta o está dañado.

Detén la instancia nueva y confirma que los datos antiguos siguen ahí

Un asistente de configuración, una cronología vacía o una biblioteca externa ausente inmediatamente después de recrear los contenedores es una advertencia de persistencia. Detén Immich e inspecciona las ubicaciones de la base de datos y los archivos multimedia en el host antes de subir archivos nuevos o aceptar una nueva configuración vacía. Las escrituras nuevas pueden dificultar las comparaciones posteriores de rutas.

Comprueba que los directorios antiguos contengan el número de archivos esperado, las fechas de modificación, los archivos o volcados de la base de datos y algunas imágenes originales representativas. Si los datos están en el host, el problema es de acceso o de asignación, no de desaparición. Crea una instantánea o una copia de seguridad de solo lectura de ese estado antes de cambiar los propietarios o mover los directorios.

Si no encuentras los datos antiguos en las rutas previstas, busca en el grupo de almacenamiento y en el inventario de volúmenes de Docker antes de borrar nada. La decisión es binaria: se localiza y protege el estado existente, o realmente no está disponible y la recuperación recurre a una copia de seguridad fiable en vez de intentar reparar los montajes.

Compara los montajes recreados con los de la pila anterior

Inspecciona los montajes efectivos de los contenedores recreados de Immich y de la base de datos, no solo el texto de Compose que recuerdas haber editado. Una ruta de montaje enlazado relativa puede resolverse desde otro directorio del proyecto, y un proyecto de Compose con otro nombre puede adjuntar un volumen con nombre nuevo y dejar intacto, pero sin usar, el anterior.

Un montaje fallido, cambiado o ausente puede hacer que un directorio aparezca vacío dentro de un contenedor, aunque los datos esperados sigan existiendo en otro lugar del host. Usa las comprobaciones de montaje de volúmenes de Docker para comparar Source, Destination, el tipo de montaje y la identidad del volumen con nombre de cada ruta persistente de Immich. Una discrepancia en estos datos explica directamente que la instancia parezca nueva.

Corrige solo la asignación de montaje incorrecta y, a continuación, crea o inicia el contenedor sin eliminar volúmenes. Si los archivos esperados aparecen en la misma ruta del contenedor después del cambio, deja los datos donde están. Si la lista de montajes es correcta pero el acceso sigue fallando, conserva la asignación y pasa a comprobar la disponibilidad y los permisos del almacenamiento del host en lugar de crear otro volumen.

Verifica que el almacenamiento externo estuviera montado antes de que se iniciara Immich

Si los datos de Immich están en un grupo de discos HDD, un recurso compartido NAS, una capa de fusión u otro montaje externo, confirma que el almacenamiento esté realmente montado en el host antes de que Docker inicie la pila. Una ruta como /mnt/photos puede seguir existiendo como un directorio local normal cuando el dispositivo real no está disponible.

Los datos persistentes de Docker sobreviven a la sustitución de un contenedor solo cuando se vuelve a conectar correctamente el volumen o el montaje enlazado previsto. El modelo de persistencia de volúmenes de Docker subyacente no hace que aparezca automáticamente un disco del host o un recurso compartido de red que no está disponible, así que verifica el dispositivo de almacenamiento y un archivo conocido en el host antes de probar la misma ruta dentro de Immich.

Si descubres que se han escrito archivos de respaldo en el punto de montaje vacío mientras el almacenamiento real no estaba disponible, detén Immich antes de montar el dispositivo encima de esos archivos. Reconcilia esos archivos por separado, añade una dependencia de inicio o una comprobación de estado para el montaje del almacenamiento y, solo entonces, reinicia la pila. Si el almacenamiento del host es estable y la ruta del contenedor sigue sin poder leerse, continúa con el apartado de permisos.

Comprueba el UID, el GID y los permisos de los directorios sin reescribirlo todo

Al recrear una pila, un servicio puede ejecutarse con una identidad numérica, un espacio de nombres de usuario o un contexto de seguridad diferentes a los anteriores. El resultado es distinto al de un punto de montaje ausente: la ruta existe y los archivos son visibles desde el host, pero los registros de Immich muestran errores de permisos o la imposibilidad de crear los archivos esperados.

Compara la propiedad numérica y los bits de permisos de los directorios del host afectados con la identidad de usuario dentro del contenedor recreado. Primero prueba una lectura inocua y, después, una escritura reversible en una ubicación desechable dentro del mismo punto de montaje. Evita cambiar recursivamente la propiedad de todo el archivo fotográfico hasta saber qué servicio necesita acceso de escritura y qué archivos originales deben permanecer intactos.

Corrige la discrepancia mínima de directorio o identidad que explique el fallo, reinicia una vez y vuelve a revisar los registros. Si el acceso sigue fallando con los puntos de montaje y los permisos coincidentes, deja de hacer cambios en el sistema de archivos e inspecciona la conexión a la base de datos, la sustitución de variables de entorno o la capa de seguridad que cambió al recrear la pila.

Vuelve a conectar el estado original y valida otra recreación

Cuando las rutas de la base de datos y los archivos multimedia anteriores estén vinculadas y sean legibles, inicia Immich y comprueba que aparezcan los usuarios, álbumes, personas y archivos representativos de antes. No des por completada la reparación solo porque se cargue la página de inicio; verifica que la aplicación esté leyendo el estado original y no una base de datos recién inicializada junto a él.

La distinción útil es que los contenedores pueden ser desechables, mientras que los datos de las aplicaciones deben permanecer en un almacenamiento estable, fuera del ciclo de vida del contenedor. Documenta los nombres de los puntos de montaje corregidos y las rutas del host, y utiliza funciones de almacenamiento persistente para servidores de archivos para que, al volver a crear la pila, esta siga vinculada a los mismos datos.

Por último, vuelve a crear la pila una vez más en condiciones controladas y repite las comprobaciones originales. La solución solo queda demostrada si la misma base de datos y los mismos archivos multimedia vuelven a aparecer tras recrear la pila y reiniciar el host. Si el estado anterior vuelve a desaparecer, o si la base de datos indica que está dañada en lugar de mostrar errores de acceso, vuelve a la copia protegida y opta por recuperar la base de datos o la copia de seguridad en vez de seguir experimentando con los puntos de montaje.

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.