Bezpieczne przywracanie Matrix Synapse za pomocą zrzutu PostgreSQL

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.

  1. 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.

  2. 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.

  1. 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ą.

  2. 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.

  3. 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ą.

Zostaw komentarz

Bezpieczne przywracanie Matrix Synapse za pomocą zrzutu PostgreSQL

Utwórz kopię zapasową Synapse za pomocą pg_dump, chroń jej klucz podpisu i nośnik, a następnie przywróć do czystej bazy danych PostgreSQL bez ponownego używania nieaktualnych kluczy jednorazowych.

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Skonfiguruj Mjölnir przy użyciu dedykowanego konta Matrix, szyfrowanego pokoju zarządzania, Docker Compose, listy zasad i kontroli uprawnień.

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Pomiń wycofany serwer proxy i skonfiguruj wbudowaną funkcję Sliding Sync w Synapse. Sprawdź wykrywanie klientów, a następnie zmierz ładowanie listy pokoi i zachowanie ponownego łączenia na kompatybilnym telefonie.

Host Element Web na Nginx z niestandardowym serwerem domowym

Wdróż Element Web jako witrynę statyczną, skieruj ją do serwera domowego Matrix, dodaj HTTPS i skonfiguruj Nginx, aby obsługiwał aktualizacje bez przestarzałych plików.

Uruchom lekki serwer domowy Matrix na Raspberry Pi 4

Skonfiguruj Conduit na 64-bitowym Raspberry Pi 4 ze stałymi danymi, federacją HTTPS, chronioną rejestracją i sprawdź, czy serwer domowy działa.

Skonfiguruj niestandardowy alias pokoju macierzy w swojej własnej domenie

Nadaj pokojowi Matrix łatwy do udostępniania adres w swojej domenie, korzystając z Element lub interfejsu API Matrix, ze sprawdzaniem uprawnień, nazewnictwem Synapse i federacją.

Skonfiguruj coturn, aby zapewnić niezawodne połączenia głosowe i wideo Matrix

Skonfiguruj coturn i Synapse przy użyciu zgodnych poświadczeń TURN, otwórz wymagane porty przekaźnikowe i sprawdź, czy klienci Matrix mogą uzyskać kandydatów na przekaźniki.

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Skonfiguruj trwały serwer domowy Synapse z Docker Compose, PostgreSQL, prywatną konfiguracją i sprawdź, czy jest on udostępniany przez HTTPS.

Dostosuj motyw i branding Element Web

Ustaw nazwę marki, niestandardowe kolory i zasoby logowania dla wdrożenia Element Web, pamiętając jednocześnie, które części pozostaną markowe dla Element.

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.