Synapse Media-Speicherplatz freigeben, ohne freigegebene Dateien zu beschädigen

Wenn der Medienspeicher von Synapse die Festplatte füllt, prüfen Sie zunächst, welches Verzeichnis oder Volume betroffen ist. Entfernen Sie anschließend Mediendateien mithilfe der von Synapse unterstützten Aufbewahrungseinstellungen oder der Admin-API. Löschen Sie keine Dateien direkt media_store: Synapse speichert Metadaten in seiner Datenbank. Das Entfernen von Dateien außerhalb des Synapse-Speichers kann zu fehlerhaften Referenzen führen oder die Überprüfung der Bereinigung erschweren. Die sicherste Vorgehensweise hängt davon ab, ob der Speicherplatz für lokale Uploads, zwischengespeicherte Medien von anderen Homeservern, Miniaturansichten oder andere Dienste genutzt wird, die dieselbe Festplatte verwenden.

Was nimmt den Platz ein?

Synapses Medienspeicher speichert lokal hochgeladene Avatare, Anhänge und Miniaturansichten. Er speichert außerdem Medien, die von entfernten Matrix-Servern abgerufen werden, sowie Ressourcen für URL-Vorschauen im Cache. Diese Speicher sind von der Synapse-Datenbank, Containerprotokollen und externen Medienspeichern getrennt. Ein vollständig gefülltes Root-Dateisystem beweist allein nicht, dass dies media_storedie Ursache ist.

Vergleichen Sie auf dem Host oder innerhalb des Containers, dem die eingebundenen Daten gehören, die Dateisystemnutzung mit dem Synapse-Datenverzeichnis. Ersetzen Sie den Beispielpfad durch den Wert in Ihrer Bereitstellung:

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

Synapse media_store_pathverwendet media_storestandardmäßig das Datenverzeichnis, kann dies aber in der Installation überschreiben. Container können auf ein eingebundenes Volume schreiben, dessen tatsächlicher Speicher sich auf dem Host befindet. Überprüfen Sie homeserver.yamldie Container-Volume-Zuordnungen oder die Konfiguration des persistenten Volumes Ihres Orchestrators, bevor Sie davon ausgehen, dass ein Hostpfad sicher geändert werden kann. Wenn das Medienverzeichnis nicht den größten Speicherplatz belegt, untersuchen Sie dustattdessen die Komponente, die den größten Speicherplatz belegt.

Wählen Sie eine Bereinigungsrichtlinie, die zu den Medien passt.

Bestätigtes Verhalten: Synapse media_retentionkann lokale und zwischengespeicherte Remote-Medien nach einer gewissen Zeit ohne Zugriff löschen. Zugriff bedeutet das Laden oder Herunterladen von Medien in einem Raum. Wurde ein Element noch nie aufgerufen, verwendet Synapse dessen Erstellungsdatum. Sowohl die Originalmedien als auch deren Miniaturansichten werden entfernt. Die Bereinigung erfolgt im Medien-Repository-Worker, der der Hauptprozess von Synapse sein kann.

Das hängt von Ihrem Anwendungsfall ab: Remote zwischengespeicherte Dateien können nach dem Löschen in der Regel vom ursprünglichen Server wiederhergestellt werden. Lokal hochgeladene Dateien werden auf Ihrem Server gespeichert, daher kann deren Löschung dazu führen, dass alte Anhänge oder Avatare nicht mehr verfügbar sind. Wählen Sie die lokale Aufbewahrung nur, wenn Ihre Benutzer diese Konsequenz akzeptieren. Eine längere lokale Speicherdauer oder der Verzicht auf die automatische lokale Bereinigung kann für eine Community, die alte Anhänge als Archiv betrachtet, besser geeignet sein.

Was Aufbewahrung nicht bedeutet: Das Quarantänen von Mediendateien blockiert den Zugriff, löscht aber weder die Datei noch deren Miniaturansichten. Dadurch wird kein Speicherplatz freigegeben. Wenn Sie ein unter Quarantäne gestelltes Element behalten müssen, während Sie andere Daten löschen, beachten Sie den Unterschied: Quarantäne ist eine Moderationsmaßnahme, während Aufbewahrung und Löschung Speicherkontrollen sind.

Automatische Aufbewahrung in Synapse aktivieren

Sichern Sie die aktive Konfiguration, bevor Sie sie bearbeiten. Fügen Sie einen media_retentionAbschnitt der obersten Ebene hinzu oder aktualisieren Sie den vorhandenen. Diese Richtlinie beispielsweise lässt lokale Medien nach 180 Tagen ohne Zugriff und Remote-Cache-Einträge nach 30 Tagen ablaufen:

media_retention:
  local_media_lifetime: 180d
  remote_media_lifetime: 30d

