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