Curățați mesajele și fișierele media vechi din sinapse fără a pierde date

Pentru a elimina în siguranță datele vechi din Matrix Synapse, tratați istoricul camerei și fișierele media ca sarcini separate. Utilizați API-ul Purge History Admin pentru evenimentele vechi din camere, API-ul de ștergere a fișierelor media pentru fișierele media locale și API-ul de memorare cache a fișierelor media la distanță pentru fișierele descărcate de pe alte servere principale. Pentru curățarea recurentă, configurați politici de retenție pentru mesaje și fișiere media. Ștergerea rândurilor bazei de date nu micșorează întotdeauna imediat fișierul bazei de date de pe disc.

Alege curățarea care corespunde obiectivului tău

Ce ocupă spațiu?UtilizareLimită importantă
Mesaje vechi și alte evenimente din camerăAPI-ul de administrare Purge History sau păstrarea automată a mesajelorȘtergerea istoricului este specifică fiecărei camere. Starea camerei este păstrată; Synapse păstrează cel puțin un mesaj în fiecare cameră.
Media stocată de serverul dvs. de acasăȘtergeți API-ul Local Media sau păstrarea media localăFișierele media utilizate în profiluri și avatare de camere sunt protejate în mod implicit de endpoint-ul dată/dimensiune.
Fișiere media stocate în cache de pe alte servere de acasăAPI-ul Purge Remote Media sau reținerea media la distanțăDacă este solicitat din nou, Synapse îl preia din nou de la serverul de origine.

Aceste controale afectează baza de date și depozitul media propriu al Synapse. Dacă utilizați un depozit media extern, cum ar fi Matrix Media Repository, endpoint-ul local de ștergere a fișierelor media al Synapse nu elimină fișierele stocate acolo. Verificați documentația și politica de backup a depozitului respectiv înainte de a șterge datele.

Pregătește-te înainte de a face curățenie

  1. Confirmați ce instanță Synapse gestionează media. Într-o implementare worker, curățarea media rulează pe worker cu enable_media_repo: true; acesta poate fi procesul principal. Confirmați rutarea și configurația înainte de a diagnostica o curățare care pare să nu ruleze.
  2. Faceți o copie de rezervă a bazei de date și a depozitului media. Faceți o copie de rezervă actuală, restaurabilă, înainte de o curățare ireversibilă. Înregistrați ID-ul camerei și ora limită și utilizați un token de acces de administrator al serverului. Nu lipiți token-ul într-un istoric shell partajat și nu îl publicați în jurnale.
  3. Planificați cu atenție limita de timp. Punctele finale de ștergere acceptă marcaje temporale în milisecunde Unix. Folosiți o limită de timp derivată din UTC și verificați numărul înainte de a trimite solicitarea. O limită de timp nu este o previzualizare: poate elimina definitiv datele eligibile.

În exemplele de mai jos, înlocuiți https://matrix.example.comcu adresa URL de bază orientată spre client pentru serverul dvs. de domiciliu, setați un ID de cameră valid și exportați un token de administrator în ADMIN_TOKEN. Păstrați token-ul purtător privat.

Eliminați istoricul mesajelor vechi dintr-o cameră

API-ul Purge History elimină evenimentele mai vechi decât un anumit punct din baza de date Synapse. Nu elimină mesajele pentru alte servere și nu este același lucru cu eliminarea unei camere. În mod implicit, Synapse șterge evenimentele trimise de utilizatorii la distanță, dar păstrează evenimentele utilizatorilor locali; setați delete_local_eventsla truedoar atunci când intenționați să le eliminați și pe acestea. Starea camerei, cum ar fi apartenența și subiectul, este păstrată.

De exemplu, pentru a seta o limită de timp cu 180 de zile înainte de ora curentă pe o gazdă Linux, calculați marcajul temporal în milisecunde, inspectați-l, apoi trimiteți cererea pentru o singură cameră:

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}"