Diese Werte sind Beispiele, keine allgemeingültigen Empfehlungen. Legen Sie die lokale Aufbewahrungsdauer entsprechend Ihren Aufbewahrungspflichten und Erwartungen an ältere Rauminhalte fest. Wenn Sie nur den Cache für Remote-Medien steuern möchten, konfigurieren Sie lediglich die entsprechende remote_media_lifetimeEinstellung. Eine nicht festgelegte oder leere Lebensdauer bedeutet, dass dieser Typ nicht automatisch gelöscht wird. Synapse dokumentiert außerdem, dass unter Quarantäne gestellte Medien und lokale Medien, die vor Quarantäne geschützt sind, von der Bereinigung der Aufbewahrungsdauer ausgeschlossen sind.

Wenden Sie die Konfiguration mithilfe des normalen Neustart- oder Neuladeprozesses der Bereitstellung an und überprüfen Sie, ob der Medien-Repository-Worker ausgeführt wird enable_media_repo: true. Falls Synapse einen separaten Medien-Worker verwendet, konfigurieren Sie die Richtlinie, in der der Medien-Repository-Dienst aktiviert ist. Eine gültige YAML-Änderung gibt nicht sofort den gesamten Speicherplatz frei: Der Worker muss eine Bereinigung durchführen, und nur Medien, die älter als der gewählte Zugriffsgrenzwert sind, werden berücksichtigt.

Schneller Speicherplatz freigeben mit der Admin-API

Wenn die Festplatte bereits kritisch ist, bietet Synapse administrative Endpunkte zur Bereinigung. Diese Aktionen löschen die Mediendateien endgültig. Sichern Sie vor der Verwendung die Datenbank- und Mediendaten, vergewissern Sie sich, dass die URL auf Ihren eigenen Heimserver verweist, und verwenden Sie ein Serveradministrator-Zugriffstoken über HTTPS. Speichern Sie das Token nicht im Shell-Verlauf oder in freigegebenen Protokollen.

Um alte zwischengespeicherte Remote-Medien zu löschen, rufen Sie den dokumentierten Endpunkt mit einem Stichtag in Millisekunden seit der Unix-Epoche auf:

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

Eine Shell kann beispielsweise mit GNU einen Stichtag vor 30 Tagen berechnen 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"

Die Antwort gibt an, wie viele zwischengespeicherte Elemente gelöscht wurden. Wenn Benutzer diese Dateien erneut anfordern, lädt Synapse sie erneut vom Ursprungsserver herunter; dadurch kann die Festplattennutzung für häufig genutzte Mediendateien reduziert werden.

Die API zum Löschen lokaler Medien kann lokale Medien basierend auf dem letzten Zugriffszeitpunkt und optional einer Mindestgröße löschen. Der aktuelle Endpunkt lautet [Endpunkt POST /_synapse/admin/v1/media/delete?before_ts=…einfügen]; der ältere Endpunkt mit [Endpunkt einfügen] <server_name>ist seit Synapse 1.78.0 veraltet. Der Stichtag ist der letzte Zugriff, nicht das Upload-Datum, und die keep_profilesOption ist standardmäßig aktiviert. Da durch diese Löschung Dateien entfernt werden können, die Benutzer weiterhin erwarten, sollten Sie die konfigurierte Aufbewahrungsdauer bevorzugen, es sei denn, Sie haben einen geeigneten Stichtag festgelegt und akzeptieren die Auswirkungen. Beachten Sie die offizielle API-Referenz für Parameter und Ihre installierte Synapse-Version.

Häufige Irrtümer, die es zu vermeiden gilt

  • „Das Löschen eines Raums löscht automatisch alle zugehörigen Mediendateien.“ Das stimmt nicht. Raumverlauf, Mediendateien und zwischengespeicherte Kopien werden über verschiedene Vorgänge verwaltet. Verwenden Sie die Media Admin API oder die Aufbewahrungsrichtlinie, um Mediendateien gezielt zu verwalten.
  • „Quarantäne gibt Speicherplatz frei.“ Das stimmt nicht: Unter Quarantäne gestellte Medien und Miniaturansichten bleiben auf der Festplatte. Verwenden Sie eine Lösch- oder Aufbewahrungsoperation, wenn Speicherplatz freigegeben werden soll.
  • „Alle Mediendateien im Repository wurden von meinen Nutzern hochgeladen.“ Das Repository enthält außerdem Daten aus dem Remote-Cache und der URL-Vorschau. Vergleichen Sie die Unterverzeichnisse des Repositorys mit der Speicherkonfiguration von Synapse, bevor Sie eine Löschung durchführen.
  • Das manuelle Löschen von Dateien entspricht der Synapse-Bereinigung, ist aber kein unterstützter Ersatz. Lassen Sie Synapse die Metadaten über den Aufbewahrungsprozess oder die Admin-API aktualisieren.

