Matrix Synapse sicher mit einem PostgreSQL-Dump wiederherstellen

Verwenden Sie für ein Synapse-Datenbank-Backup das benutzerdefinierte Dump-Format von PostgreSQL, schließen Sie die Tabelle mit dem Einmalschlüssel aus und stellen Sie die Daten in einer neu erstellten, leeren Datenbank wieder her. Ein Datenbank-Dump allein stellt kein vollständiges Homeserver-Backup dar: Bewahren Sie auch die Synapse-Konfiguration, den Signaturschlüssel und die lokalen Speichermedien auf. Die offiziellen Backup-Richtlinien von Synapse (Stand: 10. Oktober 2026) warnen ausdrücklich davor, bestehende Tabellen zu überschreiben oder alte Einmalschlüssel für die Ende-zu-Ende-Verschlüsselung wiederherzustellen.

Was eine Datenbanksicherung enthält – und was nicht

Verifiziert: pg_dump Erstellt einen konsistenten Snapshot, während PostgreSQL online bleibt; Synapse muss während des Dump-Vorgangs nicht gestoppt werden. Ein reiner Datenbank-Dump enthält keine Dateien aus dem Synapse-Medienspeicher, homeserver.yamlreferenzierte Konfigurationsdateien oder den Server-Signaturschlüssel. Diese sollten in einem separaten, geschützten Backup-Set aufbewahrt werden. Synapse erkennt lokal hochgeladene Inhalte und, falls dynamische Miniaturansichten deaktiviert sind, lokale Miniaturansichten als zu erhaltende Daten. Remote-Medien und URL-Vorschau-Caches können in der Regel abgerufen oder neu erstellt werden.

Vor dem Erstellen eines Wiederherstellungsplans müssen Sie den Namen der aktiven Datenbank, die PostgreSQL-Rolle, das Synapse-Konfigurationsverzeichnis, den Pfad zum Signaturschlüssel und den Pfad zum Medienspeicher ermitteln. Verwenden Sie die auf Ihrem Server konfigurierten Pfade; diese variieren je nach Paket, Container und Bereitstellung.

Häufiger Irrtum: Ein erfolgreicher SQL-Dump beweist nicht, dass der gesamte Homeserver wiederhergestellt werden kann. Empfehlung: Sichern Sie die Datenbank, die Konfiguration, den Signaturschlüssel und die benötigten lokalen Datenträger und testen Sie regelmäßig die gemeinsame Wiederherstellung.

Erstellen und Überprüfen eines benutzerdefinierten Speicherabbilds

Die folgenden Befehle setzen ein Linux-System mit installierten PostgreSQL-Befehlszeilentools, einer Datenbank mit dem Namen `<Datenbankname>` synapseund der Berechtigung zur Ausführung von PostgreSQL-Befehlen als postgresBetriebssystemkonto voraus. Ersetzen Sie den Datenbanknamen und die Pfade durch die Werte Ihrer Installation. Speichern Sie den Datenbank-Dump auf einem geschützten Speichermedium mit ausreichend freiem Speicherplatz; er kann private Nachrichten und Kontodaten enthalten.

  1. Erstellen Sie einen Dump, wobei der Inhalt der Tabelle ausgeschlossen wird, die laut Synapse nicht aus einem älteren Backup wiederhergestellt werden darf:

    sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump

    -FcWählt das benutzerdefinierte Archivformat von PostgreSQL aus, das sich für SQL eignet pg_restoreund oft kleiner ist als reines SQL. Der Ausschluss betrifft Tabellendaten; die Tabellendefinition selbst wird nicht entfernt.

  2. Prüfen Sie, ob die Datei existiert und nicht leer ist, und listen Sie dann das Inhaltsverzeichnis des Archivs auf:

    ls -lh /secure-backups/synapse.dump
    sudo -u postgres pg_restore --list /secure-backups/synapse.dump

    Eine Auflistung bestätigt, dass PostgreSQL die Archivstruktur lesen kann; sie beweist jedoch nicht, dass jede Zeile wiederhergestellt werden kann oder dass andere Sicherungsdateien vollständig sind. Für eine zuverlässigere Prüfung kopieren Sie den Dump auf einen separaten Sicherungsspeicher und überprüfen Sie dessen Prüfsumme nach der Übertragung.

Häufiger Irrtum: Synapse muss für jede Sicherung angehalten werden pg_dump. Laut der offiziellen Synapse-Seite ist ein normaler pg_dumpSnapshot konsistent, ohne dass Synapse oder PostgreSQL angehalten werden müssen. Empfehlung: Lassen Sie den Dienst für diese logische Sicherung online, planen Sie aber ein Wartungsfenster für eine vollständige Wiederherstellung ein.

