Herstel Matrix Synapse veilig met een PostgreSQL-dump.

Gebruik het aangepaste dumpformaat van PostgreSQL voor een back-up van uw Synapse-database, sluit de tabel met eenmalige sleutels uit en herstel de back-up in een nieuw aangemaakte, lege database. De database-dump alleen is geen volledige back-up van uw thuisserver: bewaar ook de Synapse-configuratie, de ondertekeningssleutel en de lokale media. De officiële back-uprichtlijnen van Synapse, geraadpleegd op 10 oktober 2026, waarschuwen specifiek tegen het overschrijven van bestaande tabellen en tegen het herstellen van oude eenmalige end-to-end-encryptiesleutels.

Wat een databaseback-up wel en niet bevat

Geverifieerd: pg_dump er wordt een consistente momentopname gemaakt terwijl PostgreSQL online blijft; Synapse hoeft niet te worden gestopt tijdens het maken van de dump. Een database-dump bevat geen bestanden uit de mediastore van Synapse, geen homeserver.yamlgekoppelde configuratiebestanden en geen serverondertekeningssleutel. Bewaar deze in een aparte, beveiligde back-up. Synapse identificeert lokaal geüploade content en, wanneer dynamische miniaturen zijn uitgeschakeld, ook lokale miniaturen als gegevens die bewaard moeten worden. Externe media- en URL-previewcaches kunnen over het algemeen worden opgehaald of opnieuw opgebouwd.

Actie: identificeer de actieve databasenaam, de PostgreSQL-rol, de Synapse-configuratiemap, het pad naar de ondertekeningssleutel en het pad naar de mediaopslag voordat u een herstelplan opstelt. Gebruik de paden die op uw server zijn geconfigureerd; deze variëren per pakket, container en implementatie.

Veelvoorkomende misvatting: een succesvolle SQL-dump is geen bewijs dat de hele thuisserver kan worden hersteld. Actie: maak een back-up van de database, de configuratie, de ondertekeningssleutel en de benodigde lokale media, en test periodiek of het mogelijk is om deze samen te herstellen.

Maak en controleer een dumpbestand in een aangepast formaat.

De onderstaande commando's gaan ervan uit dat u een Linux-host gebruikt met de PostgreSQL-commandoregeltools geïnstalleerd, een database met de naam synapse, en dat u toestemming hebt om PostgreSQL-commando's uit te voeren als het postgresbesturingssysteemaccount. Vervang de databasenaam en paden door de waarden van uw implementatie. Sla de dump op een beveiligde opslaglocatie met voldoende vrije ruimte; deze kan privéberichten en accountgegevens bevatten.

  1. Maak de dump aan, met uitzondering van de inhoud van de tabel waarvan Synapse aangeeft dat deze niet mag worden hersteld vanuit een oudere back-up:

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

    -FcSelecteert het aangepaste archiefformaat van PostgreSQL, dat geschikt is voor pg_restoreen vaak kleiner is dan standaard SQL. De uitsluiting heeft betrekking op tabelgegevens; de tabeldefinitie wordt niet verwijderd.

  2. Controleer of het bestand bestaat en niet leeg is, en toon vervolgens de inhoudsopgave van het archief:

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

    Een lijst bevestigt dat PostgreSQL de archiefstructuur kan lezen; het bewijst echter niet dat elke rij kan worden hersteld of dat andere back-upbestanden compleet zijn. Voor een grondigere controle kunt u de dump kopiëren naar een aparte back-upopslag en de checksum na de overdracht controleren.

Veelvoorkomende misvatting: Synapse moet voor elke back-up gestopt worden pg_dump. De officiële Synapse-pagina stelt dat een normale pg_dumpsnapshot consistent is zonder Synapse of PostgreSQL te stoppen. Actie: houd de service online voor deze logische back-up, maar plan een onderhoudsvenster in voor een volledige herstelbewerking.

Herstellen naar een lege database

Het herstellen van een database is een vervangingsbewerking. Stop eerst Synapse en alle Synapse-workers, zodat er tijdens het herstelproces geen verbindingen met de doeldatabase tot stand komen en er niet naar de doeldatabase wordt geschreven. Controleer de naam van de doeldatabase en de database-dump voordat u opdrachten uitvoert die de database wijzigen.

  1. Maak een nieuwe database aan met UTF-8-codering en de eigenaar die in uw Synapse-configuratie wordt gebruikt. Het volgende voorbeeld gebruikt de rol synapse_user:

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

    Als de databasenaam al bestaat, herstel deze dan niet zomaar. Volg uw herstelprocedure om de oude database te behouden of te verwijderen, maar doe dit pas nadat u de inhoud ervan hebt gecontroleerd en ervoor hebt gezorgd dat u een aparte, herstelbare back-up hebt.

  2. Laad het archief in de lege database:

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

    Controleer de exitstatus van de opdracht en de PostgreSQL-uitvoer. Onderzoek fouten voordat u Synapse start. Vermijd opties zoals --cleanals snelkoppeling voor het herstellen van een gevulde productiedatabase; Synapse waarschuwt dat reeds bestaande tabellen fouten of subtiele inconsistenties kunnen veroorzaken.

  3. Als de back-up geen eenmalige sleutelgegevens bevat, verwijder deze dan vóór het opstarten. Maak verbinding met de herstelde database en voer de volgende opdracht uit:

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

    Synapse documenteert deze uitzondering omdat het herstellen van oude eenmalige sleutels ertoe kan leiden dat een client sleutels hergebruikt die al zijn gebruikt, wat problemen met het decoderen van berichten kan veroorzaken. Door ze te wissen, worden clients gevraagd nieuwe sleutels te uploaden. Als u de aanbevolen uitzondering hebt gevolgd, bevat de tabel geen herstelde rijen en is deze extra verwijdering niet nodig.

