Oczyść stare wiadomości i media Synapse bez utraty danych

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.

Wybierz czyszczenie odpowiadające Twojemu celowi

Co zajmuje miejsce?UżyjWażne ograniczenie
Stare wiadomości i inne wydarzenia w pokojuInterfejs API administratora funkcji czyszczenia historii lub automatyczne przechowywanie wiadomościCzyszczenie 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 domowymUsuń API lokalnych mediów lub lokalne przechowywanie multimediówMedia używane w profilach i awatarach pokoi są domyślnie chronione przez punkt końcowy daty/rozmiaru.
Media buforowane z innych serwerów domowychOczyść interfejs API zdalnych multimediów lub zdalne przechowywanie multimediówJeś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.

Przygotuj się przed oczyszczeniem

  1. Sprawdź, która instancja Synapse obsługuje media. W przypadku wdrożenia procesu roboczego czyszczenie mediów jest uruchamiane na serwerze roboczym z parametrem 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ę.
  2. Utwórz kopię zapasową bazy danych i magazynu multimediów. Przed nieodwracalnym czyszczeniem wykonaj aktualną kopię zapasową, którą można przywrócić. Zapisz identyfikator pokoju i godzinę graniczną oraz użyj tokena dostępu administratora serwera. Nie wklejaj tokena do historii współdzielonej powłoki ani nie publikuj go w logach.
  3. Starannie zaplanuj punkt odcięcia. Punkty końcowe czyszczenia akceptują znaczniki czasu w milisekundach systemu Unix. Użyj punktu odcięcia opartego na UTC i zweryfikuj liczbę przed wysłaniem żądania. Punkt odcięcia nie jest podglądem: może trwale usunąć kwalifikujące się dane.

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.

Usuń starą historię wiadomości z jednego pokoju

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.

Usuń stare media i buforowane pliki zdalne

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.

Ustaw cykliczne przechowywanie zamiast powtarzania ręcznych czyszczeń

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.

Sprawdź, czy pamięć masowa została odzyskana

  • Sprawdzaj stan czyszczenia historii, aż wyświetli się komunikat complete; zachowaj identyfikator czyszczenia i odpowiedź w dzienniku konserwacji.
  • Sprawdź lokalne nośniki i zdalne odpowiedzi pamięci podręcznej pod kątem liczby usuniętych elementów, a następnie po czyszczeniu przejrzyj dzienniki Synapse i informacje o wykorzystaniu systemu plików.
  • Nie zakładaj, że mniejsza liczba wierszy w bazie danych oznacza od razu mniejszy plik bazy danych. Dokumentacja Synapse zaznacza, że ​​PostgreSQL może ponownie wykorzystać zwolnioną przestrzeń bez zwracania jej do systemu operacyjnego. W przypadku PostgreSQL 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ą.
  • Przed zamknięciem zadania konserwacyjnego sprawdź, czy oczekiwane pliki lub starsze zdarzenia nie są już obsługiwane i sprawdź, czy kopia zapasowa jest nadal dostępna.

Zostaw komentarz

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.

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

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.

Oczyść stare wiadomości i media Synapse bez utraty danych

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.

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.

Odzyskaj miejsce na dysku Synapse Media bez naruszania współdzielonych plików

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.

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Przejrzyj aktywność urządzenia, dezaktywuj potwierdzone nieaktywne konta Synapse za pomocą interfejsu API administratora i dowiedz się, co tak naprawdę usuwa opcjonalna flaga usuwania.

Zmniejsz obciążenie pamięci PostgreSQL w Matrix Synapse

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.

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

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

Zamknij rejestrację w Matrix lub wymagaj tokenów zaproszeń w 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.