Cómo evitar que las copias de seguridad de Immich capturen un estado incoherente

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.

Evita las copias de seguridad incoherentes de Immich tratando la base de datos y los medios como una sola unidad de recuperación, con el orden de captura y la actividad de escritura controlados deliberadamente.

Una copia de seguridad puede contener todos los archivos cuya copia se solicitó y aun así restaurarse mal si la base de datos hace referencia a recursos que no se capturaron o si la copia de los medios corresponde a un momento distinto al del catálogo. Define primero el límite de coherencia, elige un método con la aplicación detenida o en vivo coordinado y valida el resultado de forma aislada.

Define la unidad de recuperación antes de programar la copia de seguridad

Enumera la base de datos PostgreSQL, los medios cargados, los datos del perfil, la configuración de implementación, los valores del entorno, los secretos y las rutas de almacenamiento personalizadas que se necesiten para recrear el servicio. Clasifica por separado las miniaturas generadas, los vídeos codificados y los archivos de modelos según si tu política de recuperación los protege o los regenera.

La comparación de ZimaSpace entre las copias de seguridad de Immich en vivo y con la aplicación detenida explica la decisión básica sobre la coherencia. Este procedimiento preventivo va un paso más allá: sea cual sea el método que elijas, debe generar un punto documentado que pueda restaurarse sin tener que adivinar qué base de datos corresponde a cada copia de los medios.

Anota el orden de restauración junto al alcance de la copia de seguridad. Si el plan dice «restaurar fotos» pero no especifica qué volcado de la base de datos, configuración, credenciales y asignaciones de almacenamiento vuelven a vincular esas fotos con los usuarios y álbumes, la definición de la copia de seguridad está incompleta antes de que empiece la primera ejecución programada.

Usa una captura con la aplicación detenida cuando sea aceptable el límite más sencillo

Para un hogar pequeño que pueda tolerar una breve ventana de mantenimiento, pausa las cargas y detén los servicios de la aplicación que escriben el estado de la biblioteca. Crea la copia de seguridad de la base de datos y captura los medios y la configuración; luego, reinicia los servicios solo cuando la instantánea o la copia tenga una marca de tiempo y un resultado de finalización claros.

Detener la aplicación no hace automáticamente que una ruta incorrecta sea válida. Verifica que la exportación de la base de datos se haya completado correctamente, que se hayan incluido las raíces de medios previstas y que el destino de la copia de seguridad sea independiente de los datos activos que debe recuperar. Registra las horas de inicio y finalización para que las restauraciones posteriores puedan identificar la generación exacta.

El método se considera válido cuando no se realizan escrituras en la aplicación durante la captura y una restauración de prueba devuelve los usuarios, la cantidad de recursos, los álbumes y las muestras de los archivos originales esperados. Si el tiempo de inactividad supera regularmente lo que el hogar puede tolerar, cambia a un método en vivo coordinado en lugar de reanudar las cargas a escondidas a mitad de una copia de archivos.

Para las copias de seguridad en vivo, captura la base de datos y los archivos en un orden conocido

Cuando Immich deba seguir disponible, crea un volcado coherente propio de la base de datos en lugar de copiar como archivos comunes el directorio de datos activo de PostgreSQL. Después, captura o toma una instantánea del árbol de medios siguiendo el orden documentado y registra las cargas que lleguen durante la ventana de copia de seguridad.

El flujo de trabajo práctico para hacer copias de seguridad de la base de datos de Immich demuestra el enfoque que tiene en cuenta la base de datos. Los comandos y los nombres de los contenedores pueden variar según la implementación; por eso, el principio que se debe aplicar es pedirle a PostgreSQL una copia de seguridad coherente, en vez de confiar en una copia recursiva de archivos de base de datos en uso.

Prefiere un orden que impida que la base de datos restaurada apunte a archivos multimedia que nunca se incluyeron en la copia de seguridad. Si la copia del sistema de archivos contiene archivos adicionales que la base de datos aún desconoce, es más seguro reconciliarlos que lidiar con registros de base de datos cuyos archivos originales referenciados no están presentes. Documenta las cargas que coincidan con ese intervalo.

Coordina las instantáneas del sistema de archivos con ganchos de base de datos, en lugar de dar por sentada la atomicidad

Las instantáneas del sistema de archivos son valiosas porque capturan un volumen rápidamente, pero por sí solas no hacen que dos sistemas que cambian de forma independiente sean transaccionalmente coherentes. Si la base de datos y los archivos multimedia residen en conjuntos de datos o dispositivos distintos, define ganchos previos y posteriores a la instantánea y registra claramente su momento de ejecución en el registro de copias de seguridad.

Un ejemplo de 2026 que combina software de copias de seguridad con ganchos para instantáneas de Btrfs muestra por qué la orquestación de instantáneas necesita límites explícitos para la aplicación o la base de datos. Usa la idea para coordinar las capturas, pero no copies sus comandos del sistema de archivos a ciegas en una configuración diferente.

Si la herramienta de instantáneas no puede coordinar el momento de la base de datos y los archivos multimedia, recurre a un volcado lógico de la base de datos más una copia de seguridad de los archivos multimedia, en lugar de afirmar que la recuperación es atómica. La complejidad solo se justifica si la prueba de restauración demuestra que la captura más rápida sigue devolviendo un estado coherente de la aplicación.

Incluye las pruebas de restauración en la programación de copias de seguridad

Que un trabajo de copia de seguridad finalice correctamente solo demuestra que la captura se completó. Selecciona periódicamente una generación reciente, restáurala con un nombre de host aislado, adjunta el almacenamiento previsto y verifica los usuarios, algunos archivos originales representativos, los álbumes, los permisos, el funcionamiento de las búsquedas y una copia nueva de la base de datos de la instancia restaurada.

La descripción general de la recuperación de PostgreSQL, basada en la planificación de copias de seguridad y restauración de PostgreSQL, hace hincapié en validar las restauraciones y definir objetivos de recuperación, en lugar de considerar que crear un volcado es el último paso. Aplica la misma disciplina a la unidad de recuperación conjunta de Immich.

Si faltan archivos aunque la restauración de la base de datos se complete correctamente, si se pueden abrir archivos multimedia sin que aparezcan los usuarios o las relaciones, o si la recuperación depende de un secreto almacenado únicamente en el host averiado, la política de copias de seguridad no es válida. Corrige el alcance, el orden, la retención o la independencia antes de aumentar la frecuencia de las copias; tener más copias incoherentes no crea un punto de recuperación fiable.

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.