Um alte Matrix Synapse-Daten sicher zu entfernen, behandeln Sie Raumverlauf und Medien als separate Vorgänge. Verwenden Sie die Purge History Admin API für alte Raumereignisse, die Media Delete API für lokale Medien und die Remote Media Cache API für heruntergeladene Dateien von anderen Homeservern. Konfigurieren Sie für die regelmäßige Bereinigung Aufbewahrungsrichtlinien für Nachrichten und Medien. Das Löschen von Datenbankzeilen verkleinert die Datenbankdatei auf der Festplatte nicht immer sofort.
Wählen Sie die Reinigungsmaßnahme, die Ihrem Ziel entspricht.
| Was nimmt Speicherplatz ein? | Verwenden | Wichtige Grenze |
| Alte Nachrichten und andere Raumereignisse | Protokollierungs-API für Administratoren oder automatische Nachrichtenaufbewahrung | Das Löschen des Verlaufs erfolgt raumspezifisch. Der Raumstatus bleibt erhalten; Synapse speichert mindestens eine Nachricht in jedem Raum. |
| Medien, die auf Ihrem Heimserver gespeichert sind | Lokale Medien-API löschen oder lokale Medienaufbewahrung | Die in Profilen und Raumavataren verwendeten Medien sind standardmäßig durch den Datums-/Größenendpunkt geschützt. |
| Medien, die von anderen Heimservern zwischengespeichert wurden | Bereinigung der Remote Media API oder Aufbewahrung von Remote-Medien | Wird die Anfrage erneut gestellt, ruft Synapse die Daten erneut vom Ursprungsserver ab. |
Diese Einstellungen betreffen die Synapse-eigene Datenbank und das Medienarchiv. Wenn Sie ein externes Medienarchiv wie beispielsweise Matrix Media Repository verwenden, werden die dort gespeicherten Dateien durch den lokalen Löschendpunkt von Synapse nicht entfernt. Lesen Sie daher vor dem Löschen von Daten die Dokumentation und die Backup-Richtlinien des jeweiligen Archivs.
Bereiten Sie sich vor, bevor Sie entsorgen.
- Prüfen Sie, welche Synapse-Instanz die Medienverarbeitung übernimmt. In einer Worker-Umgebung wird die Medienbereinigung auf dem Worker ausgeführt
enable_media_repo: true; dies kann der Hauptprozess sein. Überprüfen Sie Ihr Routing und Ihre Konfiguration, bevor Sie eine Bereinigung diagnostizieren, die scheinbar nicht ausgeführt wird.
- Sichern Sie die Datenbank und den Medienspeicher. Erstellen Sie vor einer endgültigen Löschung eine aktuelle, wiederherstellbare Sicherung. Notieren Sie sich die Raum-ID und den Stichtag und verwenden Sie ein Serveradministrator-Zugriffstoken. Fügen Sie das Token nicht in den Verlauf einer gemeinsamen Shell ein und veröffentlichen Sie es nicht in den Protokollen.
- Planen Sie den Grenzwert sorgfältig. Lösch-Endpunkte akzeptieren Zeitstempel in Unix-Millisekunden. Verwenden Sie einen auf UTC basierenden Grenzwert und überprüfen Sie den Wert, bevor Sie die Anfrage senden. Ein Grenzwert ist keine Vorschau: Er kann berechtigte Daten endgültig löschen.
Ersetzen Sie in den folgenden Beispielen <URL> https://matrix.example.comdurch die clientseitige Basis-URL Ihres Homeservers, legen Sie eine gültige Raum-ID fest und exportieren Sie ein Administrator-Token in <Datei> ADMIN_TOKEN. Bewahren Sie das Bearer-Token geheim auf.
Alte Nachrichtenhistorie aus einem Raum entfernen
Die API „Verlauf löschen“ entfernt Ereignisse, die älter als ein bestimmter Zeitpunkt sind, aus der Synapse-Datenbank. Nachrichten anderer Server werden dabei nicht gelöscht, und dies entspricht nicht dem Löschen eines Raums. Standardmäßig löscht Synapse Ereignisse von Remote-Benutzern, behält aber die Ereignisse lokaler Benutzer bei. Aktivieren Sie diese Option delete_local_eventsnur true, wenn Sie auch diese Ereignisse löschen möchten. Der Raumstatus, wie z. B. Mitgliedschaften und das Thema, bleibt erhalten.
Um beispielsweise auf einem Linux-Host einen Stichtag von 180 Tagen vor der aktuellen Zeit festzulegen, berechnen Sie den Zeitstempel in Millisekunden, überprüfen Sie ihn und senden Sie dann die Anfrage für ein einzelnes Zimmer ab:
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}"
Lassen Sie den Wert weg delete_local_eventsoder setzen Sie ihn auf „false“, falsewenn Sie das Standardverhalten von Synapse beibehalten möchten. Wenn die API einen Wert zurückgibt purge_id, hat die Bereinigung begonnen; sie ist aber nicht unbedingt abgeschlossen. Fragen Sie den Status-Endpunkt regelmäßig ab, bis er einen Wert meldet, completeoder prüfen Sie dessen errorStatus, ob dieser lautet failed:
curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
-H "Authorization: Bearer $ADMIN_TOKEN"
Umfangreiche Löschvorgänge können mehrere Minuten oder länger dauern. Währenddessen können Benutzer möglicherweise nicht innerhalb des betreffenden Chatraums von dem zu löschenden Punkt aus zurückblättern. Synapse speichert mindestens eine Nachricht pro Chatraum, sodass die Timeline des Chatraums durch diese API nicht vollständig geleert wird.
Alte Mediendateien und zwischengespeicherte Remote-Dateien löschen
Um einmalig lokale Mediendateien zu löschen, die zuletzt vor einem bestimmten Zeitpunkt verwendet wurden, verwenden Sie den aktuellen lokalen Medienendpunkt. Dieser before_tsist ein Unix-Zeitstempel in Millisekunden und kann auch size_gtDateien oberhalb einer bestimmten Byte-Grenze als Zieldateien angeben. Standardmäßig bleiben Mediendateien, die für Profil- oder Raumavatarbilder verwendet werden, erhalten. Ändern Sie diese Einstellung keep_profiles=falsenur, wenn Sie diese Dateien gezielt entfernen möchten.
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 '{}'
Überprüfen Sie die Antwort totalund die gelöschten Medien-IDs. Der Endpunkt löscht lokale Originale und Miniaturansichten. Vermeiden Sie den älteren Pfad mit dem Präfix /media/<server_name>/delete„;“. Die Synapse-Dokumentation kennzeichnet diesen Pfad seit Version 1.78.0 als veraltet. Der aktuelle lokale Medien-Endpunkt arbeitet nicht mit einem separaten externen Medien-Repository.
Zwischengespeicherte Remote-Medien bilden eine separate Kategorie. Um Remote-Medien aus dem Cache zu entfernen, auf die zuletzt vor dem gleichen Stichtag zugegriffen wurde, verwenden Sie Folgendes:
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 '{}'
Die Antwort gibt an, wie viele zwischengespeicherte Elemente gelöscht wurden. Wenn Benutzer diese Dateien später anfordern, lädt Synapse sie möglicherweise erneut vom Ursprungsserver herunter. Dieser Vorgang reduziert also die lokale Festplattennutzung, verringert aber gleichzeitig den Netzwerkverkehr und die Abrufverzögerung.
Statt wiederholter manueller Löschungen sollten Sie eine wiederkehrende Aufbewahrungsfrist festlegen.
Die Aufbewahrung von Synapse-Nachrichten ist standardmäßig deaktiviert. Um eine serverweite Standardeinstellung für Räume ohne eigenen Aufbewahrungsstatus zu erzwingen, fügen Sie der Konfiguration eine Richtlinie hinzu und aktivieren Sie diese. In diesem Beispiel wird ein Maximum von einem Jahr festgelegt:
retention:
enabled: true
default_policy:
max_lifetime: 1y
Verwenden Sie die von Synapse unterstützten Zeiteinheiten, z. B. dTage und yJahre. Raumadministratoren und Moderatoren können außerdem m.room.retentionStatusereignisse für einen Raum festlegen, während Serveradministratoren die maximal zulässige Lebensdauer mit `limit` allowed_lifetime_minund `limit` begrenzen können allowed_lifetime_max. Überprüfen Sie Ihre vollständigen Richtlinien, bevor Sie diese aktivieren: Geeignete Ereignisse werden durch Hintergrundprozesse dauerhaft entfernt. Synapse blendet abgelaufene Ereignisse für Clients sofort nach Ablauf aus, die Datenbankbereinigung erfolgt jedoch regelmäßig, sodass Datensätze bis zur nächsten Ausführung eines Prozesses erhalten bleiben können. Statusereignisse sind von der Nachrichtenaufbewahrung nicht abgedeckt.
Für Medien fügen Sie media_retentionLebensdauern hinzu, zum Beispiel:
media_retention:
local_media_lifetime: 90d
remote_media_lifetime: 14d
Diese Aufbewahrungsfristen beziehen sich auf Inaktivitätszeiträume und nicht nur auf eine Upload-Grenze: Wurde eine Datei aufgerufen, verwendet Synapse den letzten Zugriffszeitpunkt; bei nie aufgerufenen Mediendateien den Erstellungszeitpunkt. Originaldateien und Miniaturansichten werden entfernt. Unter Quarantäne gestellte und lokal vor Quarantäne geschützte Mediendateien sind von dieser Bereinigung nicht betroffen. Konfigurieren Sie die Medienaufbewahrung für den Prozess, der das Medienarchiv hostet, und überprüfen Sie die Einstellung anschließend anhand des Konfigurationshandbuchs Ihrer Synapse-Version.
Lesen Sie vor der Anwendung von Änderungen die offizielle Dokumentation zur Purge History API , zur Media Admin API , das Synapse-Konfigurationshandbuch und die Dokumentation zur Nachrichtenaufbewahrungsrichtlinie . Das hier beschriebene API-Verhalten entspricht der offiziellen Dokumentation vom 10. Oktober 2026; überprüfen Sie Endpunkte und Konfiguration anhand Ihrer installierten Version.
Prüfen, ob der Speicherplatz wieder freigegeben wurde
- Überprüfen Sie den Status der Verlaufsbereinigung, bis dieser den Wert „“ anzeigt
complete; speichern Sie die Bereinigungs-ID und die Antwort für Ihr Wartungsprotokoll.
- Prüfen Sie die lokalen Mediendateien und die Antworten des Remote-Caches auf die Anzahl der gelöschten Dateien und untersuchen Sie anschließend die Synapse-Protokolle und die Dateisystemnutzung nach der Bereinigung.
- Gehen Sie nicht davon aus, dass weniger Datenbankzeilen automatisch eine kleinere Datenbankdatei bedeuten. Die Synapse-Dokumentation weist darauf hin, dass PostgreSQL freigegebenen Speicherplatz wiederverwenden kann, ohne ihn an das Betriebssystem zurückzugeben. PostgreSQL
VACUUM FULLkann Speicherplatz freigeben, benötigt dafür aber eine exklusive Sperre. Planen Sie dies unter Berücksichtigung von Ausfallzeiten und Auswirkungen und beachten Sie die PostgreSQL-VACUUM-Dokumentation . Die Aufbewahrungsdokumentation von Synapse für SQLite beschreibt VACUUMdie entsprechende Operation.
- Vergewissern Sie sich, dass die erwarteten Dateien oder älteren Ereignisse nicht mehr bereitgestellt werden, und prüfen Sie, ob Ihre Sicherung weiterhin verfügbar ist, bevor Sie den Wartungsvorgang abschließen.