Om oude Matrix Synapse-gegevens veilig te verwijderen, behandelt u de kamergeschiedenis en media als aparte taken. Gebruik de Purge History Admin API voor oude kamergebeurtenissen, de media deletion API voor lokale media en de remote media cache API voor gedownloade bestanden van andere homeservers. Configureer voor terugkerende opschoning bewaarbeleid voor berichten en media. Het verwijderen van database-rijen verkleint het databasebestand op de schijf niet altijd direct.
Kies de opruimmethode die bij uw doel past.
| Wat neemt ruimte in beslag? | Gebruik | Belangrijke limiet |
| Oude berichten en andere gebeurtenissen in de chatroom | Verwijder de geschiedenis via de beheerders-API of gebruik de automatische bewaarplicht voor berichten. | Het wissen van de geschiedenis is kamerspecifiek. De kamerstatus blijft behouden; Synapse bewaart minstens één bericht in elke kamer. |
| Media opgeslagen door uw thuisserver | Verwijder de Local Media API of de lokale mediabewaring. | Media die in profielen en kameravatars worden gebruikt, worden standaard beschermd door het datum/grootte-eindpunt. |
| Mediabestanden die in de cache zijn opgeslagen vanaf andere thuisservers. | Verwijder de API voor externe media of de bewaarplicht voor externe media. | Als het verzoek opnieuw wordt ingediend, haalt Synapse het weer op van de server waar het oorspronkelijk vandaan kwam. |
Deze instellingen hebben betrekking op de eigen database en mediaopslag van Synapse. Als u een externe mediaopslag gebruikt, zoals Matrix Media Repository, verwijdert het lokale verwijderingspunt van Synapse de daar opgeslagen bestanden niet. Raadpleeg de documentatie en het back-upbeleid van die opslagplaats voordat u gegevens verwijdert.
Bereid je voor voordat je gaat opruimen.
- Controleer welke Synapse-instantie de media afhandelt. In een worker-implementatie wordt het opschonen van media uitgevoerd op de worker
enable_media_repo: true; dit kan het hoofdproces zijn. Controleer uw routering en configuratie voordat u een probleem onderzoekt waarbij het opschonen niet lijkt te werken.
- Maak een back-up van de database en de mediaopslag. Maak een recente, herstelbare back-up voordat u de gegevens onomkeerbaar verwijdert. Noteer de kamer-ID en de sluitingstijd en gebruik een toegangstoken voor de serverbeheerder. Plak het token niet in een gedeelde shellgeschiedenis en publiceer het niet in logbestanden.
- Plan de deadline zorgvuldig. Eindpunten voor het verwijderen van gegevens accepteren tijdstempels in Unix-milliseconden. Gebruik een deadline die is afgeleid van UTC en controleer het getal voordat u het verzoek verzendt. Een deadline is geen preview: het kan permanent in aanmerking komende gegevens verwijderen.
Vervang in de onderstaande voorbeelden https://matrix.example.comdoor de basis-URL voor uw thuisserver die toegankelijk is voor de client, stel een geldige kamer-ID in en exporteer een beheerderstoken in ADMIN_TOKEN. Houd het bearer-token privé.
Verwijder oude berichten uit één chatroom.
De Purge History API verwijdert gebeurtenissen ouder dan een bepaald moment uit de Synapse-database. Berichten voor andere servers worden niet geanonimiseerd en het is niet hetzelfde als het verwijderen van een chatroom. Standaard verwijdert Synapse gebeurtenissen die door externe gebruikers worden verzonden, maar bewaart de gebeurtenissen van lokale gebruikers; stel deze optie alleen delete_local_eventsin trueals u ook die lokale gebruikers wilt verwijderen. De chatroomstatus, zoals lidmaatschap en het onderwerp, blijft behouden.
Om bijvoorbeeld een deadline van 180 dagen vóór de huidige tijd op een Linux-host in te stellen, berekent u de tijdstempel in milliseconden, controleert u deze en dient u vervolgens het verzoek voor een enkele kamer in:
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}"
Laat dit weg delete_local_eventsof stel het in op 0 falseals u het standaardgedrag van Synapse wilt gebruiken. Als de API een retourneert purge_id, is het opschonen gestart; het is niet per se voltooid. Controleer het status-eindpunt totdat het rapporteert completeof onderzoek errorde status als deze is failed:
curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
-H "Authorization: Bearer $ADMIN_TOKEN"
Grote opschoningsprocessen kunnen enkele minuten of langer duren. Tijdens de bewerking kunnen gebruikers mogelijk niet verder terug in de tijdlijn van die chatroom navigeren vanaf het punt waar de opschoning plaatsvindt. Synapse bewaart ten minste één bericht in een chatroom, dus deze API zal de tijdlijn van de chatroom niet volledig leegmaken.
Verwijder oude media en in de cache opgeslagen externe bestanden.
Voor een eenmalige opschoning van lokale media die voor een bepaalde tijdslimiet voor het laatst zijn gebruikt, gebruikt u het huidige lokale media-eindpunt. Dit before_tsis een Unix-tijdstempel in milliseconden en kan ook size_gtbestanden accepteren die groter zijn dan een bepaalde bytegrens. Standaard worden media die nog steeds worden gebruikt voor profiel- of kameravatar-afbeeldingen behouden; stel deze instelling niet in, keep_profiles=falsetenzij u deze bestanden bewust wilt verwijderen.
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 '{}'
Controleer de totalID's van de reactie en de verwijderde mediabestanden. Het eindpunt verwijdert lokale originelen en miniaturen. Vermijd het oudere pad met een puntkomma /media/<server_name>/delete; de Synapse-documentatie geeft aan dat deze route sinds versie 1.78.0 als verouderd wordt beschouwd. Het huidige lokale media-eindpunt werkt niet met een aparte externe media-opslagplaats.
Opgeslagen externe media vormen een aparte categorie. Om externe media in de cache te verwijderen die voor dezelfde deadline voor het laatst zijn geopend, gebruikt u:
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 '{}'
Het antwoord geeft aan hoeveel items uit de cache zijn verwijderd. Als gebruikers die bestanden later opvragen, kan Synapse ze opnieuw downloaden van de server waar ze vandaan komen. Deze bewerking ruilt dus lokaal schijfgebruik in voor mogelijk netwerkverkeer en vertraging bij het ophalen van de bestanden.
Stel terugkerende bewaartermijnen in in plaats van handmatige verwijderingen te herhalen.
Het bewaren van Synapse-berichten is standaard uitgeschakeld. Om een serverbrede standaardinstelling af te dwingen voor kamers zonder eigen bewaarstatus, voegt u een beleid toe aan de configuratie en schakelt u dit in. In dit voorbeeld wordt een maximum van één jaar ingesteld:
retention:
enabled: true
default_policy:
max_lifetime: 1y
Gebruik de door Synapse ondersteunde tijdseenheden, zoals ddagen en yjaren. Kamerbeheerders en moderators kunnen ook de m.room.retentionstatusgebeurtenis van een kamer instellen, terwijl serverbeheerders de maximaal toegestane levensduur kunnen beperken met allowed_lifetime_minen allowed_lifetime_max. Bekijk uw volledige beleid voordat u het inschakelt: in aanmerking komende gebeurtenissen worden permanent verwijderd door achtergrondopschoontaken. Synapse verbergt verlopen gebeurtenissen voor clients zodra ze verlopen, maar de databaseopschoning wordt periodiek uitgevoerd, waardoor rijen kunnen blijven bestaan totdat een taak wordt uitgevoerd. Statusgebeurtenissen vallen niet onder de berichtretentie.
Voeg voor media media_retentionlevensduurgegevens toe, bijvoorbeeld:
media_retention:
local_media_lifetime: 90d
remote_media_lifetime: 14d
Deze levensduur verwijst naar inactiviteitsperioden, niet simpelweg naar een maximale uploadleeftijd: wanneer een bestand is geopend, gebruikt Synapse de datum van de laatste toegang; voor media die nooit zijn geopend, gebruikt Synapse de aanmaaktijd. Originele bestanden en miniaturen worden verwijderd. Media in quarantaine en lokale media die beschermd zijn tegen quarantaine worden niet verwijderd tijdens deze opruimactie. Configureer de bewaartermijn voor media in het proces dat de mediaopslagplaats beheert en controleer de instelling vervolgens aan de hand van de configuratiehandleiding voor de Synapse-versie die u gebruikt.
Lees de officiële Purge History API , Media Admin API , de Synapse-configuratiehandleiding en de documentatie over het beleid voor berichtbewaring voordat u wijzigingen aanbrengt. Het hier beschreven API-gedrag is gebaseerd op de officiële documentatie die is gecontroleerd op 10 oktober 2026; controleer de eindpunten en configuratie aan de hand van uw geïnstalleerde versie.
Controleer of de opslagruimte is teruggewonnen.
- Controleer de status van het wissen van de geschiedenis totdat deze aangeeft dat het proces is voltooid
complete; bewaar de wis-ID en het antwoord voor uw onderhoudslogboek.
- Controleer de lokale media en de reacties van de externe cache op het aantal verwijderde items, en inspecteer vervolgens de Synapse-logboeken en het bestandssysteemgebruik na de opschoning.
- Ga er niet van uit dat minder rijen in de database automatisch een kleiner databasebestand betekenen. De documentatie van Synapse vermeldt dat PostgreSQL vrijgekomen ruimte kan hergebruiken zonder deze terug te geven aan het besturingssysteem. Voor PostgreSQL
VACUUM FULLis het mogelijk om schijfruimte terug te winnen, maar dit vereist een exclusieve vergrendeling; plan dit met inachtneming van de downtime/impact en volg de PostgreSQL VACUUM-documentatie . Voor SQLite wordt in de retentiedocumentatie van Synapse VACUUMde overeenkomstige bewerking beschreven.
- Controleer of de verwachte bestanden of oudere gebeurtenissen niet langer worden weergegeven en verifieer of uw back-up nog beschikbaar is voordat u de onderhoudstaak sluit.