Bibliotecas externas de Immich: guía para un archivo fotográfico de solo lectura

Supongamos que tus fotos ya están en carpetas en las que confías. Quieres una cronología con función de búsqueda sin ceder a otra aplicación el control de los originales. Las bibliotecas externas de Immich pueden indexar esas carpetas, mientras que un montaje de solo lectura restringe las escrituras a través de esa conexión. Hay límites: la indexación no añade una copia de seguridad, los cambios requieren un análisis y algunas modificaciones de metadatos realizadas en la aplicación pueden no guardarse.

Esta guía te ayuda a decidir si esa configuración encaja con tu archivo. Propone una prueba piloto con una carpeta pequeña en una instalación de Docker existente y autorizada. La prueba piloto no se ha ejecutado; no es un tutorial completo de instalación ni una evaluación comparativa de búsquedas.

Elige entre cargas gestionadas y una biblioteca externa

Cuándo tus carpetas existentes deben seguir siendo la fuente de referencia

Empieza por determinar quién controla los originales. Una biblioteca externa hace un seguimiento de los archivos situados fuera del almacenamiento gestionado de Immich y crea registros de elementos multimedia en la base de datos para explorarlos. Las cargas gestionadas colocan los originales en el almacenamiento gestionado por Immich, como se describe en la documentación sobre almacenamiento. Elige según dónde quieras mantener el archivo.

Como explica la documentación sobre bibliotecas externas, la indexación evita tener que cargar una copia gestionada de esos originales. Sigues necesitando espacio para la base de datos y los elementos generados. Prevé espacio para ambos.

La experiencia práctica de Jaisen Mathai ofrece un ejemplo concreto: mantiene Elodie como organizador de su archivo y utiliza carpetas externas de solo lectura con Immich. La escritura de cambios EXIF en su archivo depende de una integración personalizada. Considérala su configuración particular, no una función integrada ni el resultado de una implementación de Optijara.

La distinción entre una fuente y sus copias también importa al preparar exportaciones de imágenes y recursos vinculados. Esa guía trata la entrega de materiales de creadores en lugar de la configuración de Immich, pero la decisión sobre quién los controla está relacionada.

Distingue entre el archivo, la ruta del contenedor y el propietario de la biblioteca

Un montaje de solo lectura limita la escritura, no define una política de acceso

Tu carpeta en el equipo anfitrión tiene una ruta. Dentro de un contenedor, esa misma carpeta puede tener otra ruta. Ninguna de las dos indica a Immich qué cuenta debe ser propietaria de la biblioteca. Según las instrucciones sobre propiedad y rutas, eliges un propietario al crearla y no puedes cambiarlo después. El acceso de administrador no convierte a todos los usuarios en propietarios.

El sufijo :ro impide que Immich borre los originales o escriba archivos auxiliares a través del montaje de origen. Las aplicaciones del equipo anfitrión pueden seguir cambiando esos archivos. Los permisos de visualización y las copias de seguridad requieren atención por separado. Sigue la guía de montaje: añade un montaje externo independiente, conserva ${UPLOAD_LOCATION}:/data y mantén todos los montajes gestionados existentes.

Esta es la ruta de lectura propuesta. No se ha realizado ninguna implementación para este artículo.

La base de datos y los elementos generados siguen necesitando almacenamiento de la aplicación con permiso de escritura. Solo el montaje de origen es de solo lectura.

Realiza una pequeña prueba piloto con un archivo de solo lectura

Monta una carpeta de muestra y configura su ruta

Utiliza la lista de comprobación propuesta, Montar, Configurar la ruta, Analizar, Verificar, para limitar el alcance del primer intento. Es un esquema editorial, no una función de Immich ni un proceso probado por Optijara. Antes de empezar, confirma que Docker Compose funciona y que tienes autorización de administrador. Elige archivos multimedia de muestra sin riesgo y con permisos de lectura. Deja las fotos privadas de producción fuera de la prueba piloto.

