Verwijder oude Synapse-berichten en -media zonder gegevensverlies.

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?GebruikBelangrijke limiet
Oude berichten en andere gebeurtenissen in de chatroomVerwijder 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 thuisserverVerwijder 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.

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

Laat een reactie achter

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Stel vast of Synapse de limiet voor geopende bestanden per proces heeft bereikt, stel een systemd drop-in in voor de juiste service of worker en controleer de actuele limiet.

Geeft het element de melding "Ontsleutelen mislukt"? Herstel de ontbrekende kamersleutel.

Geeft het element de melding "Ontsleutelen mislukt"? Herstel de ontbrekende kamersleutel.

Ontdek of de fout beperkt is tot één browser of één gebeurtenis, en gebruik vervolgens de herstelsleutel van Element of een vertrouwd apparaat om te voorkomen dat uw resterende versleutelde geschiedenis verloren gaat.

Verwijder oude Synapse-berichten en -media zonder gegevensverlies.

Gebruik de API's van Synapse voor het verwijderen van geschiedenis en media, of de bewaarinstellingen, om verouderde gegevens veilig te verwijderen. Controleer vervolgens of de verwijdering is voltooid en of er schijfruimte is vrijgekomen.

Bouw een Matrix Echo Bot in Python met Simple-Matrix-Bot-Lib.

Bouw een Matrix Echo Bot in Python met Simple-Matrix-Bot-Lib.

Installeer de huidige bibliotheek, koppel een speciaal Matrix-account en voer een kleine !echo-bot uit met veiligere omgang met inloggegevens en een duidelijke test.

Verbind Matrix met WhatsApp, Telegram en Discord via Separate Bridges.

Verbind Matrix met WhatsApp, Telegram en Discord via Separate Bridges.

Zet drie mautrix bridges op met aparte registraties, logins en tests, en voorkom verrassingen op het gebied van Docker-netwerken, accountbeleid en synchronisatie.

Maak schijfruimte vrij op Synapse Media zonder gedeelde bestanden te beschadigen.

Ontdek wat de Synapse-opslag vult, stel veilige bewaartermijnen voor media in en wis de cache op afstand zonder bestanden direct van de schijf te verwijderen.

Deactiveer inactieve Matrix-gebruikers zonder de kamergeschiedenis te verwijderen.

Deactiveer inactieve Matrix-gebruikers zonder de kamergeschiedenis te verwijderen.

Bekijk de apparaatactiviteit, deactiveer bevestigde inactieve Synapse-accounts via de Admin API en ontdek wat de optionele wisvlag precies verwijdert.

Verminder de geheugenbelasting van PostgreSQL in Matrix Synapse.

Bepaal of het geheugengebruik van PostgreSQL afkomstig is van query's, gedeelde buffers, verbindingen of onderhoud, en voer vervolgens gerichte, Synapse-veilige wijzigingen door.

Waarom deelname aan Matrix Synapse Rooms traag verloopt en wat je kunt controleren

Waarom deelname aan Matrix Synapse Rooms traag verloopt en wat je kunt controleren

Traceer trage Matrix-ruimteverbindingen met een externe thuisserver, federatievertraging, lokale databasebelasting of een uitgaande verzendwachtrij voordat u Synapse-instellingen wijzigt.

Sluit Matrix-aanmeldingen af ​​of vereis uitnodigingstokens op Synapse.

Stop met het aanmaken van open accounts op een zelfgehoste Synapse-server, of beperk aanmeldingen tot uitnodigingen met registratietokens voor beperkt gebruik.