So stellen Sie eine Immich-Datenbank aus einer bekannten guten Sicherung wieder her

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.

Eine nachweislich funktionierende Immich-Datenbanksicherung ist nur dann nützlich, wenn Sie sie in einem kontrollierten Zustand wiederherstellen und nachweisen, dass die wiederhergestellte Datenbank weiterhin auf die Medien verweist, die Ihr Server tatsächlich sehen kann.

Betrachten Sie die Wiederherstellung als Abfolge von Schritten, nicht als einzelnen Importbefehl. Sichern Sie zuerst die ausgefallene Instanz, ermitteln Sie die Immich-Version und den Zeitstempel der Sicherung, starten Sie ein sauberes, kompatibles Datenbankziel, stellen Sie die Daten wieder her, ohne die Anwendung zuvor in ein leeres Schema schreiben zu lassen, und überprüfen Sie anschließend Konten, Zeitachsendaten, Medienpfade und einen neuen Schreibvorgang. Wenn ein Schritt unklar ist, halten Sie an, bevor Sie die letzte wiederherstellbare Kopie ersetzen.

Fehlerzustand sichern, bevor Sie etwas wiederherstellen

Stoppen Sie neue Uploads und Hintergrundschreibvorgänge auf der betroffenen Immich-Instanz, bevor Sie mit der Wiederherstellung beginnen. Sichern Sie die aktuelle Compose-Datei, die Umgebungsvariablen, die eingebundenen Pfade, die Image-Versionen, die aktuellen Protokolle und, sofern der Speicherplatz es zulässt, den beschädigten Datenbankzustand. Auch eine ausgefallene Datenbank kann noch Hinweise darauf enthalten, was passiert ist, und durch Überschreiben gehen diese verloren.

Legen Sie genau fest, welcher Sicherung Sie vertrauen wollen. Notieren Sie den Zeitstempel, die Art der Erstellung, die Dateigröße und ob sie jemals testweise wiederhergestellt wurde. Ein von der Datenbank erstellter SQL-Dump ist ein anderes Wiederherstellungsobjekt als eine Rohkopie des aktiven PostgreSQL-Datenverzeichnisses; behandeln Sie sie nicht als austauschbar.

Erstellen Sie das Wiederherstellungsziel möglichst in einem separaten Verzeichnis oder einem isolierten Stack. Die Abbruchbedingung für diese Phase ist einfach: Der ursprüngliche Fehlerzustand ist erhalten, die ausgewählte Sicherung ist schreibgeschützt und Sie wissen, mit welcher Bereitstellungsversion und welchen Speicherpfaden die Wiederherstellung verbunden werden soll.

Prüfen, ob sich die Sicherung tatsächlich wiederherstellen lässt

Prüfen Sie die Sicherung, bevor Sie sie einspielen. Ein komprimierter SQL-Dump sollte sich fehlerfrei entpacken lassen und erkennbare PostgreSQL-Dump-Inhalte enthalten, statt ein leeres Archiv zu sein, das durch eine fehlgeschlagene Pipeline erzeugt wurde. Wenn Sie Prüfsummen oder Ergebnisse einer Repository-Prüfung haben, vergleichen Sie diese jetzt, statt eine Beschädigung erst mitten in der Wiederherstellung festzustellen.

Ein PostgreSQL-Dump ist ein zuverlässigeres Wiederherstellungsmedium als eine beiläufige Kopie eines laufenden Datenbankverzeichnisses, da er mit datenbankbewussten Werkzeugen erstellt und in ein sauberes Zielsystem eingespielt werden kann. Das Backup-Verfahren mit Datenbank-Dump hält die Datenbank außerdem getrennt von der Medienkopie, sodass sich beide Teile vor der Wiederherstellung leichter überprüfen lassen.

Vergewissern Sie sich außerdem, dass die Medien und Konfigurationen aus dem Zeitraum des Backups noch vorhanden sind. Durch die alleinige Wiederherstellung der Datenbank lassen sich zwar Benutzer, Alben, Metadaten und Dateiverweise wiederherstellen, doch alle Assets bleiben unbrauchbar, wenn die referenzierten Bibliothekspfade fehlen. Fahren Sie nur fort, wenn Dump und Medien-/Konfigurationssatz zu einem bekannten Wiederherstellungspunkt gehören.

Starten Sie zuerst ein kompatibles, sauberes Datenbankziel