Wiederherstellung in eine leere Datenbank

Die Wiederherstellung ist ein Ersetzungsvorgang. Stoppen Sie zunächst Synapse und alle Synapse-Worker, damit während der Wiederherstellung keine Verbindungen zum Zielsystem hergestellt oder Daten darauf geschrieben werden. Bestätigen Sie den Namen der Zieldatenbank und erstellen Sie ein Backup, bevor Sie Befehle zur Datenbankänderung ausführen.

  1. Erstellen Sie eine neue Datenbank mit UTF-8-Kodierung und dem Eigentümer, der in Ihrer Synapse-Konfiguration verwendet wird. Im Folgenden wird die Beispielrolle verwendet synapse_user:

    sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

    Existiert die Datenbank bereits, sollten Sie sie nicht einfach wiederherstellen. Führen Sie Ihre Wiederherstellungsprozedur zum Beibehalten oder Löschen der alten Datenbank erst durch, nachdem Sie deren Inhalt geprüft und sichergestellt haben, dass Sie über eine separate, wiederherstellbare Sicherung verfügen.

  2. Laden Sie das Archiv in die leere Datenbank:

    sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump

    Überprüfen Sie den Exit-Status des Befehls und die PostgreSQL-Ausgabe. Untersuchen Sie Fehler, bevor Sie Synapse starten. Vermeiden Sie Optionen wie --cleanbeispielsweise die Verwendung von Standardeinstellungen zum Wiederherstellen einer bereits gefüllten Produktionsdatenbank; Synapse warnt davor, dass bereits vorhandene Tabellen Fehler oder subtile Inkonsistenzen verursachen können.

  3. Falls der Dump Einmalschlüsseldaten nicht ausschloss, löschen Sie diese vor dem Start. Stellen Sie eine Verbindung zur wiederhergestellten Datenbank her und führen Sie Folgendes aus:

    sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'

    Synapse dokumentiert diese Ausnahme, da die Wiederherstellung alter Einmalschlüssel dazu führen kann, dass ein Client bereits verwendete Schlüssel wiederverwendet, was wiederum Probleme bei der Nachrichtenentschlüsselung verursachen kann. Durch das Löschen dieser Schlüssel werden Clients aufgefordert, neue Schlüssel hochzuladen. Wenn Sie die empfohlene Ausnahme befolgt haben, enthält die Tabelle keine wiederhergestellten Zeilen, und diese zusätzliche Kürzung ist unnötig.

Häufiger Irrtum: Alle Datenbanktabellen können gefahrlos wiederhergestellt werden. Abhilfe: Schließen Sie e2e_one_time_keys_jsondie Tabellen beim Backup aus oder kürzen Sie sie nach der Wiederherstellung, und zwar bevor ein Synapse-Prozess startet.

Bring den Homeserver zurück und überprüfe ihn.

Stellen Sie nach Möglichkeit die passende Konfiguration, den Signaturschlüssel und die erforderlichen lokalen Mediendateien vom selben Wiederherstellungspunkt wieder her. Bewahren Sie den ursprünglichen Signaturschlüssel auf: Synapse verwendet ihn zum Signieren von Ereignissen und Verbundanfragen. Falls Sie ihn ersetzen müssen, befolgen Sie die Anweisungen von Synapse zum Signaturschlüssel und konfigurieren Sie den alten öffentlichen Schlüssel als alten Signaturschlüssel. Datenbank, Medien und Konfiguration, die von weit auseinanderliegenden Zeitpunkten wiederhergestellt wurden, beschreiben möglicherweise nicht denselben Zustand. Überprüfen Sie daher Ihren Wiederherstellungsplan auf Konsistenz.

Starten Sie Synapse und seine Worker erst, nachdem die Wiederherstellung und die Verarbeitung des Einmalschlüssels abgeschlossen sind. Überprüfen Sie die Dienstprotokolle auf Datenbankverbindungsfehler, fehlende Schemata oder Berechtigungsfehler sowie Probleme mit Hintergrundaktualisierungen. Melden Sie sich anschließend mit einem Testkonto an, prüfen Sie den Verlauf eines bekannten Raums und öffnen Sie einen lokal hochgeladenen Anhang. Überprüfen Sie die Verbund- und Anwendungsdienste, falls Ihre Bereitstellung darauf angewiesen ist. Diese Prüfungen dienen als praktischer Funktionstest und garantieren nicht, dass alle Räume oder Medienobjekte wiederhergestellt wurden.

