Zatrzymaj awarię pamięci Matrix Synapse podczas synchronizacji klienta

Jeśli Matrix Synapse zabraknie pamięci podczas synchronizacji klientów, najpierw sprawdź, czy Linux faktycznie zamknął proces Synapse, a następnie zmierz zużycie pamięci podczas normalnego /_matrix/client/v3/syncobciążenia. Jeśli przyczyną jest wzrost pamięci podręcznej, wprowadź niewielką korektę pamięci podręcznej, zamiast od razu wymuszać bardzo niski limit; powolne odpowiedzi bazy danych mogą powodować opóźnienia w żądaniach, które pogłębiają problem.

Według stanu na 10 października 2026 roku oficjalna historia wydań Synapse wskazuje wersję 1.162.0 (z 29 września) jako najnowszą stabilną wersję, a wersję 1.163.0rc1 jako wersję przedpremierową. Aktualizacja przestarzałej instalacji jest rozsądna, ale sam numer wydania nie diagnozuje ani nie gwarantuje rozwiązania problemu wyczerpania pamięci związanego z synchronizacją.

1. Udowodnij, że jest to błąd wynikający z braku pamięci

Klienci wyświetlający niekończącą się synchronizację, błąd bramy lub rozłączoną sesję nie powodują samoczynnego wystąpienia zdarzenia OOM. W typowej instalacji systemu Linux systemd sprawdź jądro i dziennik usług w momencie wystąpienia awarii klienta:

sudo journalctl -k --since "1 hour ago" | grep -Ei 'oom|out of memory|killed process'
sudo journalctl -u matrix-synapse --since "1 hour ago" --no-pager

Poszukaj komunikatu kernel OOM-killer, który nazywa proces Synapse lub Python, statusu systemd, takiego jak oom-kill, lub Python MemoryError. Wskazują one na różne mechanizmy awarii: jądro może zamknąć proces po osiągnięciu granicy pamięci hosta lub kontenera, podczas gdy MemoryErrorw Pythonie może to nastąpić przed zamknięciem procesu OOM w całym systemie. Nazwa usługi różni się w zależności od pakietu; zastąp ją rzeczywistą nazwą jednostki lub kontenera.

Następnie zapisz ciśnienie hosta i największe procesy podczas odtwarzania zwykłej synchronizacji:

free -h
ps -eo pid,rss,%mem,args --sort=-rss | head -n 12
systemctl show matrix-synapse -p MemoryCurrent -p MemoryMax

RSSPamięć rezydentna jest wyrażona w kilobajtach, a nie jest precyzyjną miarą unikalnej pamięci aplikacji; strony współdzielone można liczyć w wielu procesach. W Dockerze należy również sprawdzić docker statsskonfigurowany limit pamięci kontenera. Jeśli host jest współdzielony przez PostgreSQL, Redis i wiele procesów roboczych Synapse, należy ocenić ich łączny rozmiar, zamiast obwiniać wyłącznie główny proces Synapse.

2. Konserwatywnie dostosuj pamięć podręczną

Synapse celowo przechowuje ostatnie zdarzenia i dane dotyczące pomieszczeń w pamięci, aby szybko obsługiwać żądania synchronizacji. Udokumentowana caches.global_factorwartość domyślna to 0.5; zmniejszenie tego współczynnika zazwyczaj zmniejsza pamięć podręczną, ale zwiększa ryzyko większego obciążenia bazy danych. W FAQ administratora Synapse ostrzega się, że zbyt mała pamięć podręczna na powolnej pamięci masowej może powodować opóźnienia w żądaniach, a nawet większe ogólne zużycie pamięci.

Utwórz kopię zapasową aktywnego bloku homeserver.yaml, sprawdź, czy istnieje istniejący caches:blok i zmień tylko istotne wartości. To jest konfiguracja próbna dla instancji wykazującej rosnące wykorzystanie pamięci podręcznej, a nie uniwersalny cel dostrajania:

caches:
  global_factor: 0.3
  sync_response_cache_duration: 1m

Ustawienie pamięci podręcznej odpowiedzi synchronizacji kontroluje, jak długo gotowe /syncwyniki pozostają w pamięci podręcznej; Synapse dokumentuje wartość 2mdomyślną. Krótszy czas oczekiwania może zmniejszyć liczbę przechowywanych odpowiedzi, ale może również zwiększyć obciążenie klientów z przerywanymi połączeniami. Nie dodawaj drugiego caches:klucza, jeśli już istnieje. Jeśli instalacja jest skonfigurowana SYNAPSE_CACHE_FACTORw środowisku usługi lub kontenera, zmienna ta ma pierwszeństwo przed współczynnikiem YAML.

