Cómo recuperar una base de datos de Immich a partir de una copia de seguridad verificada

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.

Una copia de seguridad conocida y válida de la base de datos de Immich solo es útil si la restauras en un entorno controlado y compruebas que la base de datos recuperada sigue apuntando a los archivos multimedia que tu servidor puede ver.

Aborda la recuperación como una secuencia, no como un único comando de importación. Primero conserva la instancia fallida, identifica la versión de Immich y la fecha y hora de la copia de seguridad, inicia una base de datos de destino limpia y compatible, restáurala sin permitir que la aplicación escriba primero en un esquema vacío y, después, valida las cuentas, los datos de la cronología, las rutas de los archivos multimedia y una nueva escritura. Si algún paso no está claro, detente antes de reemplazar la última copia recuperable.

Conserva el estado fallido antes de restaurar nada

Antes de iniciar la recuperación, detén las nuevas cargas y las escrituras en segundo plano en la instancia de Immich afectada. Si el almacenamiento lo permite, guarda el archivo Compose actual, los valores del entorno, las rutas montadas, las versiones de las imágenes, los registros recientes y el estado dañado de la base de datos. Una base de datos fallida aún puede contener pistas que expliquen lo ocurrido, y sobrescribirla elimina esas pistas.

Identifica exactamente en qué copia de seguridad vas a confiar. Anota su fecha y hora, cómo se creó, el tamaño del archivo y si alguna vez se probó su restauración. Un volcado SQL generado por la base de datos es un recurso de recuperación distinto de una copia sin procesar del directorio de datos de PostgreSQL en funcionamiento; no los trates como si fueran intercambiables.

Siempre que sea posible, crea el destino de recuperación en un directorio independiente o en una pila aislada. La condición para dar por terminada esta etapa es sencilla: se conserva el estado original fallido, la copia de seguridad elegida es de solo lectura y sabes a qué versión de la implementación y rutas de almacenamiento debe volver a conectarse la restauración.

Comprueba que la copia de seguridad realmente se puede restaurar

Inspecciona la copia de seguridad antes de restaurarla. Un volcado SQL comprimido debe descomprimirse sin errores y contener contenido reconocible de un volcado de PostgreSQL, en lugar de ser un archivo vacío generado por una canalización fallida. Si tienes sumas de verificación o resultados de validación del repositorio, compáralos ahora, en vez de descubrir que hay daños a mitad de la recuperación.

Un volcado de PostgreSQL es un recurso de recuperación más seguro que una copia informal del directorio de una base de datos en funcionamiento, porque se crea con herramientas específicas para bases de datos y se puede restaurar en un destino limpio. El método de copia de seguridad mediante volcado de la base de datos también mantiene la base de datos separada de la copia de los archivos multimedia, lo que facilita validar cada parte antes de la recuperación.

Confirma también que los archivos multimedia y la configuración correspondientes al periodo de la copia de seguridad todavía existan. Restaurar solo la base de datos puede recuperar usuarios, álbumes, metadatos y referencias a archivos, pero dejar todos los recursos inaccesibles si faltan las rutas de la biblioteca a las que hacen referencia. Continúa solo si el volcado y el conjunto de archivos multimedia y configuración corresponden a un punto de recuperación conocido.

Inicia primero un destino de base de datos limpio y compatible

Adapta el método de restauración a la versión con la que se creó la copia de seguridad. Las versiones actuales de Immich permiten restaurar la base de datos desde Administración > Mantenimiento y mediante el flujo de configuración inicial de una instalación nueva, mientras que las copias de seguridad más antiguas pueden requerir instrucciones manuales específicas para cada versión; el flujo de restauración cambió en la versión v2.5.0.

Si el destino de recuperación es nuevo, no permitas que Immich ejecute migraciones normales en un esquema vacío antes de que la restauración de la base de datos esté lista. Si tu método de implementación inicia la aplicación junto con PostgreSQL, usa los controles de restauración adecuados para la versión para que el servidor no cree un estado en conflicto antes de la importación.

Si la base de datos no se estabiliza por sí sola, detente y resuelve eso primero. No sigas reproduciendo la misma copia de seguridad en un destino que se está reiniciando, se está quedando sin espacio en disco o usa un diseño de almacenamiento incompatible. Un destino limpio y estable es un requisito previo, no una tarea secundaria de resolución de problemas.

Restaura el volcado una vez y detente ante el primer error

Restaura el volcado elegido en la base de datos preparada y guarda la salida completa. Usa las herramientas de base de datos y las opciones adecuadas al formato del volcado para que un error haga que la restauración falle de forma visible, en lugar de dejar un esquema importado parcialmente que aun así se inicia.

Un conjunto de migración utilizable necesita los archivos multimedia, el estado de PostgreSQL y la configuración que los vuelve a conectar. Un conjunto completo de copia de seguridad de Immich incluye los archivos multimedia cargados, una copia de seguridad compatible de la base de datos y la configuración de implementación; las pruebas de restauración sirven para verificar que el conjunto funciona. Mantén esos elementos juntos para que el destino pueda corresponderse con un mismo punto de recuperación.

Después de una importación correcta, inicia la aplicación Immich y observa atentamente el primer arranque. Si la interfaz te pide crear un nuevo administrador inicial en lugar de aceptar las cuentas existentes, detente: eso indica claramente que la base de datos restaurada no es la que está usando Immich. No empieces a volver a cargar fotos en ese estado vacío.

Valida el estado de la base de datos, las rutas de los archivos multimedia y una nueva carga

Inicia sesión con una cuenta existente y revisa la cronología en distintas fechas, tanto antiguas como recientes. Abre varios originales, inspecciona álbumes o favoritos que sabes que existían y confirma que la aplicación puede acceder a los archivos subyacentes, en lugar de limitarse a mostrar filas de la base de datos.

El estado de la base de datos, los archivos de la aplicación, la configuración y las cargas deben coincidir al restaurar. Usa una copia de seguridad coherente del contenedor de la base de datos como criterio de aceptación, no te limites a comprobar si PostgreSQL se inicia.

Por último, sube una foto desechable, espera a que se procese con normalidad, comprueba que sigue ahí después de reiniciar Immich y reiniciar el host, y luego elimínala desde la aplicación. Si las cuentas, los archivos antiguos y la nueva carga funcionan con normalidad, crea una copia de seguridad nueva del estado recuperado antes de actualizar cualquier versión. Si no, vuelve a las pruebas del fallo que conservaste o a una copia de seguridad anterior que sepas que funciona, en lugar de agravar el daño.

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.