Überprüfen Sie, ob die Festplattennutzung sinkt.

Nachdem der Bereinigungsprozess abgeschlossen ist, überprüfen Sie df -herneut die Größe des Medienverzeichnisses. Bestätigen Sie bei einer API-Bereinigung die Anzahl der gelöschten Dateien in der Antwort und vergleichen Sie das entsprechende Verzeichnis vor und nach der Bereinigung. Prüfen Sie die Synapse-Protokolle auf Konfigurations- oder Prozessfehler. Bleibt das Verzeichnis groß, prüfen Sie, ob Ihre Bereitstellung Mediendateien auf einem konfigurierten Provider oder einem separaten Volume speichert. Die lokale Synapse-API zum Löschen von Mediendateien hat keine Auswirkungen auf Mediendateien in einem externen Medienrepository. Gehen Sie nicht davon aus, dass eine erfolgreiche API-Antwort das Host-Dateisystem verkleinert, wenn sich die Dateien an einem anderen Ort befinden.

Offizielle Referenzen

Einen Kommentar hinterlassen

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Prüfen Sie, ob Synapse die maximale Anzahl offener Dateien pro Prozess erreicht hat, richten Sie ein systemd-Drop-in für den richtigen Dienst oder Worker ein und überprüfen Sie das aktuelle Limit.

Element zeigt „Entschlüsselung fehlgeschlagen“ an? Stellen Sie den fehlenden Raumschlüssel wieder her.

Element zeigt „Entschlüsselung fehlgeschlagen“ an? Stellen Sie den fehlenden Raumschlüssel wieder her.

Finden Sie heraus, ob der Fehler auf einen bestimmten Browser oder ein bestimmtes Ereignis beschränkt ist, und verwenden Sie dann den Wiederherstellungsschlüssel von Element oder ein vertrauenswürdiges Gerät, ohne Ihre übrigen verschlüsselten Verlaufsdaten zu riskieren.

Alte Synapse-Nachrichten und Mediendateien bereinigen, ohne Daten zu verlieren

Verwenden Sie die Verlaufs- und Medienbereinigungs-APIs oder die Aufbewahrungseinstellungen von Synapse, um veraltete Daten sicher zu entfernen, und überprüfen Sie anschließend den Abschluss und die Wiederherstellung des Speicherplatzes.

Erstelle einen Matrix-Echo-Bot in Python mit Simple-Matrix-Bot-Lib

Erstelle einen Matrix-Echo-Bot in Python mit Simple-Matrix-Bot-Lib

Installieren Sie die aktuelle Bibliothek, verbinden Sie ein dediziertes Matrix-Konto und führen Sie einen kleinen !echo-Bot mit sichererer Anmeldeinformationsverwaltung und einem klaren Test aus.

Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.

Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.

Richten Sie drei Mauttrix-Bridges mit separaten Registrierungen, Logins und Tests ein – und vermeiden Sie Überraschungen bei Docker-Netzwerken, Kontorichtlinien und Synchronisierung.

Synapse Media-Speicherplatz freigeben, ohne freigegebene Dateien zu beschädigen

Ermitteln Sie, was den Synapse-Speicher belegt, legen Sie eine sichere Medienaufbewahrung fest und leeren Sie den Remote-Cache, ohne Dateien direkt von der Festplatte zu löschen.

Inaktive Matrix-Benutzer deaktivieren, ohne den Raumverlauf zu löschen

Inaktive Matrix-Benutzer deaktivieren, ohne den Raumverlauf zu löschen

Überprüfen Sie die Geräteaktivität, deaktivieren Sie bestätigte inaktive Synapse-Konten über die Admin-API und erfahren Sie, was genau durch das optionale Löschflag entfernt wird.

PostgreSQL-Speicherdruck in Matrix Synapse reduzieren

Ermitteln Sie, ob der PostgreSQL-Speicher durch Abfragen, gemeinsam genutzte Puffer, Verbindungen oder Wartungsarbeiten belegt wird, und nehmen Sie dann gezielte, Synapse-sichere Änderungen vor.

Warum Matrix Synapse Room Joins langsam sind – und was Sie überprüfen sollten

Warum Matrix Synapse Room Joins langsam sind – und was Sie überprüfen sollten

Bevor Sie die Synapse-Einstellungen ändern, sollten Sie langsame Matrix-Raumbeitritte auf einen entfernten Homeserver, Federation-Backoff, lokale Datenbanklast oder eine ausgehende Senderwarteschlange zurückführen.

Matrix-Registrierungen schließen oder Einladungstoken auf Synapse anfordern

Unterbinden Sie die Erstellung offener Konten auf einem selbstgehosteten Synapse-Server oder beschränken Sie die Registrierung auf Einladung mit Registrierungstoken mit begrenzter Nutzungsdauer.