1. Montar. Añade la siguiente entrada a la lista volumes del servicio immich-server existente. Sustituye el marcador en mayúsculas por la ruta absoluta de la carpeta de muestra en el equipo anfitrión. Conserva todos los montajes gestionados existentes. Este fragmento ilustrativo está incompleto y no se ha ejecutado; no puede utilizarse como un archivo Compose independiente.

- /ABSOLUTE/HOST/SAMPLE:/mnt/photos-source:ro

Aplicar el cambio requiere una acción independiente del operador. Sigue la guía oficial para actualizar los montajes. Aquí no se informa de ningún reinicio de contenedores.

1. Configurar la ruta. Confirma que /mnt/photos-source se puede leer dentro de cada contenedor de servidor o de procesamiento separado que corresponda. Comprueba los permisos reales. Las indicaciones para resolver problemas señalan la ausencia de montajes en los procesos de trabajo y los problemas con enlaces simbólicos, así que no des por hecho que un enlace simbólico entre montajes funcionará.

Crea la biblioteca en Administración > Bibliotecas externas y selecciona el propietario previsto. Introduce /mnt/photos-source como ruta de importación. /ABSOLUTE/HOST/SAMPLE pertenece al equipo anfitrión; Immich necesita el directorio visible dentro de sus contenedores. Detente si no se puede acceder a ese directorio.

Analiza y verifica antes de ampliar

1. Analizar. Añade exclusiones antes del análisis. Por ejemplo, utiliza /Raw/ solo si quieres excluir los directorios llamados Raw y su contenido, no todos los archivos en formato raw. Las reglas documentadas para los patrones se aplican de forma recursiva a las rutas completas y no distinguen entre mayúsculas y minúsculas. Después, inicia el análisis de la biblioteca.

1. Verificar. Registra lo que observes. La siguiente tabla es una propuesta de plan de medición, no evidencia de pruebas realizadas.

Deja las pruebas de borrado y la creación de enlaces públicos fuera de esta prueba piloto. Si el propietario o el límite de acceso difieren de tu plan, detén la ampliación e investiga. Conceder acceso de escritura para superar un error cambia la configuración que querías probar.

Una nota breve de planificación permite registrar la intención por separado de las observaciones. El valor de la ruta de importación que figura a continuación identifica el tipo de ruta requerido; introduce el directorio real /mnt/photos-source en Immich. Este JSON es una nota, no la configuración de la aplicación ni una prueba de éxito.

{
  "workflow": "mount-map-scan-verify",
  "import_path_kind": "container-visible",
  "source_access": "read-only",
  "status": "proposed-unexecuted"
}

Interpreta los análisis y los trabajos en segundo plano sin dar por hecha una sincronización en tiempo real

La detección no equivale a un procesamiento terminado

Encontrar un archivo es solo parte del trabajo. Los análisis crean elementos multimedia; la extracción de metadatos y la generación de miniaturas tienen sus propios trabajos. El procesamiento para las búsquedas también influye en cuándo están listos los elementos. La guía de bibliotecas externas indica a los administradores que inspeccionen los trabajos de Biblioteca, Generar miniaturas y Extraer metadatos. La documentación sobre procesos de trabajo explica ese procesamiento en segundo plano.

Que una foto aparezca en la cronología no indica si todos los trabajos correspondientes han terminado. Inspecciona los estados de los trabajos y los errores antes de valorar la calidad de las búsquedas. Esta guía no establece ni una duración del procesamiento ni que el archivo esté completo.

Para una comprobación hipotética, selecciona un archivo de muestra de nombre conocido y registra si aparece para el propietario previsto. Conserva la ruta de importación y el estado de los trabajos en el momento de la inspección. Si el archivo no aparece, guarda el contexto del error antes de cambiar la configuración. Una vez corregido el problema identificado, repite la misma comprobación. Cambiar a una consulta más sencilla te diría poco sobre si la corrección ha ayudado. Incluso una segunda comprobación satisfactoria no dice nada sobre los archivos que no has examinado.

