So verhinderst du, dass Immich-Backups einen inkonsistenten Zustand erfassen

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Verhindern Sie inkonsistente Immich-Backups, indem Sie Datenbank und Medien als eine Wiederherstellungseinheit behandeln, deren Erfassungsreihenfolge und Schreibaktivität bewusst gesteuert werden.

Ein Backup kann jede angeforderte Datei enthalten und trotzdem schlecht wiederherstellbar sein, wenn die Datenbank auf Assets verweist, die nicht erfasst wurden, oder die Medienkopie einen anderen Zeitpunkt abbildet als der Katalog. Legen Sie zuerst die Konsistenzgrenze fest, wählen Sie eine gestoppte oder koordinierte Live-Methode und überprüfen Sie das Ergebnis in einer isolierten Umgebung.

Vor der Planung des Backups die Wiederherstellungseinheit festlegen

Führen Sie die PostgreSQL-Datenbank, hochgeladene Medien, Profildaten, die Bereitstellungskonfiguration, Umgebungswerte, Geheimnisse und alle benutzerdefinierten Speicherpfade auf, die zum Wiederherstellen des Dienstes erforderlich sind. Führen Sie generierte Miniaturansichten, kodierte Videos und Modelldateien separat auf und kennzeichnen Sie sie entsprechend Ihrer Wiederherstellungsrichtlinie als zu schützende oder neu zu generierende Daten.

Der Vergleich von ZimaSpace zu Live- und gestoppten Immich-Backups erläutert die grundlegende Entscheidung zur Konsistenz. Dieser Präventionsablauf geht noch einen Schritt weiter: Unabhängig von der gewählten Methode muss ein dokumentierter Wiederherstellungspunkt entstehen, bei dem nicht geraten werden muss, welche Datenbank zu welcher Medienkopie gehört.

Dokumentieren Sie die Wiederherstellungsreihenfolge zusammen mit dem Backup-Umfang. Wenn der Plan „Fotos wiederherstellen“ lautet, aber nicht angibt, welcher Datenbank-Dump, welche Konfiguration, Anmeldedaten und Speichereinbindungen die Fotos wieder mit Benutzern und Alben verknüpfen, ist die Backup-Definition bereits vor dem ersten planmäßigen Lauf unvollständig.

Eine gestoppte Sicherung verwenden, wenn die einfachste Abgrenzung genügt

Für einen kleinen Haushalt, der ein kurzes Wartungsfenster tolerieren kann, pausieren Sie Uploads und stoppen Sie die Anwendungsdienste, die den Bibliotheksstatus ändern. Erstellen Sie das Datenbank-Backup und sichern Sie Medien und Konfiguration. Starten Sie die Dienste erst dann wieder, wenn der Snapshot oder die Kopie einen eindeutigen Zeitstempel und ein bestätigtes Ergebnis aufweist.

Eine gestoppte Anwendung macht einen falschen Pfad nicht automatisch richtig. Prüfen Sie, ob der Datenbankexport erfolgreich war, ob die vorgesehenen Medienverzeichnisse enthalten sind und ob das Backup-Ziel unabhängig von den Live-Daten ist, die damit wiederhergestellt werden sollen. Notieren Sie Start- und Endzeit, damit spätere Wiederherstellungen die genaue Generation identifizieren können.

Die Methode ist erfolgreich, wenn während der Erfassung keine Schreibvorgänge der Anwendung stattfinden und eine Testwiederherstellung die erwarteten Benutzer, Asset-Anzahlen, Alben und stichprobenartig geprüften Originale liefert. Wenn die Ausfallzeit regelmäßig die für den Haushalt tolerierbare Dauer überschreitet, wechseln Sie zu einer koordinierten Live-Methode, statt Uploads unbemerkt mitten im Kopiervorgang wieder zuzulassen.

Bei Live-Backups Datenbank und Dateien in einer festgelegten Reihenfolge erfassen

