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.
Aby bezpiecznie usunąć stare dane Matrix Synapse, należy traktować historię pokoju i nośniki jako oddzielne zadania. Użyj interfejsu API Purge History Admin dla starych zdarzeń pokoju, interfejsu API usuwania nośników dla nośników lokalnych oraz interfejsu API zdalnej pamięci podręcznej nośników dla plików pobranych z innych serwerów domowych. W przypadku cyklicznego czyszczenia skonfiguruj zasady przechowywania wiadomości i nośników. Czyszczenie wierszy bazy danych nie zawsze powoduje natychmiastowe zmniejszenie rozmiaru pliku bazy danych na dysku.
| Co zajmuje miejsce? | Użyj | Ważne ograniczenie |
|---|---|---|
| Stare wiadomości i inne wydarzenia w pokoju | Interfejs API administratora funkcji czyszczenia historii lub automatyczne przechowywanie wiadomości | Czyszczenie historii jest specyficzne dla danego pokoju. Stan pokoju jest zachowywany; Synapse przechowuje co najmniej jedną wiadomość w każdym pokoju. |
| Media przechowywane na Twoim serwerze domowym | Usuń API lokalnych mediów lub lokalne przechowywanie multimediów | Media używane w profilach i awatarach pokoi są domyślnie chronione przez punkt końcowy daty/rozmiaru. |
| Media buforowane z innych serwerów domowych | Oczyść interfejs API zdalnych multimediów lub zdalne przechowywanie multimediów | Jeśli żądanie zostanie wysłane ponownie, Synapse pobierze je ponownie z serwera źródłowego. |
Te ustawienia wpływają na bazę danych i repozytorium multimediów Synapse. Jeśli korzystasz z zewnętrznego repozytorium multimediów, takiego jak Matrix Media Repository, lokalny punkt końcowy usuwania multimediów Synapse nie usuwa plików tam przechowywanych. Przed usunięciem danych sprawdź dokumentację i zasady tworzenia kopii zapasowych danego repozytorium.
enable_media_repo: true; może to być proces główny. Przed zdiagnozowaniem problemu z czyszczeniem, który wydaje się nie działać, sprawdź routing i konfigurację.W poniższych przykładach zastąp je https://matrix.example.comadresem URL bazowym serwera domowego skierowanym do klienta, ustaw prawidłowy identyfikator pokoju i wyeksportuj token administratora w formacie ADMIN_TOKEN. Zachowaj token nośnika w tajemnicy.
Interfejs API „Purge History” usuwa z bazy danych Synapse zdarzenia starsze niż określony punkt. Nie redaguje on wiadomości dla innych serwerów i nie jest tym samym, co usuwanie pokoju. Domyślnie Synapse usuwa zdarzenia wysłane przez użytkowników zdalnych, ale zachowuje zdarzenia użytkowników lokalnych; opcja ta jest ustawiona delete_local_eventstylko truewtedy, gdy zamierzasz je również usunąć. Stan pokoju, taki jak członkostwo i temat, jest zachowywany.
Na przykład, aby ustawić granicę 180 dni przed bieżącym czasem na hoście Linux, oblicz znacznik czasu w milisekundach, sprawdź go, a następnie prześlij prośbę o pojedynczy pokój:
export SYNAPSE_URL='https://matrix.example.com'
export ROOM_ID='!roomid:example.com'
export ADMIN_TOKEN='replace-with-a-server-admin-token'
PURGE_BEFORE_MS=$(python3 -c 'import time; print(int((time.time() - 180*86400) * 1000))')
printf 'Cutoff (Unix milliseconds): %s\n' "$PURGE_BEFORE_MS"
curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_history/$ROOM_ID" \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'Content-Type: application/json' \
-d "{\"purge_up_to_ts\":$PURGE_BEFORE_MS,\"delete_local_events\":true}"
Pomiń delete_local_eventslub ustaw na , falsejeśli chcesz zachować domyślne zachowanie Synapse. Jeśli API zwróci purge_id, czyszczenie zostało rozpoczęte; niekoniecznie zostało zakończone. Odpytuj punkt końcowy stanu, aż zgłosi completelub sprawdź, errorczy jego stan to failed:
curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
-H "Authorization: Bearer $ADMIN_TOKEN"
Duże czyszczenia mogą trwać kilka minut lub dłużej. Podczas operacji użytkownicy mogą nie być w stanie cofnąć się w czasie od momentu czyszczenia. Synapse przechowuje co najmniej jedną wiadomość w pokoju, więc to API nie spowoduje całkowitego opróżnienia osi czasu pokoju.
Aby jednorazowo wyczyścić ostatnio używane lokalne media przed odcięciem, użyj bieżącego lokalnego punktu końcowego multimediów. Jest to before_tsznacznik czasu systemu Unix w milisekundach, który może również akceptować size_gtpliki o rozmiarze przekraczającym próg bajtów. Domyślnie media są nadal używane do obrazów profilowych lub awatarów pomieszczeń; nie ustawiaj tego ustawienia, keep_profiles=falsechyba że celowo chcesz usunąć te pliki.
curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/media/delete?before_ts=$PURGE_BEFORE_MS" \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'Content-Type: application/json' \
-d '{}'
Przejrzyj identyfikatory odpowiedzi totali usuniętych multimediów. Punkt końcowy usuwa lokalne oryginały i miniatury. Unikaj starszej ścieżki zawierającej /media/<server_name>/delete; dokumentacja Synapse oznacza tę ścieżkę jako przestarzałą od wersji 1.78.0. Obecny lokalny punkt końcowy multimediów nie działa w oddzielnym, zewnętrznym repozytorium multimediów.
Zdalne media w pamięci podręcznej to osobna kategoria. Aby usunąć z pamięci podręcznej media zdalne, do których ostatnio uzyskano dostęp przed tym samym momentem odcięcia, użyj:
curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_media_cache?before_ts=$PURGE_BEFORE_MS" \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'Content-Type: application/json' \
-d '{}'
Odpowiedź informuje o liczbie usuniętych elementów z pamięci podręcznej. Jeśli użytkownicy zażądają tych plików później, Synapse może je ponownie pobrać z serwera źródłowego, więc operacja ta zamienia użycie dysku lokalnego na ewentualny ruch sieciowy i opóźnienie pobierania.
Przechowywanie wiadomości w Synapse jest domyślnie wyłączone. Aby wymusić domyślne zachowanie na całym serwerze dla pokoi bez własnego stanu przechowywania, dodaj zasadę do konfiguracji i włącz ją. W tym przykładzie ustawiono maksymalny okres jednego roku:
retention:
enabled: true
default_policy:
max_lifetime: 1y
Użyj jednostek czasu trwania obsługiwanych przez Synapse, takich jak ddni i ylata. Administratorzy i moderatorzy pokoi mogą również ustawiać m.room.retentionzdarzenia stanu pokoju, a administratorzy serwerów mogą ograniczyć dozwolony maksymalny czas życia za pomocą allowed_lifetime_mini allowed_lifetime_max. Przed włączeniem zapoznaj się z pełną polityką: kwalifikujące się zdarzenia są trwale usuwane przez zadania czyszczenia w tle. Synapse ukrywa wygasłe zdarzenia przed klientami zaraz po ich wygaśnięciu, ale czyszczenie bazy danych jest przeprowadzane okresowo, dzięki czemu wiersze mogą pozostać do momentu uruchomienia zadania. Zdarzenia stanu nie są objęte funkcją przechowywania wiadomości.
W przypadku multimediów dodaj media_retentionokresy życia, na przykład:
media_retention:
local_media_lifetime: 90d
remote_media_lifetime: 14d
Te okresy życia to okresy bezczynności, a nie po prostu limit wieku przesyłania: gdy plik został otwarty, Synapse bierze pod uwagę jego ostatni dostęp; w przypadku multimediów, do których nigdy nie uzyskano dostępu, bierze pod uwagę czas ich utworzenia. Oryginalne pliki i miniatury są usuwane. Media poddane kwarantannie i lokalne media chronione przed kwarantanną nie są usuwane podczas tego czyszczenia. Skonfiguruj przechowywanie multimediów w procesie hostującym repozytorium multimediów, a następnie sprawdź poprawność ustawienia w instrukcji konfiguracji dla uruchomionej wersji Synapse.
Przed zastosowaniem zmian należy zapoznać się z oficjalną dokumentacją interfejsu API Purge History , interfejsu API Media Admin , podręcznikiem konfiguracji Synapse oraz dokumentacją zasad przechowywania wiadomości . Opisane tutaj zachowanie interfejsu API odzwierciedla oficjalną dokumentację sprawdzoną 10 października 2026 r.; należy sprawdzić punkty końcowe i konfigurację pod kątem zainstalowanej wersji.
complete; zachowaj identyfikator czyszczenia i odpowiedź w dzienniku konserwacji.VACUUM FULLmożliwe jest odzyskanie przestrzeni dyskowej, ale wymaga to blokady na wyłączność; zaplanuj to z uwzględnieniem przestoju/wpływu na działanie systemu i postępuj zgodnie z dokumentacją PostgreSQL VACUUM . W przypadku SQLite, dokumentacja Synapse dotycząca retencji danych identyfikuje VACUUMtę operację jako odpowiednią.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.
Sprawdź, czy błąd dotyczy jednej przeglądarki lub jednego zdarzenia, a następnie użyj klucza odzyskiwania Element lub zaufanego urządzenia, nie ryzykując utraty zaszyfrowanej historii.
Użyj interfejsów API Synapse do czyszczenia historii i multimediów lub ustawień przechowywania, aby bezpiecznie usunąć nieaktualne dane, a następnie zweryfikuj ukończenie operacji i odzyskanie miejsca na dysku.
Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.
Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.
Znajdź elementy zapełniające pamięć masową Synapse, ustaw bezpieczne przechowywanie multimediów i wyczyść zdalną pamięć podręczną bez konieczności usuwania plików bezpośrednio z dysku.
Przejrzyj aktywność urządzenia, dezaktywuj potwierdzone nieaktywne konta Synapse za pomocą interfejsu API administratora i dowiedz się, co tak naprawdę usuwa opcjonalna flaga usuwania.
Sprawdź, czy pamięć PostgreSQL pochodzi z obsługi zapytań, współdzielonych buforów, połączeń czy konserwacji, a następnie wprowadź ukierunkowane zmiany bezpieczne dla Synapse.
Śledź powolne dołączanie pokoju Matrix do jednego zdalnego serwera domowego, wycofywanie federacji, obciążenie lokalnej bazy danych lub kolejkę nadawcy wychodzącego przed zmianą ustawień Synapse.
Zatrzymaj możliwość tworzenia otwartych kont na samodzielnie hostowanym serwerze Synapse lub zachowaj możliwość rejestracji wyłącznie na zaproszenia, korzystając z tokenów rejestracyjnych o ograniczonym zastosowaniu.