Abhängig von Ihrer Bereitstellung: Befehlspfade, Dienstnamen, Datenbankrollen, Container-Orchestrierung und Backup-Aufbewahrung sind installationsspezifisch. Dieses Verfahren beschreibt ein logisches PostgreSQL-Dump und -Restore, jedoch keine Point-in-Time-Wiederherstellung, clusterweite PostgreSQL-Rollen oder ein Hochverfügbarkeits-Failover-Design. Für Produktionssysteme konsultieren Sie bitte die Dokumentation zu Synapse-Backups und PostgreSQL-Backups und -Restores, um Methoden zu finden, die Ihrer PostgreSQL-Version und Ihren Wiederherstellungszielen entsprechen. Dokumentieren Sie Datum, Softwareversionen und Ergebnis eines Wiederherstellungstests; gehen Sie nicht davon aus, dass ein ungetestetes Archiv ein wiederherstellbares Backup ist.

Einen Kommentar hinterlassen

Matrix Synapse sicher mit einem PostgreSQL-Dump wiederherstellen

Sichern Sie Synapse mit pg_dump, schützen Sie den Signaturschlüssel und die Speichermedien und stellen Sie die Daten in einer sauberen PostgreSQL-Datenbank wieder her, ohne veraltete Einmalschlüssel wiederzuverwenden.

Mjölnir als Matrix-Raummoderationsbot mit Docker ausführen

Mjölnir als Matrix-Raummoderationsbot mit Docker ausführen

Richten Sie Mjölnir mit einem dedizierten Matrix-Konto, einem verschlüsselten Verwaltungsraum, Docker Compose, einer Richtlinienliste und Berechtigungsprüfungen ein.

Aktivieren Sie die native Matrix-Gleitsynchronisierung für schnelleres Laden auf Mobilgeräten.

Aktivieren Sie die native Matrix-Gleitsynchronisierung für schnelleres Laden auf Mobilgeräten.

Überspringen Sie den veralteten Proxy und konfigurieren Sie die in Synapse integrierte Sliding-Sync-Funktion. Überprüfen Sie die Client-Erkennung und messen Sie anschließend das Ladeverhalten der Raumliste sowie das Verhalten bei der Wiederverbindung auf einem kompatiblen Telefon.

Host Element Web auf Nginx mit einem benutzerdefinierten Homeserver

Stellen Sie Element Web als statische Website bereit, verweisen Sie es auf Ihren Matrix-Homeserver, fügen Sie HTTPS hinzu und konfigurieren Sie Nginx so, dass Aktualisierungen ohne veraltete Dateien bereitgestellt werden.

Betreiben Sie einen ressourcenschonenden Matrix-Homeserver auf einem Raspberry Pi 4

Conduit auf einem 64-Bit Raspberry Pi 4 mit persistenten Daten, HTTPS-Federation, geschützter Registrierung und Überprüfungen auf einen funktionierenden Homeserver einrichten.

Richten Sie einen benutzerdefinierten Matrix-Raumalias auf Ihrer eigenen Domain ein.

Weisen Sie einem Matrix-Raum mithilfe von Element oder der Matrix-API eine einfach zu teilende Adresse in Ihrer Domäne zu, inklusive Prüfungen auf Berechtigungen, Synapse-Namensgebung und Föderation.

Richten Sie coturn für zuverlässige Matrix-Sprach- und Videoanrufe ein.

Konfigurieren Sie coturn und Synapse mit übereinstimmenden TURN-Zugangsdaten, öffnen Sie die erforderlichen Relay-Ports und überprüfen Sie, ob Matrix-Clients Relay-Kandidaten erhalten können.

Matrix Synapse mit Docker Compose und PostgreSQL bereitstellen

Matrix Synapse mit Docker Compose und PostgreSQL bereitstellen

Richten Sie einen persistenten Synapse-Homeserver mit Docker Compose, PostgreSQL, einer privaten Konfiguration und Prüfungen ein, bevor Sie ihn über HTTPS zugänglich machen.

Design und Branding von Element Web anpassen

Legen Sie einen Markennamen, benutzerdefinierte Farben und Anmeldeinformationen für Ihre Element Web-Bereitstellung fest und behalten Sie dabei im Blick, welche Teile weiterhin unter der Marke Element vertrieben werden.

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Prüfen Sie, ob Synapse die maximale Anzahl offener Dateien pro Prozess erreicht hat, richten Sie ein systemd-Drop-in für den richtigen Dienst oder Worker ein und überprüfen Sie das aktuelle Limit.