Veelvoorkomende misvatting: alle databasetabellen kunnen veilig tegelijkertijd worden teruggezet. Actie: sluit de tabellen uit e2e_one_time_keys_jsontijdens de back-up of verwijder de inhoud ervan na het herstel, en doe dit voordat een Synapse-proces start.

Zet de thuisserver weer aan de praat en controleer het.

Herstel de bijbehorende configuratie, ondertekeningssleutel en benodigde lokale mediabestanden waar mogelijk vanaf hetzelfde herstelpunt. Bewaar de originele ondertekeningssleutel: Synapse gebruikt deze om gebeurtenissen en federatieverzoeken te ondertekenen. Als u deze moet vervangen, volg dan de richtlijnen van Synapse voor ondertekeningssleutels en configureer de oude openbare sleutel als een oude ondertekeningssleutel. Databases, media en configuratie die vanaf zeer verschillende tijdstippen zijn hersteld, beschrijven mogelijk niet dezelfde status. Controleer daarom uw herstelplan op consistentie.

Start Synapse en de bijbehorende workers pas nadat het herstelproces en de afhandeling van de eenmalige sleutel zijn voltooid. Controleer de servicelogboeken op fouten in de databaseverbinding, ontbrekende schema's of machtigingsfouten en problemen met achtergrondupdates. Meld u vervolgens aan met een testaccount, bekijk de recente geschiedenis van een bekende ruimte en open een lokaal geüploade bijlage. Controleer de federatie- en applicatieservices als uw implementatie daarvan afhankelijk is. Deze controles zijn een praktische test, geen garantie dat elke ruimte of elk mediaobject is hersteld.

Afhankelijk van uw implementatie: commandopaden, servicenamen, databaserollen, containerorkestratie en back-upretentie zijn installatiespecifiek. Deze procedure beschrijft een logische PostgreSQL-dump en -herstel, niet herstel naar een specifiek tijdstip, clusterbrede PostgreSQL-rollen of een failover-ontwerp voor hoge beschikbaarheid. Raadpleeg voor productiesystemen de Synapse-back-updocumentatie en de PostgreSQL-back-up- en hersteldocumentatie voor methoden die overeenkomen met uw PostgreSQL-versie en hersteldoelstellingen. Noteer de datum, softwareversies en het resultaat van een hersteltest; ga er niet vanuit dat een niet-getest archief een herstelbare back-up is.

Laat een reactie achter

Herstel Matrix Synapse veilig met een PostgreSQL-dump.

Maak een back-up van Synapse met pg_dump, bescherm de ondertekeningssleutel en de media, en herstel de back-up in een schone PostgreSQL-database zonder verouderde eenmalige sleutels opnieuw te gebruiken.

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Configureer Mjölnir met een speciaal Matrix-account, een versleutelde beheerruimte, Docker Compose, een beleidslijst en toegangsrechtencontroles.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Sla de verouderde proxy over en configureer Synapse's ingebouwde Sliding Sync. Controleer de clientdetectie en meet vervolgens het laadgedrag van de kamerlijst en het herverbindingsgedrag op een compatibele telefoon.

Element Web hosten op Nginx met een aangepaste homeserver

Implementeer Element Web als een statische site, verwijs deze naar uw Matrix-homeserver, voeg HTTPS toe en configureer Nginx om updates te leveren zonder verouderde bestanden.

Een lichtgewicht Matrix-homeserver draaien op een Raspberry Pi 4

Configureer Conduit op een 64-bits Raspberry Pi 4 met permanente dataopslag, HTTPS-federatie, beveiligde registratie en controles voor een werkende thuisserver.

Stel een aangepaste Matrix-ruimtealias in op uw eigen domein.

Geef een Matrix-ruimte een eenvoudig te delen adres op uw domein met behulp van Element of de Matrix API, inclusief controles op machtigingen, Synapse-naamgeving en federatie.

Stel coturn in voor betrouwbare Matrix-spraak- en videogesprekken.

Configureer coturn en Synapse met overeenkomende TURN-gegevens, open de vereiste relaypoorten en controleer of Matrix-clients relaykandidaten kunnen verkrijgen.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Zet een permanente Synapse-homeserver op met Docker Compose, PostgreSQL, een privéconfiguratie en controles voordat je deze via HTTPS beschikbaar stelt.

Het thema en de huisstijl van Element Web aanpassen

Stel een merknaam, aangepaste kleuren en inloggegevens in voor uw Element Web-implementatie, en zorg ervoor dat u weet welke onderdelen het Element-merk behouden.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Stel vast of Synapse de limiet voor geopende bestanden per proces heeft bereikt, stel een systemd drop-in in voor de juiste service of worker en controleer de actuele limiet.