Sprawdź poprawność pliku przy użyciu środowiska Python używanego przez instalację Synapse, dostosowując ścieżkę konfiguracji według potrzeb:

python -m synapse.config -c /etc/matrix-synapse/homeserver.yaml

Ponowne uruchomienie należy wykonać dopiero po walidacji. W przypadku pakietów systemd w stylu Debiana jest to często sudo systemctl restart matrix-synapse; wdrożenia kontenerów korzystają z własnej orkiestracji. Sprawdź dziennik usługi natychmiast po tym, czy nie występują błędy konfiguracji. Dokumentacja konfiguracji Synapse również dokumentuje ponowne ładowanie czynników pamięci podręcznej za pomocą SIGHUP, ale nie oznacza to, że inne ustawienia, w tym retencja odpowiedzi synchronizacji, można ponownie załadować. Kontrolowany restart jest bardziej przejrzysty po zmianie obu tych ustawień.

3. Sprawdź, czy nie kumulują się wolne synchronizacje

Jeśli pamięć nadal rośnie, a klienci pozostają zablokowani, dalsze obniżanie pamięci podręcznej może przynieść odwrotny skutek. Porównaj czas wzrostu RSS z obciążeniem procesora, wejściem/wyjściem dysku i aktywnością bazy danych. Przeciążony host lub wolne zapytania PostgreSQL mogą powodować więcej jednoczesnych żądań w trakcie realizacji, z których każde może zachowywać dane aż do zakończenia.

Najpierw sprawdź, czy baza danych jest responsywna, a przestrzeń dyskowa i wejścia/wyjścia są sprawne. Synapse w wersji produkcyjnej jest przeznaczony dla PostgreSQL, a nie SQLite, jak opisano w dokumentacji konfiguracji Synapse . Jeśli jest to starsza instancja oparta na SQLite, zaplanuj migrację bazy danych z przetestowaną kopią zapasową; nie próbuj wymiany bazy danych na żywo jako awaryjnego obejścia problemu z pamięcią.

Jeśli wcześniej obniżyłeś global_factorwartość do ekstremalnej wartości i opóźnienie synchronizacji się pogorszyło, przywróć wcześniejszy współczynnik lub przetestuj umiarkowanie wyższe ustawienie, obserwując jednocześnie czasy reakcji i całkowitą pamięć. W FAQ administratora Synapse wyraźnie zaznaczono, że większa ilość pamięci podręcznej może pomóc, gdy powolne back-endy powodują kolejki. Nie ma bezpiecznego, stałego celu dotyczącego pamięci RAM, który pasowałby do każdej liczby pomieszczeń, obciążenia federacji i układu wdrożenia.

W przypadku intensywnego wdrożenia wieloprocesowego należy ustalić, czy rośnie główny proces, czy konkretny proces synchronizacji. Procesy robocze umożliwiają dystrybucję ruchu synchronizacji klienta, ale każdy proces wymaga również pamięci, więc dodawanie procesów roboczych bez zwiększenia pojemności może zwiększyć obciążenie hosta spowodowane brakiem zasobów (OOM). Należy postępować zgodnie z dokumentacją procesów roboczych Synapse , zamiast kierować żądania klientów do dowolnych procesów roboczych bez wymaganej konfiguracji współdzielonej.

4. Rozważ automatyczne dostrajanie pamięci podręcznej tylko wtedy, gdy spełnione są wymagania wstępne

W systemie, w którym odpowiednia konfiguracja jemalloc jest już obsługiwana i zweryfikowana, Synapse udostępnia cache_autotuning. Wymaga wszystkich trzech udokumentowanych wartości max_cache_memory_usage— , target_cache_memory_usagei min_cache_ttl— i wykorzystuje usuwanie pamięci podręcznej, aby utrzymać użycie pamięci podręcznej wokół celu. Poniższe rysunki mają charakter poglądowy i muszą być skalowane tak, aby pozostawić miejsce dla Pythona, bazy danych, innych usług i serii aktywnych żądań:

caches:
  cache_autotuning:
    max_cache_memory_usage: 512M
    target_cache_memory_usage: 384M
    min_cache_ttl: 5m

