Welche Backup-Methode hält einen laufenden Datenbankcontainer auf einem Heim-NAS konsistent?

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.

Für die meisten Nutzer eines Home-NAS oder selbst gehosteten Servers ist ein natives logisches Datenbank-Backup die sicherste Standardeinstellung. Es wird erstellt, während die Datenbank läuft, und anschließend zusammen mit der Containerkonfiguration und den Anwendungsdateien regulär gesichert. Verwenden Sie eine kurzzeitige Kopie bei gestopptem Container, wenn eine Ausfallzeit akzeptabel ist, und einen koordinierten Dateisystem-Snapshot nur dann, wenn die Datenbank dafür geleert, gesperrt, mit einem Checkpoint versehen oder anderweitig vorbereitet wurde. Das bloße Kopieren eines Live-Datenbank-Volumes ist keine konsistente Backup-Methode.

„Konsistent“ als eine Wiederherstellung definieren, die von der Datenbank akzeptiert wird

Ein konsistentes Backup ist nicht einfach nur ein vollständiger Verzeichnisbaum. Nach der Wiederherstellung muss die Datenbank-Engine starten, Transaktionen korrekt wiederherstellen, Integritätsprüfungen bestehen und einen Zeitpunktzustand bereitstellen, den die Anwendung nutzen kann. Auf einem Home-Server mit Immich, Nextcloud, Paperless-ngx, Home Assistant oder einer anderen selbst gehosteten App müssen Datenbank, Uploads, Konfiguration und Geheimnisse zueinander passen.

Die Container-Persistenz erklärt nur, wo die Dateien gespeichert sind. Sie macht es nicht sicher, eine laufende Datenbank zu kopieren. In einer Datenbank können aktive Transaktionen, zwischengespeicherte Seiten, Write-Ahead-Logs, temporäre Dateien oder Metadaten vorhanden sein, die sich ändern, während die NAS-Backup-Software das Volume ausliest.

Methode 1: Einen nativen logischen Datenbank-Dump als Standard für das Home-NAS verwenden

Ein logischer Dump weist die Datenbank-Engine an, eine konsistente Darstellung von Schemas und Datensätzen zu exportieren. Für einen überschaubaren PostgreSQL- oder MariaDB-Container auf einem Familien-NAS ist dies in der Regel die einfachste Methode, um Backups zu planen, zu prüfen, extern zu speichern und in einem sauberen Ersatzcontainer wiederherzustellen. Ein aktueller Docker-Backup-Leitfaden zeigt dieses Muster, indem er native Datenbank-Dumps in einem geplanten Backup-Container ausführt.

Schreiben Sie den Dump in ein dediziertes Backup-Verzeichnis außerhalb des Live-Datenvolumes. Lassen Sie anschließend den NAS-Backup-Auftrag den Dump, die Compose-Datei, die Umgebungsvorlage, die Anwendungskonfiguration und die hochgeladenen Daten sichern. Legen Sie keine Produktionspasswörter im Dateinamen des Dumps oder in ungeschützten Protokollen offen.

Datenbank Standard für Home-Server Was der Backup-Auftrag sichern sollte
PostgreSQL Natives logisches Backup oder natives physisches Datenbank-Tool Dump, Rollen oder globale Einstellungen bei Bedarf, Compose, Umgebungsvariablen, Anwendungsdateien
MariaDB/MySQL Natives logisches Backup mit Optionen für konsistente Transaktionen SQL-Dump, Benutzer oder Berechtigungen bei Bedarf, Compose, Geheimnisse, Anwendungsdateien
SQLite Anwendungsbackup, SQLite-Online-Backup oder saubere Kopie bei gestoppter Anwendung Konsistente Datenbankkopie plus App-Konfiguration und Anhänge

Methode 2: Die Datenbank vor dem Kopieren ihres Volumes kurz anhalten

Eine Kopie bei gestopptem Container ist einfach und physisch vollständig. Stoppen Sie zuerst die schreibenden Anwendungen, fahren Sie die Datenbank ordnungsgemäß herunter, bestätigen Sie, dass der Prozess beendet wurde, kopieren Sie das gesamte persistente Volume oder das eingebundene Datenbankverzeichnis und starten Sie anschließend den Stack neu. Ein Docker- und MariaDB-Leitfaden beschreibt physische Volume-Kopien als schnell, aber versionsabhängig und üblicherweise mit Ausfallzeit verbunden.

Diese Methode eignet sich gut für ein kleines Heim-NAS, bei dem einige Minuten Wartungszeit akzeptabel sind und die Wiederherstellung mit einer kompatiblen Datenbankversion erfolgt. Sie ist weniger portabel als ein logischer Dump und kann die Ausfallzeit verlängern, wenn das Volume groß ist. Bewahren Sie den Datenbank-Image-Tag und das Speicherlayout zusammen mit dem Backup auf, damit Sie keine physischen Dateien in einer inkompatiblen Engine-Version wiederherstellen.

