Folosește formatul de dump personalizat PostgreSQL pentru o copie de rezervă a bazei de date Synapse, exclude tabelul cu chei unice și restaurează într-o bază de date goală nou creată. Dump-ul bazei de date în sine nu este o copie de rezervă completă a serverului de acasă: păstrează configurația Synapse, cheia de semnare și mediul local. Ghidul oficial de backup al Synapse, verificat la 10 octombrie 2026, avertizează în mod specific împotriva restaurării peste tabelele existente și împotriva restaurării cheilor unice de criptare end-to-end vechi.
Ce conține – și ce nu – o copie de rezervă a bazei de date
Verificat: pg_dump creează o instantanee consistentă în timp ce PostgreSQL rămâne online; Synapse nu trebuie oprit în timp ce rulează dump-ul. Un dump exclusiv pentru baza de date nu include fișiere din depozitul media Synapse, homeserver.yamlfișierele de configurare la care se face referire sau cheia de semnare a serverului. Păstrați-le într-un set separat de copii de rezervă protejate. Synapse identifică conținutul încărcat local și, atunci când miniaturile dinamice sunt dezactivate, miniaturile locale ca date de păstrat. Memoriile media la distanță și memoria cache de previzualizare URL pot fi, în general, preluate sau reconstruite.
Acțiune: identificați numele bazei de date active, rolul PostgreSQL, directorul de configurare Synapse, calea cheii de semnare și calea depozitului media înainte de a construi un plan de recuperare. Utilizați căile configurate pe server; acestea variază în funcție de pachet, container și implementare.
Greșeală comună: o copie de rezervă SQL reușită nu este o dovadă că întregul server de acasă poate fi recuperat. Acțiune: faceți o copie de rezervă a bazei de date, a cheii de configurare și de semnare și a suporturilor media locale necesare și testați periodic restaurarea lor împreună.
Crearea și verificarea unui dump în format personalizat
Comenzile de mai jos presupun o gazdă Linux cu instrumente din linia de comandă PostgreSQL instalate, o bază de date numită synapseși permisiunea de a rula comenzi PostgreSQL ca și postgrescont al sistemului de operare. Înlocuiți numele bazei de date și căile cu valorile implementării. Stocați dump-ul pe o memorie protejată cu suficient spațiu liber; acesta poate conține mesaje private și date de cont.
Creați dump-ul, excluzând conținutul tabelului despre care Synapse spune că nu trebuie redat dintr-o copie de rezervă mai veche:
sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump
-Fcselectează formatul de arhivă personalizat al PostgreSQL, care este potrivit pentru pg_restoreși este adesea mai mic decât SQL simplu. Excluderea afectează datele din tabel; nu elimină definiția tabelului.
Verificați dacă fișierul există și nu este gol, apoi listați cuprinsul arhivei:
ls -lh /secure-backups/synapse.dump
sudo -u postgres pg_restore --list /secure-backups/synapse.dump
O listare confirmă faptul că PostgreSQL poate citi structura arhivei; nu dovedește că fiecare rând poate fi restaurat sau că alte fișiere de rezervă sunt complete. Pentru verificări mai puternice, copiați dump-ul într-o memorie separată pentru copii de rezervă și verificați suma de control după transfer.
Concepție greșită des întâlnită: oprirea Synapse este necesară pentru fiecare [operare/operare/operare /operare pg_dump]. Pagina oficială Synapse spune că o pg_dumpinstantanee normală este consistentă fără oprirea Synapse sau a PostgreSQL. Acțiune: mențineți serviciul online pentru această copie de rezervă logică, dar planificați o fereastră de întreținere pentru o restaurare completă.
Restaurare într-o bază de date goală
Restaurarea este o operațiune de înlocuire. Mai întâi opriți Synapse și orice worker Synapse, astfel încât nimic să nu se conecteze sau să scrie pe țintă în timp ce recuperarea este în desfășurare. Confirmați numele bazei de date țintă și dump-ul înainte de a emite comenzi de modificare a bazei de date.
Creați o bază de date nouă cu codificare UTF-8 și proprietarul utilizat de configurația Synapse. Următoarele utilizează rolul exemplu synapse_user:
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
Dacă numele bazei de date există deja, nu o restaurați orbește. Urmați procedura de recuperare pentru a păstra sau elimina vechea bază de date numai după ce i-ați confirmat conținutul și vă asigurați că aveți o copie de rezervă separată, recuperabilă.
Încărcați arhiva în baza de date goală:
sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump
Verificați starea de ieșire a comenzii și ieșirea PostgreSQL. Investigați erorile înainte de a porni Synapse. Evitați opțiuni precum --cleano comandă rapidă pentru restaurarea peste o bază de date de producție populată; Synapse avertizează că tabelele preexistente pot cauza erori sau inconsistențe subtile.
Dacă dump-ul nu a exclus datele cu cheie unică folosintă, ștergeți-l înainte de pornire. Conectați-vă la baza de date restaurată și executați:
sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'
Synapse documentează această excepție deoarece restaurarea cheilor vechi de unică folosință poate determina un client să reutilizeze chei care au fost deja consumate, ceea ce poate duce la probleme de decriptare a mesajelor. Ștergerea acestora solicită clienților să încarce chei noi. Dacă ați urmat excluderea recomandată, tabelul nu are rânduri restaurate și această trunchiere suplimentară este inutilă.
Concepție greșită des întâlnită: toate tabelele bazei de date pot fi restaurate în siguranță. Acțiune: excludeți-le e2e_one_time_keys_jsonîn timpul copiei de rezervă sau trunchiați-le după restaurare și faceți acest lucru înainte de începerea oricărui proces Synapse.
Adu înapoi serverul de acasă și verifică-l
Restaurați configurația corespunzătoare, cheia de semnare și fișierele media locale necesare din același punct de recuperare, acolo unde este posibil. Păstrați cheia de semnare originală: Synapse o folosește pentru a semna evenimente și solicitări de federare. Dacă trebuie să o înlocuiți, urmați instrucțiunile Synapse privind cheia de semnare și configurați vechea cheie publică ca o cheie de semnare veche. Baza de date, media și configurația restaurate din momente foarte diferite pot să nu descrie aceeași stare, așadar verificați consecvența planului de recuperare.
Porniți Synapse și funcționarii săi numai după finalizarea restaurării și a gestionării cheilor unice. Verificați jurnalele de servicii pentru erori de conexiune la baza de date, erori de schemă sau permisiuni lipsă și probleme de actualizare în fundal. Apoi conectați-vă cu un cont de testare, inspectați istoricul recent al unei camere cunoscute și deschideți un atașament încărcat local. Verificați serviciile de federație și de aplicație dacă implementarea dvs. se bazează pe acestea. Aceste verificări sunt un test practic, nu o garanție că fiecare cameră sau obiect media a fost recuperat.
Depinde de implementare: căile de comenzi, numele serviciilor, rolurile bazei de date, orchestrarea containerelor și păstrarea copiilor de rezervă sunt specifice instalării. Această procedură acoperă o copie de rezervă și o restaurare logică PostgreSQL, nu o recuperare la un moment dat, roluri PostgreSQL la nivel de cluster sau un design de failover cu disponibilitate ridicată. Pentru sistemele de producție, consultați documentația pentru copiile de rezervă Synapse și documentația pentru copiile de rezervă și restaurarea PostgreSQL pentru metodele care corespund versiunii PostgreSQL și obiectivelor de recuperare. Înregistrați data, versiunile de software și rezultatul unui test de restaurare; nu presupuneți că o arhivă netestată este o copie de rezervă recuperabilă.