Połącz ten blok z istniejącymi ustawieniami pamięci podręcznej zamiast je zastępować. Te wartości to budżety pamięci podręcznej, a nie limity RSS procesu ; ich użycie nie gwarantuje, że proces utrzyma się poniżej 512 MiB. Dokumentacja konfiguracji Synapse wymaga użycia jemalloc dla tej funkcji, a w FAQ administratora Synapse ostrzega się, że alokator Pythona może zakłócać rozliczanie jemalloc, potencjalnie wymagając PYTHONMALLOC=malloc… Ponieważ ścieżki wstępnego ładowania i pakietowania alokatora różnią się, przed zmianą należy sprawdzić rzeczywistą bibliotekę i środowisko startowe wdrożenia LD_PRELOAD. Nie kopiuj bezmyślnie ścieżki biblioteki specyficznej dla architektury.

5. Sprawdź, czy synchronizacja jest stabilna

Po każdej pojedynczej zmianie wykonaj tę samą realistyczną czynność klienta, która poprzednio wywołała awarię: ponownie podłącz istniejącego klienta, zezwól na początkową synchronizację, jeśli to możliwe, i odczekaj kilka normalnych, przyrostowych synchronizacji. Zapisz szczytowy RSS wszystkich procesów Synapse, aktywność wymiany, responsywność bazy danych oraz to, czy jądro rejestruje kolejne zdarzenie OOM. Krótki spadek zaraz po restarcie nie świadczy o trwałym rozwiązaniu; pamięć podręczna naturalnie zaczyna działać w stanie zimnym.

Jeśli monitorowanie jest włączone, porównaj pamięć procesu i zachowanie żądań w czasie, korzystając z punktu końcowego metryk Synapse. Dokumentacja monitorowania Synapse wyjaśnia, że ​​procesy robocze udostępniają metryki niezależnie i muszą być monitorowane oddzielnie; należy zachować prywatne lub chronione punkty końcowe metryk zamiast publikować dane wewnętrzne w sposób otwarty.

Zmiana zadziałała, jeśli klienci ukończą synchronizację bez wielokrotnych ponownych połączeń, logi nie wykażą żadnych nowych „zabić” pamięci, a pamięć ustabilizuje się na stabilnym poziomie przy tym samym obciążeniu. Jeśli problemy z pamięcią operacyjną (OOM) utrzymują się pomimo prawidłowego opóźnienia synchronizacji i starannie dostrojonych pamięci podręcznych, kolejnym praktycznym krokiem jest zwiększenie dostępnej pamięci RAM lub zmniejszenie obciążenia na hosta, wykorzystując zmierzone zużycie szczytowe, a nie arbitralnie zalecany rozmiar serwera.

Zostaw komentarz

Rozwiąż błędy uprawnień administratora pokoju Matrix za pomocą działania

Prześledź M_FORBIDDEN do poziomów mocy pokoju, członkostwa lub dostępu administratora serwera Synapse, a następnie przywróć tylko uprawnienia potrzebne do zablokowanej akcji.

Uczyń swój serwer Matrix Synapse dostępnym dla federacji

Uczyń swój serwer Matrix Synapse dostępnym dla federacji

Skonfiguruj wykrywanie Synapse, protokół HTTPS i routing proxy, aby inne serwery domowe Matrix mogły znaleźć Twój serwer i nawiązać z nim kontakt.

Połącz Element Web z Keycloak przez Synapse OIDC

Skonfiguruj klienta Keycloak OIDC i dostawcę Synapse, aby użytkownicy Element Web mogli logować się za pośrednictwem serwera tożsamości bez ujawniania tajnych danych klienta.

Bezpieczna konfiguracja kopii zapasowej klucza elementu i podpisywania krzyżowego

Bezpieczna konfiguracja kopii zapasowej klucza elementu i podpisywania krzyżowego

Zapisz klucz odzyskiwania, zweryfikuj sesje Element i sprawdź, czy zaszyfrowane klucze wiadomości można odzyskać, nie myląc kopii zapasowej z hasłem do konta.

Zatrzymaj awarię pamięci Matrix Synapse podczas synchronizacji klienta

Diagnozuj błędy braku pamięci w Synapse podczas synchronizacji, bezpiecznie dostosowuj buforowanie, identyfikuj zaległości w żądaniach i weryfikuj stabilne wykorzystanie pamięci.

Rozwiązywanie błędów certyfikatu TLS federacji Synapse

Śledź błędy certyfikatu federacji Matrix na właściwym serwerze, napraw łańcuch TLS lub zaufanie urzędu certyfikacji i zweryfikuj poprawkę bez wyłączania kontroli bezpieczeństwa.

Bezpiecznie umieść serwer Synapse Matrix za Cloudflare

Bezpiecznie umieść serwer Synapse Matrix za Cloudflare

Klienci i federacja Matrix korzystają z usługi Cloudflare na protokole HTTPS 443, zachowując wykrywanie Synapse i unikając buforowania ruchu API lub przerywania przesyłania multimediów.

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.