Stimmen Sie die Wiederherstellungsmethode auf die Version ab, mit der das Backup erstellt wurde. Aktuelle Immich-Versionen ermöglichen die Datenbankwiederherstellung über Administration > Wartung und über den Einrichtungsassistenten bei einer Neuinstallation. Für ältere Backups sind möglicherweise versionsspezifische manuelle Anweisungen erforderlich; der Wiederherstellungsablauf wurde in v2.5.0 geändert.

Lassen Sie bei einem neuen Wiederherstellungsziel Immich keine normalen Migrationen auf einem leeren Schema ausführen, bevor die Datenbankwiederherstellung bereit ist. Wenn Ihre Bereitstellungsmethode die Anwendung zusammen mit PostgreSQL startet, verwenden Sie die versionsgerechten Wiederherstellungsoptionen, damit der Server vor dem Import keinen konkurrierenden Zustand erzeugt.

Wenn sich die Datenbank nicht von selbst stabilisiert, halten Sie an und beheben Sie das Problem zuerst. Spielen Sie dasselbe Backup nicht wiederholt in ein Zielsystem ein, das neu startet, keinen Speicherplatz mehr hat oder ein inkompatibles Speicherlayout verwendet. Ein sauberes, stabiles Zielsystem ist Voraussetzung und keine nebensächliche Fehlersuche.

Dump einmal wiederherstellen und beim ersten Fehler abbrechen

Stellen Sie den ausgewählten Dump in der vorbereiteten Datenbank wieder her und erfassen Sie die vollständige Ausgabe. Verwenden Sie die zum Dump-Format passenden Datenbankwerkzeuge und Optionen, damit ein Fehler sichtbar zum Abbruch der Wiederherstellung führt, statt ein teilweise importiertes Schema zu hinterlassen, das trotzdem startet.

Für eine brauchbare Migration werden die Dateien, der PostgreSQL-Status und die Konfiguration benötigt, durch die sie wieder verbunden werden. Eine vollständige Immich-Sicherung umfasst hochgeladene Dateien, eine unterstützte Datenbanksicherung und die Bereitstellungskonfiguration. Wiederherstellungstests belegen, dass das Set funktioniert. Bewahren Sie diese Bestandteile zusammen auf, damit sich das Ziel einem einzigen Wiederherstellungspunkt zuordnen lässt.

Starten Sie nach einem erfolgreichen Import die Immich-Anwendung und beobachten Sie den ersten Start genau. Wenn die Benutzeroberfläche Sie auffordert, einen neuen ersten Administrator anzulegen, statt die bestehenden Konten zu akzeptieren, halten Sie an: Das deutet stark darauf hin, dass Immich nicht die wiederhergestellte Datenbank verwendet. Laden Sie nicht erneut Fotos in diesen leeren Zustand hoch.

Datenbankstatus, Medienpfade und einen neuen Schreibvorgang überprüfen

Melden Sie sich mit einem bestehenden Konto an und prüfen Sie die Zeitleiste anhand älterer und neuerer Daten. Öffnen Sie mehrere Originaldateien, prüfen Sie Alben oder Favoriten, von denen Sie wissen, dass sie existierten, und bestätigen Sie, dass die Anwendung die zugrunde liegenden Dateien aufrufen kann, statt nur Datenbankeinträge anzuzeigen.

Datenbankstatus, Anwendungsdateien, Konfiguration und Uploads müssen zum Zeitpunkt der Wiederherstellung zusammenpassen. Verwenden Sie eine konsistente Sicherung des Datenbank-Containers als Abnahmekriterium, nicht bloß die Frage, ob PostgreSQL startet.

Laden Sie schließlich ein einzelnes entbehrliches Foto hoch, warten Sie die reguläre Verarbeitung ab und prüfen Sie, ob es einen Neustart von Immich und einen Neustart des Hosts übersteht. Löschen Sie es anschließend über die Anwendung. Wenn Konten, alte Dateien und der neue Schreibvorgang erwartungsgemäß funktionieren, erstellen Sie eine aktuelle Sicherung des wiederhergestellten Zustands, bevor Sie ein Versionsupgrade durchführen. Andernfalls greifen Sie auf die gesicherten Fehlernachweise oder eine ältere, nachweislich funktionierende Sicherung zurück, statt den Schaden zu vergrößern.

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.