Immich muestra datos obsoletos después de cambiar una ruta de almacenamiento

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 datos obsoletos de Immich tras un cambio en la ruta de almacenamiento pueden deberse a tres causas distintas que no deben confundirse: un traslado de la raíz de medios administrados, un cambio de la ruta de importación de una biblioteca externa o un cliente que todavía muestra datos en caché. Las versiones modernas de Immich pueden conciliar una ubicación de medios administrados trasladada cuando la ubicación configurada y el montaje del volumen se mantienen coherentes, mientras que los traslados de bibliotecas externas aún pueden tratarse como identidades de recursos nuevas.

Conserva la ruta antigua y la base de datos antes de volver a analizar. Primero comprueba qué ruta ve el contenedor en ejecución y luego determina si el registro del servidor de Immich es incorrecto o si solo está desactualizado un cliente. Esa distinción determina si debes reparar un montaje, restaurar una ruta estable visible para el contenedor, volver a analizar un subconjunto de prueba o borrar solo la caché del cliente.

Distingue entre el traslado de la raíz de medios administrados y el de una biblioteca externa

Si cambiaste la ubicación en el host de las cargas administradas por Immich, verifica que la configuración efectiva de la ubicación de los medios y el montaje entre el host y el contenedor hayan cambiado conjuntamente. Un traslado moderno de medios administrados no debe diagnosticarse igual que un cambio de nombre de una ruta de importación de una biblioteca externa.

El mapa del estado persistente de Immich de ZimaSpace resulta útil aquí porque la base de datos y las rutas del sistema de archivos forman un mismo límite de recuperación. No basta con tener los archivos correctos en el host si el contenedor está montado en otra ubicación.

Si la raíz de medios administrados no coincide, corrige primero el entorno y la asignación de volúmenes, y reinicia el servicio antes de ejecutar tareas de la biblioteca. Si la ruta cambiada pertenece a una biblioteca externa, conserva intacta la base de datos y prueba esa situación por separado.

Mantén estable la ruta de la biblioteca externa en el contenedor siempre que sea posible

En una biblioteca externa, lo más seguro es mover el almacenamiento en el host manteniendo sin cambios la ruta de importación visible para el contenedor. Si cambia la ruta que se presenta a Immich, registra un pequeño conjunto de ID de recursos, álbumes, personas y rutas antiguas antes de iniciar un análisis, para poder comprobar si los recursos existentes se volvieron a vincular o se crearon de nuevo.

Un informe de cambio de rutas de una biblioteca externa de Immich describió cómo los archivos reubicados se trataron como recursos nuevos, se volvieron a procesar y perdieron las relaciones existentes solo en Immich. Es un caso específico de una versión, pero respalda la regla prudente de que un cambio en la ruta de una biblioteca externa no equivale automáticamente a un cambio de nombre transparente.

Si un subconjunto de prueba aparece como recursos nuevos mientras los registros antiguos figuran como ausentes o en la papelera, detén el análisis completo. Si es viable, restaura la ruta anterior visible para el contenedor o usa un método de migración adecuado para la versión; no reescribas manualmente las rutas en la base de datos de producción sin una copia de seguridad probada.

No confundas este caso con una migración de Storage Template para archivos administrados por Immich. El síntoma puede parecerse en la cronología, pero la propiedad de los archivos y la ruta de migración compatible son diferentes.

Distingue las rutas almacenadas en el servidor de la caché del cliente

Inspecciona el mismo recurso conocido desde el cliente web y otro cliente autenticado y compáralos con los registros del servidor o la ruta visible para el servidor. Si los trabajos del servidor siguen indicando la ruta antigua, borrar la caché del navegador no puede reparar el registro subyacente.

Más adelante, un problema de metadatos de una ruta antigua de Immich mostró que el procesamiento seguía haciendo referencia a una ruta anterior de la biblioteca externa después de cambiarla de nombre. Esto es un indicio sólido de que conviene comprobar las rutas usadas por los trabajos antes de culpar a la interfaz web o móvil.

Si la ruta del servidor es correcta, pero solo una vista web está desactualizada, actualiza o borra la caché de ese cliente y vuelve a probar el archivo original. Las miniaturas en caché y el estado obsoleto del cliente pueden hacer que un servidor ya reparado parezca averiado, mientras que una vista previa en caché también puede hacer que una ruta del servidor averiada parezca correcta.

Repara el límite mínimo de la ruta y valida un análisis controlado

Realiza una única corrección reversible: sincroniza la configuración de medios administrados con el montaje, restaura la ruta anterior de la biblioteca externa dentro del contenedor, corrige una ruta de importación o borra la caché de un cliente. Haz una copia de seguridad de la base de datos antes de cualquier acción que pueda provocar que se vuelva a detectar una biblioteca grande.

Ejecuta el análisis de nuevo más pequeño que resulte práctico y comprueba si los registros existentes siguen asociados, si dejan de aparecer errores de rutas antiguas y si no aparecen recursos duplicados con rutas antiguas y nuevas. Después, abre algunos originales, verifica las relaciones con álbumes y personas, realiza una búsqueda y reinicia la pila.

Escala el problema si los registros de las rutas antigua y nueva siguen activos a la vez, se vuelve a procesar inesperadamente una biblioteca externa grande o desaparecen las relaciones mientras los originales siguen siendo legibles. Conserva el mapa exacto de montajes antes y después, la versión de Immich, los ID de los recursos afectados, el comportamiento del sistema de archivos con mayúsculas y minúsculas y la marca de tiempo de la copia de seguridad de la base de datos.

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.