Omiteți delete_local_eventssau setați la falsedacă doriți comportamentul implicit al Synapse. Dacă API-ul returnează un purge_id, epurarea a început; nu neapărat s-a terminat. Interogați endpoint-ul de stare până când raportează completesau investigați-i starea errordacă starea este failed:

curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

Eliminarea mesajelor în detaliu poate dura câteva minute sau mai mult. În timpul operațiunii, este posibil ca utilizatorii să nu poată pagina mai departe în acea cameră de la punctul care este eliminat. Synapse păstrează cel puțin un mesaj într-o cameră, așa că acest API nu va goli complet cronologia camerei.

Ștergeți suporturile media vechi și fișierele la distanță din cache

Pentru o curățare unică a suporturilor media locale utilizate ultima dată înainte de o întrerupere, utilizați punctul final curent al suportului media local. Este before_tsun timestamp Unix în milisecunde și poate accepta, de asemenea, size_gtsă vizeze fișiere peste un anumit prag de octeți. Implicit, suporturile media sunt încă utilizate pentru imaginile de profil sau avatar ale camerei; nu setați această opțiune keep_profiles=falsedecât dacă doriți intenționat să eliminați aceste fișiere.

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 '{}'

Verificați ID-urile media ale răspunsului totalși ale celor șterse. Punctul final șterge originalele și miniaturile locale. Evitați calea mai veche care conține /media/<server_name>/delete; documentația Synapse marchează acea rută ca fiind depreciată de la versiunea 1.78.0. Punctul final media local actual nu funcționează pe un depozit media extern separat.

Mediile de stocare la distanță din cache reprezintă o categorie separată. Pentru a elimina mediile de stocare la distanță din cache care au fost accesate ultima dată înainte de aceeași întrerupere, utilizați:

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 '{}'

Răspunsul raportează câte elemente din cache au fost șterse. Dacă utilizatorii solicită ulterior aceste fișiere, Synapse le poate descărca din nou de pe serverul lor de origine, astfel încât această operațiune schimbă utilizarea discului local cu un posibil trafic de rețea și o întârziere în recuperare.

Setați retenția recurentă în loc să repetați eliminările manuale

Păstrarea mesajelor sinapselor este dezactivată în mod implicit. Pentru a impune o setare implicită la nivel de server pentru camerele fără propria stare de păstrare, adăugați o politică la configurație și activați-o. Acest exemplu setează un maxim de un an:

retention:
  enabled: true
  default_policy:
    max_lifetime: 1y

Folosește unitățile de durată acceptate de Synapse, cum ar fi dpentru zile și ypentru ani. Administratorii și moderatorii camerelor pot, de asemenea, seta m.room.retentionevenimentul de stare al unei camere, în timp ce administratorii serverului pot limita duratele de viață maxime permise cu allowed_lifetime_minși allowed_lifetime_max. Verifică politica completă înainte de a o activa: evenimentele eligibile sunt eliminate definitiv de sarcinile de epurare în fundal. Synapse ascunde evenimentele expirate de clienți imediat ce acestea expiră, dar epurarea bazei de date rulează periodic, astfel încât rândurile pot rămâne până la rularea unui job. Evenimentele de stare nu sunt acoperite de păstrarea mesajelor.

Pentru media, adăugați media_retentiondurate de viață, de exemplu:

media_retention:
  local_media_lifetime: 90d
  remote_media_lifetime: 14d

Aceste durate de viață sunt perioade de inactivitate, nu doar o limită de vârstă pentru încărcare: când un fișier a fost accesat, Synapse folosește ultima sa accesare; pentru fișierele media care nu au fost niciodată accesate, folosește ora creării sale. Fișierele și miniaturile originale sunt eliminate. Fișierele media din carantină și fișierele media locale protejate de carantină nu sunt eliminate de această curățare. Configurați păstrarea fișierelor media în procesul care găzduiește depozitul media, apoi validați setarea în funcție de manualul de configurare pentru versiunea Synapse pe care o rulați.

