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

Jeśli repozytorium multimediów Synapse zapełnia dysk, najpierw sprawdź, który katalog lub wolumin się powiększa, a następnie skorzystaj z obsługiwanych przez Synapse ustawień przechowywania lub interfejsu API administratora, aby usunąć multimedia. Nie usuwaj plików bezpośrednio z media_store: Synapse przechowuje metadane multimediów w swojej bazie danych, a usuwanie plików za Synapse może pozostawić uszkodzone odniesienia lub utrudnić audyt czyszczenia. Najbezpieczniejsza strategia zależy od tego, czy przestrzeń jest wykorzystywana przez lokalne pliki do przesłania, buforowane multimedia z innych serwerów domowych, miniatury, czy inną usługę współdzielącą ten sam dysk.

Co zajmuje przestrzeń?

Repozytorium multimediów Synapse przechowuje lokalnie przesłane awatary, załączniki i miniatury. Przechowuje również w pamięci podręcznej media pobrane ze zdalnych serwerów Matrix oraz zasoby używane do podglądu adresów URL. Są one niezależne od bazy danych Synapse, logów kontenerów i dowolnego zewnętrznego repozytorium multimediów. Sam pełny system plików root nie dowodzi, że to media_storejest przyczyną problemu.

Na hoście lub w kontenerze, do którego należą zamontowane dane, porównaj użycie systemu plików z katalogiem danych Synapse. Zastąp przykładową ścieżkę wartością ze swojego wdrożenia:

df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store

Domyślnie w Synapse media_store_pathznajduje się media_store, zazwyczaj w katalogu danych, ale instalacje mogą to zmienić. Kontenery mogą zapisywać na zamontowanym woluminie, którego rzeczywista pamięć masowa znajduje się na hoście. Sprawdź homeserver.yaml, mapowania woluminów kontenera lub konfigurację woluminów trwałych w programie Orchestrator, zanim stwierdzisz, że ścieżka hosta jest bezpieczna do zmiany. Jeśli katalog multimediów nie jest największym odbiorcą, sprawdź komponent, który dujest wyświetlany zamiast niego.

Wybierz politykę czyszczenia dostosowaną do nośnika

Zweryfikowane działanie: Ustawienie Synapse media_retentionmoże powodować wygaśnięcie lokalnych i zdalnych multimediów w pamięci podręcznej po okresach braku dostępu. Dostęp obejmuje ładowanie multimediów w pokoju lub ich pobieranie. Jeśli do elementu nigdy nie uzyskano dostępu, Synapse bierze pod uwagę czas jego utworzenia. Zarówno oryginalne media, jak i ich miniatury są usuwane. Czyszczenie jest uruchamiane przez proces roboczy repozytorium multimediów, który może być głównym procesem Synapse.

Zależy to od Twojego przypadku użycia: Zdalne pliki w pamięci podręcznej można zazwyczaj ponownie pobrać z ich serwera macierzystego na żądanie po usunięciu. Pliki przesłane lokalnie są hostowane na Twoim serwerze, więc ich usunięcie może spowodować, że stare załączniki lub awatary staną się niedostępne. Wybierz lokalne przechowywanie tylko wtedy, gdy użytkownicy akceptują taką konsekwencję; dłuższy lokalny czas przechowywania lub brak automatycznego lokalnego czyszczenia może być bardziej odpowiedni dla społeczności, która traktuje stare załączniki jako archiwum.

Czego nie oznacza retencja: poddanie multimediów kwarantannie blokuje dostęp, ale nie usuwa pliku ani jego miniatur. Nie zwalnia też potrzebnego miejsca na dysku. Jeśli chcesz zachować element poddany kwarantannie, usuwając jednocześnie inne dane, należy jasno to rozróżnić: kwarantanna jest funkcją moderacji, a retencja i usuwanie – funkcją przechowywania.

Włącz automatyczne przechowywanie w Synapse

Przed edycją wykonaj kopię zapasową aktywnej konfiguracji. Dodaj sekcję najwyższego poziomu media_retentionlub zaktualizuj istniejącą. Na przykład ta zasada wygasa po 180 dniach bez dostępu do nośników lokalnych, a po 30 dniach – do wpisów w pamięci podręcznej zdalnej:

media_retention:
  local_media_lifetime: 180d
  remote_media_lifetime: 30d

Te wartości są przykładami, a nie uniwersalnymi zaleceniami. Ustaw okres lokalny zgodnie z Twoimi obowiązkami dotyczącymi przechowywania i oczekiwaniami dotyczącymi zawartości starego pokoju. Jeśli chcesz kontrolować pamięć podręczną tylko dla nośników zdalnych, skonfiguruj tylko remote_media_lifetime; nieustawiony lub zerowy okres istnienia oznacza, że ​​typ nie zostanie automatycznie usunięty. Synapse dokumentuje również, że nośniki poddane kwarantannie i nośniki lokalne chronione przed kwarantanną są wyłączone z czyszczenia pamięci podręcznej.

