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

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?VerwendenWichtige Grenze
Alte Nachrichten und andere RaumereignisseProtokollierungs-API für Administratoren oder automatische NachrichtenaufbewahrungDas Löschen des Verlaufs erfolgt raumspezifisch. Der Raumstatus bleibt erhalten; Synapse speichert mindestens eine Nachricht in jedem Raum.
Medien, die auf Ihrem Heimserver gespeichert sindLokale Medien-API löschen oder lokale MedienaufbewahrungDie in Profilen und Raumavataren verwendeten Medien sind standardmäßig durch den Datums-/Größenendpunkt geschützt.
Medien, die von anderen Heimservern zwischengespeichert wurdenBereinigung der Remote Media API oder Aufbewahrung von Remote-MedienWird 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.

  1. 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.
  2. 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.
  3. 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.

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.