Citiți documentația oficială a API-ului Purge History , a API-ului Media Admin , a manualului de configurare Synapse și a politicii de păstrare a mesajelor înainte de a aplica modificările. Comportamentul API descris aici reflectă documentația oficială verificată pe 10 octombrie 2026; confirmați punctele de terminare și configurația în raport cu versiunea instalată.

Verificați dacă spațiul de stocare a fost recuperat

  • Interogați starea de epurare a istoricului până când spune complete; păstrați ID-ul și răspunsul de epurare pentru jurnalul de întreținere.
  • Verificați numărul de ștergeri din răspunsurile din mediul local și din memoria cache la distanță, apoi inspectați jurnalele Synapse și utilizarea sistemului de fișiere după curățare.
  • Nu presupuneți că mai puține rânduri în baza de date înseamnă imediat un fișier de bază de date mai mic. Documentația Synapse menționează că PostgreSQL poate reutiliza spațiul eliberat fără a-l returna sistemului de operare. Pentru PostgreSQL, VACUUM FULLse poate recupera spațiu pe disc, dar necesită o blocare exclusivă; programați-o ținând cont de timpii de nefuncționare/impact și urmați documentația PostgreSQL VACUUM . Pentru SQLite, documentația de retenție Synapse identifică VACUUMoperațiunea ca fiind corespunzătoare.
  • Confirmați că fișierele așteptate sau evenimentele mai vechi nu mai sunt servite și verificați dacă copia de rezervă este în continuare disponibilă înainte de a închide sarcina de întreținere.

Lasă un comentariu

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Diagnosticați dacă Synapse a atins limita de fișiere deschise per proces, setați un drop-in systemd pentru serviciul sau worker-ul corect și verificați limita de funcționare.

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Află dacă eroarea este limitată la un singur browser sau la un singur eveniment, apoi folosește cheia de recuperare Element sau un dispozitiv de încredere fără a risca istoricul criptat rămas.

Curățați mesajele și fișierele media vechi din sinapse fără a pierde date

Folosește API-urile sau setările de retenție pentru istoric și epurare media ale Synapse pentru a elimina în siguranță datele învechite, apoi verifică finalizarea și recuperarea spațiului pe disc.

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Instalați biblioteca curentă, conectați un cont Matrix dedicat și rulați un mic bot !echo cu o gestionare mai sigură a acreditărilor și un test clar.

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Configurați trei punți Mautrix cu înregistrări, conectări și teste separate - și evitați surprizele legate de rețelele Docker, politicile de cont și sincronizare.

Recuperați spațiul de pe disc Synapse Media fără a deteriora fișierele partajate

Găsiți ce umple spațiul de stocare Synapse, setați retenția sigură a suporturilor media și goliți memoria cache la distanță fără a șterge fișierele direct de pe disc.

Dezactivarea utilizatorilor inactivi din matrice fără a șterge istoricul camerei

Dezactivarea utilizatorilor inactivi din matrice fără a șterge istoricul camerei

Verifică activitatea dispozitivului, dezactivează conturile Synapse inactive confirmate prin intermediul API-ului Admin și află ce elimină de fapt indicatorul opțional de ștergere.

Reduceți presiunea memoriei PostgreSQL în sinapsa matriceală

Află dacă memoria PostgreSQL provine din interogări, buffere partajate, conexiuni sau mentenanță, apoi fă modificări specifice, sigure pentru sinapse.

De ce sunt lente alăturările la Matrix Synapse Room și ce trebuie verificat

De ce sunt lente alăturările la Matrix Synapse Room și ce trebuie verificat

Urmăriți alăturările lente ale camerei Matrix la un server de acasă la distanță, retragerea temporară a federației, încărcarea bazei de date locale sau o coadă de expediere înainte de a modifica setările Synapse.

Închideți înscrierile la Matrix sau solicitați token-uri de invitație pe Synapse

Opriți crearea de conturi deschise pe un server Synapse auto-găzduit sau mențineți înscrierile doar pe bază de invitație cu token-uri de înregistrare cu utilizare limitată.