Backup 1.6
Prüft die Voraussetzungen, verweigert laufende QEMU-/LXC-Gäste, stoppt pve-cluster kontrolliert, sichert config.db im ruhenden Zustand, startet den Dienst erneut und verifiziert Archive, Datenbank und Prüfsummen.
Retrowork / Open SourceProxmox VE / Host-Recovery
Zwei selbst entwickelte Bash-Werkzeuge für die Sicherung und gezielte Wiederherstellung von Proxmox-Hostkonfigurationen auf einem Standalone-Host: Backup 1.6 und Restore 1.14. Keine VM-Festplattensicherung und keine allgemeine Cluster-Recovery.
Entstanden sind sie aus einer einfachen Frage: Wie bekomme ich nach einer fehlerhaften Änderung möglichst nur den betroffenen Konfigurationsbereich wieder zurück?
KEINE VM-FESTPLATTEN · KEINE CLUSTER-BACKUPS
01 / DIE WERKZEUGE
Proxmox Config Backup & Restore besteht aus zwei von mir entwickelten Bash-Werkzeugen für die Konfiguration eines eigenständigen Proxmox-VE-Hosts. Sie helfen dabei, einen überprüften Sicherungsstand anzulegen und bei unterstützten Fehlerfällen gezielt Teile dieser Konfiguration wiederherzustellen.
Backup 1.6 prüft die Host-Voraussetzungen und sichert unter kontrollierten Bedingungen unter anderem die Proxmox-Konfigurationsdatenbank config.db sowie weitere Host-Konfigurationsdateien. Für die Sicherung dürfen keine QEMU-VMs oder LXC-Container laufen; pve-cluster wird vorübergehend gestoppt. Archiv, Datenbank und Prüfsummen werden kontrolliert.
Restore 1.14 prüft einen vorhandenen Sicherungssatz und bietet Wiederherstellungswege für unterstützte Bereiche wie SSH, Netzwerk, Firewall, Storage, Berechtigungen und einzelne VM-Konfigurationen. Eine vollständige Datenbankrückspielung ist ausdrücklich eine weitreichende Notfalloption.
Die Grenzen sind wichtig: Diese Werkzeuge sichern keine VM-Festplatten, keine LXC-Dateisysteme und keine Gastdaten. Sie sind keine allgemeine Cluster-Recovery und ersetzen weder Proxmox Backup Server noch unabhängige Datenträger-Backups. Eingriffe in Netzwerk und Dienste können den Fernzugriff unterbrechen; Wartungsplanung und Konsolenzugang bleiben wichtig.
02 / AUSGANGSPUNKT
Wer einen eigenen Server betreibt, kennt die Situation.
Man verändert eine Konfiguration, passt eine Einstellung an oder probiert etwas Neues aus. Meistens funktioniert alles.
Aber was passiert, wenn eine Änderung schiefgeht?
Wenn SSH nicht mehr erreichbar ist? Wenn die Netzwerkkonfiguration nicht stimmt? Oder eine Firewallregel plötzlich den Zugang blockiert?
Genau für solche Fälle wollte ich eine Rückfallebene schaffen.
Nicht für den vollständigen Hardwareausfall. Nicht als Ersatz für VM-Backups. Sondern für die Konfiguration meines eigenen Proxmox-Hosts.
Daraus sind zwei Bash-Werkzeuge entstanden: pve-config-backup sichert einen geprüften Zustand. pve-config-restore kann unterstützte Bereiche gezielt zurückholen.
„Nicht alles zurücksetzen. Sondern möglichst nur das, was tatsächlich beschädigt ist.“
Stell dir vor: Am Montag erstelle ich ein Backup. Am Dienstag richte ich eine neue VM ein. Am Mittwoch passe ich eine Speicherkonfiguration an. Und am Donnerstag beschädige ich versehentlich SSH.
Wenn ich jetzt die vollständige Proxmox-Datenbank vom Montag zurückspiele, kann ich auch spätere Konfigurationsänderungen verlieren – obwohl nur SSH repariert werden sollte.
Deshalb entstand die Idee des selektiven Restore.
Defektes Netzwerk? Dann möglichst nur das Netzwerk zurück.
Eine beschädigte storage.cfg? Dann nur diese Konfiguration.
Die ganze Datenbank ersetzen? Erst als Notfallmaßnahme.
Doch aus „Datei sichern und bei Bedarf kopieren“ wurde mit der Zeit eine andere Frage: Woher weiß das Skript eigentlich, ob eine Änderung sicher ist?
Was passiert bei einem SSH-Abbruch, bei konkurrierenden Proxmox-Prozessen oder wenn ein Dienst zwar einen Erfolg meldet, der Server danach aber nicht mehr erreichbar ist?
Diese Fragen haben den weiteren Entwicklungsweg entscheidend geprägt.
03 / ARCHITEKTUR
Proxmox verwaltet einen wichtigen Teil seiner Konfiguration unter /etc/pve. Dahinter arbeitet pmxcfs mit einer persistenten SQLite-Datenbank: config.db.
Diese Dateien sind nicht einfach ein gewöhnlicher Ordner, den man jederzeit bedenkenlos kopieren oder überschreiben kann. Die Werkzeuge berücksichtigen deshalb den Zustand des laufenden Systems.
Prüft die Voraussetzungen, verweigert laufende QEMU-/LXC-Gäste, stoppt pve-cluster kontrolliert, sichert config.db im ruhenden Zustand, startet den Dienst erneut und verifiziert Archive, Datenbank und Prüfsummen.
Überprüft den gewählten Sicherungssatz und bietet gezielte Wiederherstellung für SSH, Netzwerk, Firewall, Storage, Proxmox-Berechtigungen und eine QEMU-VM-Konfiguration. Ein vollständiges config.db-Restore ist ausschließlich die weitreichende Notfalloption.
Je nach Bereich: bisherige Zustände erfassen, Kandidaten validieren, native Sperren beachten, Änderungen kontrollieren und bedingt zurückrollen. Ein fremder oder uneindeutiger Zustand darf nicht einfach überschrieben werden.
Keine VM-Festplatten, keine LXC-Dateisysteme, keine allgemeine Cluster-Recovery und keine automatisch verschlüsselten Off-Host-Backups. Recovery kann SSH, Firewall oder Netzwerk unterbrechen. Ein Konsolen-/IPMI-Zugang ist wichtig.
backup-info.txt, config.db, etc-pve.tar.gz, etc-host.tar.gz, system-state.txt und weitere Dateien bilden gemeinsam einen Sicherungssatz. VERIFIED zeigt bestandene Skriptprüfungen an – keine digitale Signatur oder Garantie für jede Wiederherstellung.
04 / ENTSTEHUNG
Viele der späteren Schutzmechanismen standen nicht von Anfang an fest. Sie entstanden, weil während der Prüfung immer wieder neue Randfälle sichtbar wurden.
Eine Lösung wirkte zunächst plausibel. Dann zeigte ein Test oder eine genauere Analyse, dass noch etwas fehlte. Also wurde nachgebessert – und erneut geprüft.
Die ältesten dokumentierten Ausgangspunkte sind Backup 1.3 und Restore 1.4. Erst stand die praktische Rückfallebene für meinen eigenen Host im Mittelpunkt.
Der frühere SQLite-Online-Ansatz wich einem kontrollierten pmxcfs-Stillstand. Zusätzliche Zustandsvergleiche sollten verhindern, dass eine unpassende Datenbankkopie als fertiges Backup gilt.
Bei ifupdown2 zeigten sich Probleme mit bridge-fd 0 und Bridge-MTUs. Statt Warnungen pauschal zu ignorieren, wurden eng begrenzte Prüfungen an einer privaten Kopie entwickelt. Der eigentliche Restore-Kandidat bleibt unverändert.
Eine erfolgreich angewendete Netzwerkkonfiguration kann den Managementzugang trotzdem unterbrechen. Deshalb erhielt der unterstützte Live-Netzwerkpfad zusätzliche Erreichbarkeits- und Zustandsprüfungen mit bedingtem Rollback.
Storage, VM-Konfiguration, PVE-Benutzer und SSH wurden schrittweise transaktional gehärtet: mit stabilen Zustandsaufnahmen, Sperren, Ownership-Kontrollen und einer klaren Behandlung von fremden oder mehrdeutigen Zuständen.
Backup 1.6 und Restore 1.14 wurden als unveränderte Skriptstände öffentlich bereitgestellt – mit englischer Dokumentation und der erhaltenen Entwicklungshistorie. Nicht als neuer Code-Release, sondern als nachvollziehbarer Stand der bisherigen Arbeit.
Das auffälligste Ergebnis dieser Entwicklung ist für mich nicht eine einzelne neue Funktion.
Es ist der Grundsatz, bei Unsicherheit lieber kontrolliert anzuhalten, als einen fremden Zustand blind zu überschreiben.
05 / PROJEKTSTAND & HISTORIE
Ich unterscheide zwischen dem bereits veröffentlichten Stand, begonnener Weiterentwicklung und zukünftigen Zielen. Nicht alles, was untersucht wurde, ist automatisch Bestandteil einer veröffentlichten Version.
config.dbbundle-2026.10Die beiden folgenden Changelogs zeigen die wichtigsten Entwicklungsschritte. Historische DRAFT- und ENTWURF-Kennzeichnungen sind erhaltene Quellcode-Bezeichnungen, keine Behauptung, dass jede Zwischenrevision separat veröffentlicht wurde. Die vollständigen Einträge stehen auf GitHub.
CHANGELOG / BACKUP
R1–R2 · 07.10.2026 – pve-cluster wird zunächst unter seiner normalen systemd-Unit gestoppt. Erst nach geprüftem Stillstand folgt eine temporäre Maskierung mit einer erneuten Kontrolle. Result=success, fehlender Mount und kein aktiver pmxcfs-Prozess gehören zur Prüfung. Ein Timeout oder SIGKILL darf kein Sicherungsfenster freigeben.
R1–R8 · 04.10.2026 – Weg vom Online-SQLite-Backup der laufenden Datenbank. Stattdessen: kontrollierter pmxcfs-Stillstand, PRE-/POST-Vergleich, begrenzte Wiederholungen, Fail-closed-Prüfungen und zusätzliche Vergleiche zwischen statischem /etc/pve und persistentem Datenbankzustand. Weitere Revisionen behandelten Konkurrenzfälle, Dienstzustände und die Sicherheit der Wiederherstellung nach Fehlern.
25.09.2026 – Signalbehandlung, Cleanup, SQLite-Busy-Timeout, begrenzte Tar-Wiederholungen, Diagnose-Timeouts, sync vor Abschluss, Aufbewahrungsregeln und das Mitsichern des Restore-Werkzeugs, wenn vorhanden. Historisch wurde hier noch SQLite-Online-Backup verwendet.
Der veröffentlichte Skript-Header enthält keine ältere Backup-Entwicklungshistorie. Frühere Änderungen lassen sich deshalb aus diesem Changelog nicht zuverlässig rekonstruieren.
Vollständige Backup-Historie mit allen 12 Revisionseinträgen lesen ↗
CHANGELOG / RESTORE
R1–R6 · 08.10.2026 – sshd_config und sshd_config.d werden unter strengen Eigentums-, Include-, Zustands- und Bereinigungsbedingungen behandelt. Keine blinden Rollbacks bei fremden Zuständen. Ein angeforderter Reload wird nicht automatisch mit einem nachgewiesen abgeschlossenen Reload gleichgesetzt.
07.–08.10.2026 – Transaktion für user.cfg und priv/shadow.cfg mit nativen Sperren, definierten Zwischenzuständen und strikter Prüfung. Nicht unterstützte Token-, TFA- und Authentifizierungskonstellationen werden zurückgewiesen. R2 korrigierte einen Randfall bei ungewisser Bereinigung einer temporären Datei.
07.10.2026 – Native Proxmox-VM-Sperren, striktes Einlesen des Zielzustands, FUSE-Mount-Kontrollen, Prüfung konkurrierender Änderungen und definierte Commit-/Rollback-Schritte. Wiederhergestellt wird eine QEMU-Konfiguration, keine Festplatte.
06.10.2026 – Native Storage-Locks, Vergleich von vorherigem und Zielzustand, Mount-Pinning, gezielte Behandlung von Schreibkonflikten, temporären Dateien und kritischem Cleanup. Ein unklarer Zustand darf nicht als erfolgreiche Wiederherstellung gelten.
03.10.2026 – Ergänzung einer begrenzten Management-Netzwerkprüfung. Je nach unterstütztem Profil werden Interface, Carrier, IP-Adresse, Route, MTU und Gateway geprüft. Scheitert die Prüfung nach einem vorläufigen Live-Apply, wird ein bedingter Rollback versucht.
01.10.2026 – Zwei Prüfphasen für bestimmte Bridge-/SDN-MTU-Warnungen, ohne echte VLAN- oder Parent-MTU-Fehler pauschal zu ignorieren. Dazu strengere Behandlung von SSH-Schreibfehlern und Rollback. Die echte Netzwerk-Konfigurationsdatei bleibt unverändert.
30.09.2026 – Eng eingegrenzter Workaround für ein ifupdown2-Syntaxproblem mit bridge-fd 0. Geprüft wird eine eingefrorene, private Kandidatenkopie. Hinzu kamen Sperren, Fehlerbehandlung und Schutz gegen konkurrierende Änderungen.
26.09.2026 – Über zwanzig dokumentierte Prüf- und Korrekturpunkte: unter anderem Dienstzustände, Laufzeitfehler, Signalbehandlung, VM-Sperren, Recovery, Proxmox-Konfigurationsdateien, Logausgaben und zuverlässigeres Fehlverhalten.
26.09.2026 – Datenbankprüfung in einer privaten Kopie, explizite Tar-Fehlerbehandlung und strengere Kontrollen von SQLite-Journal-/WAL-/SHM-Dateien vor der vollständigen Datenbankwiederherstellung.
25.09.2026 – Schutz des gewählten Backups, Fehlerbehandlung bei Prüfungen, Signalen und SSH-Abbrüchen, Sicherungen vor einem Restore und strengere Stop-/Recovery-Bedingungen für pmxcfs.
Die erhaltene Quellcodehistorie nennt diesen Stand als Ausgangspunkt. Die frühere Entwicklung ist dort nicht dokumentiert.
Vollständige Restore-Historie mit allen 22 Revisionseinträgen lesen ↗
06 / VERÖFFENTLICHUNG
Das Projekt begann als Werkzeug für meinen eigenen Server. Über viele Änderungen hinweg habe ich mich mit Bash, Linux, Proxmox, SQLite, systemd, Netzwerk-Recovery, Sperren, Race Conditions und kontrolliertem Rollback beschäftigt.
Ich wollte diese Arbeit schließlich öffentlich nachvollziehbar machen – nicht einfach behaupten, dass ich mich mit den Themen beschäftigt habe, sondern ein konkretes Projekt zeigen.
Die GitHub-Veröffentlichung enthält die beiden unveränderten Skriptstände, englische technische Dokumentation und die historischen Änderungsbeschreibungen. Auch alte DRAFT-Vermerke blieben erhalten.
Wer wissen möchte, warum eine Entscheidung getroffen wurde, soll das anhand der Quellen nachvollziehen können. Die Veröffentlichung ist unabhängig und nicht offiziell mit Proxmox Server Solutions GmbH verbunden.
Backup 1.6 / Restore 1.14
Veröffentlicht am 10.10.2026 · MIT-Lizenz · Dokumentation auf Englisch.
07 / FAQ
Nein. Das Projekt konzentriert sich auf die Host- und Proxmox-Konfiguration. VM-Festplatten, LXC-Dateisysteme und Gastdaten werden nicht gesichert.
Nein. Backup 1.6 verweigert aktive QEMU-VMs oder LXC-Container. Es stoppt den Dienst pve-cluster vorübergehend; deshalb sind Wartungsplanung und Konsolenzugang wichtig.
Ja, sofern die jeweilige Konfiguration und Hostumgebung die Voraussetzungen des konkreten Restore-Modus erfüllen. Solche Eingriffe können den Fernzugriff unterbrechen.
Nein. Standardmäßig liegen sie unter /var/lib/vz/host-config-backups/ auf dem Host. Gegen vollständigen Datenträgerverlust ist eine zusätzliche externe oder unabhängige Sicherung nötig. Die Archive sind nicht automatisch verschlüsselt.
Nein. Die Quellen stammen aus einer Proxmox-VE-9.x-Umgebung, ohne allgemeine Versions-Kompatibilitätsmatrix. Cluster und viele Sonderkonfigurationen sind nicht unterstützt. Es gibt dokumentierte Sicherheitsgrenzen, insbesondere bei der vollständigen Datenbankwiederherstellung und schwerwiegenden Systemabbrüchen.
Nein. Die Firewall-Transaktionshärtung war ein gesondert begonnenes Entwicklungsthema mit Zielversion 1.15. Öffentlich veröffentlicht ist weiterhin Restore 1.14. Eine Freigabe oder ein Veröffentlichungsdatum für 1.15 gibt es nicht.
C30 steht für eine spätere Forschungs- und Entwicklungsrichtung: Wiederherstellungszustände sollen auch bei schweren Unterbrechungen wie SIGKILL, Neustart oder Stromverlust nachvollziehbarer werden. Diese Funktion ist in Restore 1.14 nicht implementiert.
Damit das Projekt international verständlich und nutzbar ist. Die bestehenden Skripte wurden dafür bewusst nicht umgeschrieben oder übersetzt.