Nuevos análisis, programación y vigilancia experimental

Los cambios externos requieren un nuevo análisis o una actualización de metadatos adecuados. Immich documenta un análisis automático diario de la biblioteca cuya programación pueden cambiar los administradores. Su vigilancia del sistema de archivos es una función experimental independiente para usuarios avanzados. La advertencia sobre la vigilancia indica que probablemente no funcionará con fotos en una unidad de red. Planifica análisis periódicos, salvo que hayas verificado otra configuración para tu almacenamiento.

Si faltan elementos o están desactualizados, revisa la visibilidad del origen y las rutas de importación; después, inspecciona las exclusiones, los permisos y los trabajos. La misma documentación señala que la caché del navegador puede retrasar la actualización de las vistas. Ten presente esa posibilidad, pero no la utilices para justificar una comprobación fallida sin investigarla. Encuentra la causa antes de añadir más carpetas.

Conoce qué pueden conservar los archivos auxiliares XMP y qué no

Los campos compatibles no abarcan toda la biblioteca

La advertencia general sobre bibliotecas indica que los metadatos de la aplicación no se guardan en los archivos multimedia externos. La documentación de XMP describe una compatibilidad complementaria con archivos auxiliares: se pueden leer determinados campos de archivos auxiliares adyacentes y, con el acceso de escritura adecuado, escribirlos de nuevo en ellos. Esa escritura no modifica directamente los archivos multimedia originales.

Las categorías compatibles incluyen descripción y valoración, además de fecha y hora, ubicación y etiquetas. Las correspondencias entre campos y los desencadenantes automáticos de trabajos difieren. La pertenencia a álbumes y la organización de personas no deben considerarse un formato XMP portátil completo; la disposición de la interfaz tampoco está incluida en esa garantía.

Para IMG_0001.jpg, Immich da prioridad a IMG_0001.jpg.xmp frente a la alternativa IMG_0001.xmp cuando ambos existen. Determinados metadatos extraídos se incorporan a la base de datos. El trabajo DISCOVER vincula los archivos auxiliares recién encontrados a los archivos multimedia que aún no tienen uno asociado; SYNC vuelve a leer los archivos auxiliares vinculados tras cambios externos. Ninguno de estos trabajos establece una resolución universal de conflictos entre editores.

La advertencia sobre la edición de metadatos en modo de solo lectura

Lee esta advertencia antes de intentar editar. Según la advertencia de XMP sobre el modo de solo lectura, los cambios de metadatos en elementos con archivos auxiliares de solo lectura pueden fallar silenciosamente tanto en el archivo auxiliar como en la base de datos. Un cambio aparente en la interfaz no demuestra que la base de datos lo haya guardado.

Para esta prueba piloto, explora en Immich y edita los metadatos del archivo en la herramienta externa que elijas. Quitar :ro para que funcione la edición también permite borrar archivos de origen, como explica la guía de bibliotecas externas. Eso merece una decisión deliberada, no un atajo para resolver problemas.

Los metadatos descriptivos también tienen una finalidad distinta de las pruebas de autoría. Para archivos multimedia generados o editados, la guía de procedencia del contenido visual aborda los registros de origen y las credenciales firmadas. Una descripción de Immich no puede sustituir esos registros.

Verifica la exploración con archivos conocidos antes de confiar en la búsqueda inteligente

Utiliza nombres de archivo, carpetas y fechas para comprobaciones puntuales

Para esta prueba piloto, una sencilla comprobación de un nombre de archivo resulta más útil que una demostración impresionante de búsqueda semántica. Empieza con un nombre de archivo conocido o un fragmento. Después, utiliza Ruta completa o carpeta y un intervalo de tiempo esperado. Estos filtros de búsqueda documentados te permiten inspeccionar la muestra elegida sin interpretar coincidencias descriptivas. Siguen siendo comprobaciones puntuales, no una prueba de indexación completa.

