Użyj niestandardowego formatu zrzutu PostgreSQL do utworzenia kopii zapasowej bazy danych Synapse, wyklucz tabelę klucza jednorazowego i przywróć do nowo utworzonej, pustej bazy danych. Sam zrzut bazy danych nie stanowi kompletnej kopii zapasowej serwera domowego: zachowaj również konfigurację Synapse, klucz podpisu i nośniki lokalne. Oficjalne wytyczne dotyczące kopii zapasowych Synapse, sprawdzone 10 października 2026 r., wyraźnie ostrzegają przed przywracaniem danych z wykorzystaniem istniejących tabel oraz przed przywracaniem starych kluczy jednorazowych szyfrowania end-to-end.
Co zawiera kopia zapasowa bazy danych, a czego nie
Zweryfikowano: pg_dump tworzy spójną migawkę, podczas gdy PostgreSQL pozostaje online; Synapse nie musi być zatrzymywany podczas wykonywania zrzutu. Zrzut obejmujący tylko bazę danych nie zawiera plików z magazynu multimediów Synapse, homeserver.yamlplików konfiguracyjnych, do których się odwołuje, ani klucza podpisu serwera. Należy je przechowywać w oddzielnym, chronionym zestawie kopii zapasowych. Synapse identyfikuje lokalnie przesłane treści, a po wyłączeniu dynamicznych miniatur, lokalne miniatury jako dane do zachowania. Zdalne pamięci podręczne multimediów i podglądu adresów URL można zazwyczaj pobrać lub odbudować.
Działanie: przed utworzeniem planu odzyskiwania zidentyfikuj nazwę aktywnej bazy danych, rolę PostgreSQL, katalog konfiguracji Synapse, ścieżkę klucza podpisu i ścieżkę magazynu nośników. Użyj ścieżek skonfigurowanych na serwerze; różnią się one w zależności od pakietu, kontenera i wdrożenia.
Powszechne błędne przekonanie: udany zrzut SQL nie jest dowodem na to, że cały serwer domowy można odzyskać. Działanie: utwórz kopię zapasową bazy danych, konfiguracji i klucza podpisu oraz wymaganych nośników lokalnych, a następnie okresowo testuj ich przywracanie.
Utwórz i sprawdź zrzut w niestandardowym formacie
Poniższe polecenia zakładają host z systemem Linux, zainstalowanymi narzędziami wiersza poleceń PostgreSQL, bazą danych o nazwie synapsei uprawnieniami do uruchamiania poleceń PostgreSQL jako postgreskonto systemu operacyjnego. Zastąp nazwę bazy danych i ścieżki wartościami z wdrożenia. Przechowuj zrzut w chronionym magazynie z wystarczającą ilością wolnego miejsca; może on zawierać prywatne wiadomości i dane konta.
Utwórz zrzut, wyłączając zawartość tabeli, której według Synapse nie można odtworzyć ze starszej kopii zapasowej:
sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump
-FcWybiera niestandardowy format archiwum PostgreSQL, który jest odpowiedni dla pg_restorezwykłego SQL i często zajmuje mniej miejsca. Wykluczenie dotyczy danych w tabeli, ale nie usuwa definicji tabeli.
Sprawdź, czy plik istnieje i czy nie jest pusty, a następnie wyświetl spis treści archiwum:
ls -lh /secure-backups/synapse.dump
sudo -u postgres pg_restore --list /secure-backups/synapse.dump
Listing potwierdza, że PostgreSQL może odczytać strukturę archiwum; nie dowodzi to jednak, że każdy wiersz można przywrócić ani że inne pliki kopii zapasowej są kompletne. Aby uzyskać silniejsze zabezpieczenia, skopiuj zrzut do osobnego magazynu kopii zapasowych i zweryfikuj jego sumę kontrolną po przesłaniu.
Powszechne nieporozumienie: zatrzymanie Synapse jest wymagane dla każdego pg_dump. Oficjalna strona Synapse podaje, że normalna pg_dumpmigawka jest spójna bez zatrzymywania Synapse lub PostgreSQL. Działanie: utrzymuj usługę online dla tej logicznej kopii zapasowej, ale zaplanuj okno konserwacyjne na pełne przywrócenie.
Przywróć do pustej bazy danych
Przywracanie to operacja zastępowania. Najpierw zatrzymaj Synapse i wszystkie procesy robocze Synapse, aby nic nie łączyło się z bazą docelową ani nie zapisywało danych do niej podczas odzyskiwania. Przed wydaniem poleceń zmieniających bazę danych sprawdź nazwę docelowej bazy danych i wykonaj zrzut.
Utwórz nową bazę danych z kodowaniem UTF-8 i właścicielem używanym w konfiguracji Synapse. Poniżej wykorzystano przykładową rolę synapse_user:
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
Jeśli nazwa bazy danych już istnieje, nie przywracaj jej bezmyślnie. Postępuj zgodnie z procedurą odzyskiwania, aby zachować lub usunąć starą bazę danych dopiero po potwierdzeniu jej zawartości i upewnieniu się, że posiadasz oddzielną, odzyskiwalną kopię zapasową.
Załaduj archiwum do pustej bazy danych:
sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump
Sprawdź status wyjścia polecenia i dane wyjściowe PostgreSQL. Zbadaj błędy przed uruchomieniem Synapse. Unikaj opcji takich jak --cleanskrót do przywracania danych z zapełnionej bazy danych produkcyjnej; Synapse ostrzega, że istniejące tabele mogą powodować błędy lub subtelne niespójności.
Jeśli zrzut nie wykluczył danych klucza jednorazowego, wyczyść go przed uruchomieniem. Połącz się z przywróconą bazą danych i uruchom:
sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'
Synapse dokumentuje ten wyjątek, ponieważ przywrócenie starych kluczy jednorazowych może spowodować, że klient ponownie użyje kluczy, które zostały już wykorzystane, co może prowadzić do problemów z odszyfrowywaniem wiadomości. Wyczyszczenie ich powoduje, że klienci muszą przesłać nowe klucze. Jeśli zastosowano się do zalecanego wykluczenia, tabela nie zawiera przywróconych wierszy, a to dodatkowe obcięcie jest zbędne.
Powszechne nieporozumienie: wszystkie tabele bazy danych można bezpiecznie przywrócić. Działanie: wyklucz je e2e_one_time_keys_jsonpodczas tworzenia kopii zapasowej lub obetnij po przywróceniu, i zrób to przed uruchomieniem jakiegokolwiek procesu Synapse.
Przywróć serwer domowy i go zweryfikuj
Przywróć pasującą konfigurację, klucz podpisu i wymagane lokalne pliki multimedialne z tego samego punktu odzyskiwania, jeśli to możliwe. Zachowaj oryginalny klucz podpisu: Synapse używa go do podpisywania zdarzeń i żądań federacji. Jeśli musisz go zastąpić, postępuj zgodnie ze wskazówkami Synapse dotyczącymi klucza podpisu i skonfiguruj stary klucz publiczny jako stary klucz podpisu. Baza danych, nośniki i konfiguracja przywrócone z bardzo różnych punktów w czasie mogą nie opisywać tego samego stanu, dlatego sprawdź spójność planu odzyskiwania.
Uruchom Synapse i jego procesy robocze dopiero po zakończeniu przywracania i obsługi klucza jednorazowego. Przejrzyj dzienniki usług pod kątem błędów połączenia z bazą danych, błędów braku schematu lub uprawnień oraz problemów z aktualizacją w tle. Następnie zaloguj się na konto testowe, sprawdź historię zmian w znanym pokoju i otwórz lokalnie przesłany załącznik. Sprawdź usługi federacyjne i aplikacyjne, jeśli Twoje wdrożenie z nich korzysta. Te sprawdzenia to praktyczny test dymny, a nie gwarancja, że każdy pokój lub obiekt multimedialny został odzyskany.
Zależy to od wdrożenia: ścieżki poleceń, nazwy usług, role bazy danych, organizacja kontenerów i przechowywanie kopii zapasowych są specyficzne dla instalacji. Ta procedura obejmuje logiczny zrzut i przywracanie bazy danych PostgreSQL, a nie odzyskiwanie do określonego punktu w czasie, role PostgreSQL w całym klastrze ani projekt przełączania awaryjnego o wysokiej dostępności. W przypadku systemów produkcyjnych zapoznaj się z dokumentacją tworzenia kopii zapasowych Synapse oraz dokumentacją tworzenia kopii zapasowych i przywracania bazy danych PostgreSQL, aby znaleźć metody odpowiadające Twoim celom dotyczącym wersji i odzyskiwania bazy danych PostgreSQL. Zapisz datę testu przywracania, wersje oprogramowania i wynik; nie zakładaj, że nieprzetestowane archiwum jest odzyskiwalną kopią zapasową.