Methode 3: Einen schnellen Snapshot mit der Datenbank abstimmen

ZFS-, Btrfs-, LVM- und NAS-Snapshot-Systeme können ein großes Datenbank-Volume schnell erfassen, doch der Snapshot muss mit der Datenbank abgestimmt werden. Bei MariaDB oder MySQL kann das ein kurzes Sperr- oder Flush-Fenster bedeuten; bei PostgreSQL möglicherweise den unterstützten Backup- oder Checkpoint-Prozess der Datenbank; bei einer von der Anwendung verwalteten Datenbank möglicherweise einen Pre-Snapshot-Hook.

Eine Diskussion über Datenbank-Snapshots erklärt, dass eine Live-Kopie auf der Festplatte intern inkonsistent sein kann, wenn die Datenbank nicht angehalten oder der Snapshot nicht atomar erstellt wird. Die Sperr- oder Ruhephase sollte kurz sein: Datenbank vorbereiten, Snapshot erstellen, Schreibvorgänge wieder freigeben und den Snapshot später kopieren.

Diese Methode ist nützlich, wenn die Datenbank zu groß für häufige logische Dumps ist oder Sie ein kürzeres Wiederherstellungsintervall benötigen. Sie erfordert sorgfältigere Skripte und Wiederherstellungstests als ein einfaches Dump-Verfahren für einen Heimserver.

Docker-Image oder Container-Export nicht als Datenbank-Backup behandeln

Das Container-Image enthält die Laufzeitumgebung der Anwendung, nicht unbedingt die aktuellen persistenten Daten. Beim Exportieren oder Committen des Containers können benannte Volumes ausgelassen werden, und die Datenbank wird nicht aufgefordert, einen konsistenten Wiederherstellungspunkt zu erstellen. Ein Bericht zu PostgreSQL-Container-Backups kommt zu dem Schluss, dass Docker save und commit keine PostgreSQL-spezifischen Backup-Techniken ersetzen.

Trennen Sie bei einem ZimaOS- oder Docker-Heimserver die Bereitstellungsdefinition vom Datenschutzplan: Bewahren Sie Compose-Dateien und Image-Tags auf, damit der Dienst neu erstellt werden kann, und sichern Sie die Datenbank mit einer datenbankkonsistenten Methode, damit sich ihr Zustand wiederherstellen lässt.

Kopieren Sie niemals einfach ein Volume mit aktiven Schreibvorgängen

NAS-Sicherungssoftware liest möglicherweise verschiedene Datenbankdateien zu unterschiedlichen Zeitpunkten. Das resultierende Archiv kann eine Datendatei aus einem Transaktionszustand, ein Protokoll aus einem anderen und Metadaten aus einem dritten enthalten. Eine Übersicht über Open-Source-Sicherungsmethoden für SQL warnt davor, dass eine laufende Datenbank zu einem inkonsistenten Zeitpunkt erfasst werden kann, während wichtige Zustände noch im Arbeitsspeicher liegen.

Die Crash-Wiederherstellung kann einige atomar erstellte Snapshots reparieren, aber eine gewöhnliche rekursive Dateikopie ist nicht atomar. Wenn die App keine Ausfallzeit toleriert, verwenden Sie stattdessen einen logischen Dump, ein unterstütztes physisches Sicherungstool oder einen koordinierten Snapshot.

Behandeln Sie SQLite-Container wie Datenbanken, nicht wie gewöhnliche Dateien

Viele Heimserver-Apps verwenden SQLite, weil es kompakt und einfach bereitzustellen ist. Das Risiko besteht darin, dass Administratoren eine einzelne .db-Datei sehen und annehmen, sie könne kopiert werden, während die App Schreibvorgänge ausführt. Im WAL-Modus können kürzlich bestätigte Änderungen noch außerhalb der Hauptdatei liegen. Ein praktischer Artikel zur Wiederherstellung von SQLite empfiehlt, den Online-Sicherungsmechanismus oder eine saubere Kopie bei geschlossener Datenbank zu verwenden, statt eine aktive Datenbankdatei zu kopieren.

Verwenden Sie die integrierte Sicherungsfunktion der Anwendung, sofern vorhanden. Andernfalls nutzen Sie die Online-Sicherungsfunktion von SQLite oder stoppen Sie die Anwendung ordnungsgemäß, bevor Sie das gesamte Datenbankverzeichnis kopieren. Kopieren Sie nicht nur die Hauptdatenbankdatei und lassen Sie dabei das Journal oder den WAL-Status zurück.

Wählen Sie die Methode nach Ausfallzeit, Datenbankgröße und Portabilität der Wiederherstellung