Zastosuj konfigurację, korzystając ze standardowego procesu ponownego uruchomienia lub ponownego załadowania wdrożenia, i sprawdź, czy proces roboczy repozytorium multimediów działa z enable_media_repo: true. Jeśli Synapse używa oddzielnego procesu roboczego multimediów, skonfiguruj zasady, w których usługa repozytorium multimediów jest włączona. Prawidłowa edycja pliku YAML nie powoduje natychmiastowego odzyskania całej przestrzeni: proces roboczy musi uruchomić czyszczenie, a kwalifikują się tylko nośniki starsze niż wybrany limit dostępu.

Odzyskaj przestrzeń szybciej dzięki interfejsowi API administratora

Jeśli dysk jest już krytyczny, Synapse udostępnia administracyjne punkty końcowe do czyszczenia. Te działania trwale usuwają nośniki. Przed ich użyciem należy wykonać kopię zapasową bazy danych i danych z nośników, upewnić się, że adres URL wskazuje na Twój serwer domowy i użyć tokena dostępu administratora serwera przez HTTPS. Token nie powinien być przechowywany w historii powłoki ani w dziennikach współdzielonych.

Aby usunąć stare, buforowane zdalne media, wywołaj udokumentowany punkt końcowy z datą odcięcia w milisekundach od epoki Unix:

POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>

Na przykład powłoka może obliczyć datę odcięcia 30 dni temu za pomocą GNU date:

cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
  -H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"

Odpowiedź informuje o liczbie usuniętych elementów z pamięci podręcznej. Jeśli użytkownicy ponownie zażądają tych plików zdalnych, Synapse ponownie je pobierze z serwera źródłowego; może to przywrócić wykorzystanie dysku dla popularnych multimediów.

Interfejs API usuwania lokalnych nośników może usuwać nośniki lokalne na podstawie czasu ostatniego dostępu i, opcjonalnie, minimalnego rozmiaru. Jego obecny punkt końcowy to POST /_synapse/admin/v1/media/delete?before_ts=…; starszy punkt końcowy zawierający tę opcję <server_name>jest przestarzały od wersji Synapse 1.78.0. Punktem odcięcia jest data ostatniego dostępu, a nie data przesłania, a keep_profilesopcja ma wartość domyślną true. Ponieważ to usunięcie może spowodować usunięcie plików, które użytkownicy oczekują, że pozostaną dostępne, preferuj skonfigurowane przechowywanie, chyba że zidentyfikowano odpowiedni punkt odcięcia i zaakceptowano efekt. Postępuj zgodnie z oficjalnym dokumentem API dotyczącym parametrów i zainstalowanej wersji Synapse.

Typowe błędne przekonania, których należy unikać

  • „Usunięcie pokoju spowoduje wyczyszczenie jego multimediów”. Nie zakładaj tego. Historia pokoju, pliki multimedialne i kopie w pamięci podręcznej są zarządzane za pomocą różnych operacji. Użyj interfejsu API administratora multimediów lub zasad przechowywania, aby zarządzać konkretnymi multimediami.
  • „Kwarantanna zwalnia miejsce na dysku”. Tak jednak nie jest: poddane kwarantannie multimedia i miniatury pozostają na dysku. Użyj operacji usuwania lub przechowywania, gdy celem jest odzyskanie pamięci.
  • „Wszystkie multimedia w repozytorium to pliki przesłane przez moich użytkowników”. Repozytorium zawiera również dane z pamięci podręcznej i podglądu adresów URL. Przed wybraniem opcji czyszczenia porównaj podkatalogi repozytorium z konfiguracją pamięci masowej Synapse.
  • „Ręczne usuwanie plików jest równoważne z czyszczeniem w Synapse”. Nie jest to obsługiwany zamiennik. Pozwól Synapse aktualizować swoje metadane poprzez proces przechowywania lub interfejs API administratora.

Sprawdź, czy użycie dysku spada

Po uruchomieniu procesu czyszczenia sprawdź df -hponownie rozmiar katalogu nośników. W przypadku czyszczenia API, potwierdź liczbę usuniętych plików z odpowiedzi i porównaj odpowiedni katalog przed i po. Sprawdź dzienniki Synapse pod kątem błędów konfiguracji lub procesu roboczego. Jeśli katalog nadal jest duży, sprawdź, czy wdrożenie zapisuje nośniki do skonfigurowanego dostawcy, czy do osobnego woluminu; lokalne API usuwania nośników Synapse nie ma wpływu na nośniki przechowywane w zewnętrznym repozytorium nośników. Nie zakładaj, że pomyślna odpowiedź API zmniejszy rozmiar systemu plików hosta, jeśli pliki znajdują się gdzie indziej.

Oficjalne źródła

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.