Si necesitas la jerarquía existente, activa la vista opcional de carpetas en Ajustes de la cuenta > Funciones > Carpetas, como se describe en la guía de bibliotecas. Te ofrece otra forma de explorar; tu herramienta externa sigue organizando el origen.

La búsqueda contextual con CLIP acepta consultas libres sin exigir palabras clave literales en los metadatos. Utilízala para encontrar posibles coincidencias, no para establecer que se abarca todo el archivo. La documentación recomienda tener en cuenta los idiomas de las consultas y los recursos del modelo. El equilibrio entre memoria y procesamiento varía según el modelo elegido, por lo que un resultado atractivo es una base insuficiente para recomendar un modelo. Confirma que los archivos sean visibles por nombre y ruta antes de evaluar búsquedas descriptivas.

Evita los errores que desvinculan los archivos de su historial en la biblioteca

Mover un archivo no equivale a un simple cambio de nombre en la base de datos

Define la organización del origen antes de dedicar tiempo a organizar la colección en la aplicación. Según el comportamiento documentado al mover archivos, mover un archivo de origen dentro de una biblioteca puede crear un nuevo elemento en el siguiente análisis y hacer que se pierdan metadatos previos exclusivos de Immich o asociaciones con álbumes. No des por hecho que la base de datos seguirá una reorganización del sistema de archivos.

Borrar un archivo de origen mueve su elemento a la papelera en el siguiente análisis. Dejarlo fuera de todas las rutas de importación tiene el mismo efecto. Una entrada en la papelera no es una copia del original que falta; restaura el propio archivo de origen.

Se pueden evitar varios errores habituales:

• Si introdujiste la ruta del equipo anfitrión en la interfaz, sustitúyela por la ruta de importación visible dentro del contenedor.
• Un montaje únicamente en el contenedor de la API es insuficiente cuando los procesos de trabajo correspondientes necesitan acceso de lectura a la misma ruta de origen.
• Corrige la ausencia de :ro antes de analizar más carpetas.
• Planifica análisis periódicos para tu almacenamiento en lugar de dar por hecho que la vigilancia funciona en todas partes.
• Trata con cautela las modificaciones aparentes de metadatos, de acuerdo con la advertencia de XMP sobre el modo de solo lectura.

Repite la pequeña prueba piloto cada vez que cambie un supuesto de partida.

Define los límites antes de utilizar un archivo más grande

Almacenamiento, uso compartido y mantenimiento continuo

Antes de ampliar, confirma el propietario previsto y las rutas legibles en los contenedores correspondientes. Comprueba que el montaje de origen siga siendo de solo lectura y revisa las observaciones de la muestra. Resuelve los errores inexplicados de los trabajos. Acuerda dónde se editarán los metadatos y elige una programación de análisis. Cualquier comprobación que no se haya realizado sigue pendiente.

La indexación no añade ninguna copia de tus originales. Los volcados de la base de datos contienen metadatos, no fotos ni vídeos, así que protege las carpetas de origen externas por separado de los datos gestionados de Immich. Los procedimientos de copia de seguridad y restauración quedan fuera de esta guía.

Los permisos de visualización necesitan su propia revisión. El uso compartido en Immich distingue entre quienes pueden ver un álbum y quienes pueden editarlo. El acceso de pareja puede abarcar una biblioteca entera, mientras que los enlaces públicos ofrecen opciones como contraseñas o caducidad. Mantén el uso compartido sin cambios durante la prueba piloto.

Ten en cuenta el mantenimiento de la instalación y el almacenamiento de los archivos multimedia generados, así como los recursos del modelo y la resolución de problemas de los trabajos. Revisa la privacidad y la exposición por separado de los permisos de escritura del sistema de archivos. No se promete ningún ahorro ni resultado de seguridad. La indexación externa encaja cuando quieres que Immich permita explorar un archivo mantenido en otro lugar y puedes aceptar los límites de los metadatos. Si la sincronización con escritura es un requisito, resuélvelo antes de ampliar.