Wenn Immich verfügbar bleiben muss, erstellen Sie einen konsistenten, datenbankeigenen Dump, statt das aktive PostgreSQL-Datenverzeichnis als gewöhnliche Dateien zu kopieren. Sichern oder erstellen Sie anschließend einen Snapshot des Medienverzeichnisses in der dokumentierten Reihenfolge und erfassen Sie dabei Uploads, die während des Backup-Zeitfensters eingehen.

Der praxisorientierte Immich-Ablauf für Datenbank-Backups veranschaulicht den datenbankbewussten Ansatz. Befehle und Containernamen können je nach Bereitstellung variieren. Das übertragbare Prinzip ist, PostgreSQL um ein konsistentes Backup zu bitten, statt einer laufenden rekursiven Kopie von Datenbankdateien zu vertrauen.

Wähle eine Reihenfolge, bei der die wiederhergestellte Datenbank nicht auf Medien verweist, die nie ins Backup aufgenommen wurden. Wenn die Dateisystemkopie zusätzliche Dateien enthält, die der Datenbank noch nicht bekannt sind, lassen sich diese sicherer abgleichen als Datenbankeinträge, deren referenzierte Originaldateien fehlen. Dokumentiere Uploads, die während des Übergangs stattfinden.

Dateisystem-Snapshots mit Datenbank-Hooks koordinieren, statt Atomarität vorauszusetzen

Dateisystem-Snapshots sind wertvoll, weil sie ein Volume schnell erfassen, aber sie sorgen nicht von selbst für transaktionale Konsistenz zwischen zwei unabhängig veränderlichen Systemen. Wenn Datenbank und Medien auf verschiedenen Datasets oder Geräten liegen, definiere Hooks vor und nach dem Snapshot und halte deren Zeitpunkte im Backup-Protokoll fest.

Ein Beispiel aus dem Jahr 2026, das Backup-Software mit Btrfs-Snapshot-Hooks kombiniert, zeigt, warum die Snapshot-Orchestrierung klare Anwendungs- oder Datenbankgrenzen braucht. Nutze die Idee, um Sicherungen zu koordinieren; übernimm die Dateisystembefehle nicht blind für ein anderes Layout.

Wenn das Snapshot-Tool den zeitlichen Übergang zwischen Datenbank und Medien nicht koordinieren kann, greife auf einen logischen Datenbank-Dump plus Medien-Backup zurück, statt eine atomare Wiederherstellung zu behaupten. Die zusätzliche Komplexität ist nur dann gerechtfertigt, wenn der Wiederherstellungstest belegt, dass die schnellere Sicherung weiterhin einen konsistenten Anwendungszustand liefert.

Wiederherstellungstests in den Backup-Zeitplan aufnehmen

Ein erfolgreicher Backup-Job belegt lediglich, dass die Sicherung abgeschlossen wurde. Wähle regelmäßig eine aktuelle Sicherungsgeneration aus, stelle sie unter einem isolierten Hostnamen wieder her, binde den erwarteten Speicher ein und überprüfe Nutzer, repräsentative Originaldateien, Alben, Berechtigungen, das Suchverhalten und ein aktuelles Datenbank-Backup der wiederhergestellten Instanz.

Der PostgreSQL-Leitfaden zur Wiederherstellung aus der PostgreSQL-Backup- und Wiederherstellungsplanung betont die Prüfung der Wiederherstellung und der Wiederherstellungsziele, statt die Erstellung eines Dumps als Abschluss zu betrachten. Wende dieselbe Sorgfalt auf die kombinierte Immich-Wiederherstellungseinheit an.

Die Backup-Richtlinie ist nicht erfüllt, wenn die Datenbankwiederherstellung gelingt, aber Dateien fehlen, wenn Medien ohne Nutzer oder Beziehungen geöffnet werden oder wenn die Wiederherstellung von einem Geheimnis abhängt, das nur auf dem ausgefallenen Host gespeichert ist. Passe Umfang, Reihenfolge, Aufbewahrung oder Unabhängigkeit an, bevor du die Backup-Häufigkeit erhöhst; mehr inkonsistente Kopien ergeben keinen zuverlässigen Wiederherstellungspunkt.

Support und Tipps

Mehr zum Lesen

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.