Immich puede usar de forma fiable un recurso compartido de red para los medios o una biblioteca externa si se diseñan y prueban el montaje, los permisos, la latencia y el comportamiento ante interrupciones, pero su directorio de datos de PostgreSQL debe permanecer en un almacenamiento compatible y de baja latencia, no en un recurso compartido SMB o NFS genérico.
La palabra «datos» oculta distintas cargas de trabajo: los originales son archivos grandes y duraderos, las miniaturas generan muchas operaciones pequeñas, las bibliotecas externas pueden ser de solo lectura y PostgreSQL requiere las características propias de un sistema de archivos para bases de datos. Decide la ubicación de cada ruta por separado, monta el recurso compartido antes de iniciar los contenedores, impide que un directorio local vacío se haga pasar por el NAS y comprueba el comportamiento tanto tras reiniciar el host como durante una interrupción controlada del recurso compartido.
Clasifica cada ruta de Immich antes de moverla
Enumera por separado la biblioteca de cargas, las miniaturas o los medios codificados, las bibliotecas externas, el directorio de la base de datos, la caché de modelos y las copias de seguridad. Indica quién escribe en cada ruta y el impacto de perderla. Un recurso compartido de medios puede ser viable; tratar todos los volúmenes como intercambiables no supera el criterio de diseño.
Una guía práctica de NFS muestra cómo asignar una biblioteca externa de Immich desde un almacenamiento compartido. Su patrón de montaje de biblioteca externa es útil para planificar rutas y permisos, pero no demuestra que la base de datos deba usar NFS.
Mantén PostgreSQL en un almacenamiento recomendado para bases de datos y protégelo con volcados nativos y copias de seguridad. Si el almacenamiento local activo es limitado, mueve únicamente la ruta de medios que más capacidad consuma, según las mediciones, y documenta ese límite en lugar de reubicar todo el estado de la aplicación.
Haz determinista el orden de los montajes remotos
Monta el recurso compartido en el host con credenciales o reglas de exportación explícitas, una dirección estable y el modo de lectura y escritura previsto. Verifica la identidad del sistema de archivos y un archivo marcador conocido antes de iniciar Immich. Vincula las rutas del host ya montadas a los contenedores.
Configura el gestor de servicios para que Immich espere al montaje remoto y no se inicie con un directorio alternativo vacío. El arranque solo se supera cuando el marcador está visible dentro del contenedor y un archivo de prueba recibe el propietario previsto; un directorio vacío o un archivo propiedad de root son motivos para detenerse.
Reinicia una vez con el recurso compartido disponible y otra vez con él deliberadamente no disponible durante una ventana de mantenimiento. La primera prueba solo se supera cuando el marcador aparece antes de que se inicie Immich; la segunda, solo cuando Immich se detiene o falla de forma visible en lugar de escribir en el punto de montaje local vacío.
Demuestra la identidad del contenedor y los permisos del recurso compartido
Haz coincidir las identidades numéricas de usuario y grupo en el servidor, el cliente y el contenedor; luego prueba crear, cambiar el nombre, leer y eliminar archivos en una carpeta desechable específica. No soluciones una discrepancia con permisos de escritura globales que expongan la biblioteca familiar.
Repite la prueba con un archivo desechable desde dentro del contenedor del servidor de Immich, no solo desde el host. Confirma que el NAS ve el propietario numérico previsto y que Immich puede volver a abrir el archivo después de recrear el contenedor. Superar la prueba desde el host no demuestra que la ruta del contenedor funcione.
Si las identidades o el comportamiento de creación y cambio de nombre difieren, detente y corrige la configuración concreta de exportación, montaje o correspondencia de contenedor. Repite la prueba antes de analizar una biblioteca real; los cambios generales de permisos pueden ocultar la discrepancia y, a la vez, exponer todas las fotos familiares a servicios no relacionados.
Mide la latencia y prueba una interrupción del recurso compartido
Realiza una carga representativa, genera miniaturas, explora la cronología, descarga el original y analiza una biblioteca externa mientras mides la latencia del servidor y el progreso de las tareas. Para aprobar, la interacción debe ser aceptable y la cola no debe crecer de forma persistente; la velocidad bruta del enlace no basta para demostrar un rendimiento adecuado de los metadatos.
Un problema de Immich describe una incoherencia entre la base de datos y los archivos en una implementación con NFS inestable. El caso acotado de fallo de NFS respalda tratar las desconexiones durante las escrituras como un riesgo de recuperación, en lugar de suponer que NFS siempre corrompe Immich.
Durante una ventana de mantenimiento y con las copias de seguridad completas, interrumpe el recurso compartido de medios mientras hay una prueba no crítica en curso. Immich debe mostrar el fallo claramente en lugar de escribir en el punto de montaje vacío. Restablece el recurso compartido y confirma que el recurso de prueba y el registro de la base de datos se reconcilian sin que haya un bucle de reinicios.
Toma la decisión de continuar o no después de las pruebas de reinicio
Reinicia los contenedores y el host por separado. Confirma primero que se monta el recurso compartido correcto, que se pueden abrir los originales antiguos y nuevos, que los análisis externos no duplican los elementos y que una nueva carga persiste tras otro reinicio. La comparativa entre DAS y NAS de ZimaSpace explica la disyuntiva entre latencia y dominio de fallo.
Usa el recurso compartido si estas pruebas se superan y la monitorización puede alertar sobre su ausencia, latencia, espacio y presión de inodos. Elige almacenamiento local o conectado directamente cuando la red o el NAS no puedan ofrecer la disponibilidad requerida, o cuando no se pueda evitar el comportamiento de montaje de tipo fail-open.
Vuelve a la ruta local anterior si Immich se inicia vacío, crea archivos propiedad de root o muestra errores de archivos faltantes tras una interrupción. Para escalar el problema, indica el protocolo, las opciones de montaje, las identidades, las correspondencias de rutas, la latencia y el orden de arranque; nunca vuelvas a analizar de forma destructiva hasta conocer los originales autoritativos y el estado de la base de datos.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