Voraussetzung für das Heim-NAS Beste Methode für den Einstieg Wichtigster Kompromiss
Kleine Datenbank, tägliche Sicherung, einfache Migration Logischer Dump Längere Dump-Dauer, wenn die Datenbank wächst
Kleine Datenbank, Wartungsfenster verfügbar Sauberes Herunterfahren und physische Kopie des Volumes Erfordert Ausfallzeit und Versionskompatibilität
Große Datenbank, kurzes Sicherungsfenster Datenbankkoordinierter Snapshot oder natives physisches Backup Komplexere Hooks, Aufbewahrungsregeln und Wiederherstellungstests
SQLite-App mit integriertem Export Anwendungsexport oder Online-Sicherung von SQLite Möglicherweise ist eine app-spezifische Automatisierung nötig
Medien- oder Dokumenten-App mit Datenbank und Uploads Datenbankkonsistente Sicherung plus synchronisierte Dateisicherung Datenbank- und Datei-Zeitstempel müssen zum selben Wiederherstellungszeitraum gehören

Sichern Sie die gesamte selbst gehostete Anwendung, nicht nur die Datenbank

Ein brauchbares Wiederherstellungspaket sollte die Datenbanksicherung, die Docker-Compose-Datei, Image-Versionen, Umgebungsvariablen oder ein wiederherstellbares Geheimnispaket, Reverse-Proxy-Einstellungen, die Anwendungskonfiguration, hochgeladene Dateien und alle Verschlüsselungsschlüssel enthalten. Wenn du nur den SQL-Dump sicherst, lassen sich zwar die Datensätze wiederherstellen, aber die App kann möglicherweise Fotos, Dokumente, Miniaturansichten, Zertifikate oder Speicherpfade nicht finden.

Für die Wiederherstellungsplanung eines Home-Servers erklärt der ZimaSpace-Leitfaden zu Bind-Mounts und benannten Volumes, warum sichtbare Speicherpfade die Wiederherstellung erleichtern, aber dennoch keine anwendungskonsistente Datenbanksicherung ersetzen.

Belege die Methode durch eine Wiederherstellung in einem neuen Container

Erstelle einen isolierten Test-Stack mit einem neuen Projektnamen, anderen Host-Ports und einem temporären Datenverzeichnis. Stelle den Dump oder Snapshot wieder her, starte die Datenbank, führe ihre Integritäts- oder Konsistenzprüfungen aus und verbinde anschließend eine Testkopie der Anwendung. Vergewissere dich, dass Benutzer, Datensätze, Anhänge und aktuelle Transaktionen vorhanden sind.

Miss sowohl den Wiederherstellungspunkt als auch die Wiederherstellungszeit. Wenn ein logischer Dump konsistent ist, die Wiederherstellung aber zu lange dauert, behalte ihn als portable Wiederherstellungsebene bei und ergänze ihn um einen schnelleren, koordinierten Snapshot. Lässt sich eine Kopie des gestoppten Volumes zwar schnell wiederherstellen, funktioniert sie aber nur mit derselben Datenbankversion, solltest du für den Fall einer Migration zusätzlich einen logischen Dump aufbewahren.

FAQ

Reicht es, einen Datenbank-Container anzuhalten, bevor das Volume kopiert wird?

Nicht grundsätzlich. Eine Pause hält den Prozess an, beweist aber nicht, dass die Datenbank den korrekten Zustand für eine portable Sicherung auf die Festplatte geschrieben hat. Verwende einen datenbankspezifischen Dump, ein ordnungsgemäßes Herunterfahren oder ein dokumentiertes Verfahren zum Anhalten und Erstellen eines Snapshots.

Reicht ein NAS-Snapshot allein für PostgreSQL oder MariaDB aus?

Nur wenn der Snapshot atomar ist und mit dem unterstützten Konsistenzverfahren der Datenbank koordiniert wird. Ein unkoordinierter Snapshot ist möglicherweise nur absturzkonsistent, und eine nichtatomare Dateikopie kann noch schlechter sein.

Was sollte ich für eine SQLite-basierte Home-Server-App sichern?

Verwende den Export der App oder die Online-Sicherung von SQLite, sofern verfügbar. Sichere außerdem die App-Konfiguration, die Compose-Datei, Geheimnisse, Anhänge und das Verzeichnis, in dem sich die Datenbank befindet. Gehe nicht davon aus, dass die Datei .db allein die gesamte Anwendung ausmacht.

Abschließende Empfehlung

Verwende geplante logische Dumps standardmäßig für die meisten PostgreSQL- und MariaDB-Container auf einem Home-NAS. Erstelle eine saubere Kopie des gestoppten Volumes, wenn eine kurze Ausfallzeit akzeptabel ist, und verwende koordinierte Snapshots oder datenbankspezifische physische Sicherungstools, wenn die Datenbank groß ist oder das Wiederherstellungsfenster eng bemessen ist. Unabhängig von der gewählten Methode solltest du die Sicherung erst dann als verlässlich ansehen, wenn du sie in einem neuen Container wiederhergestellt hast.

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.