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

Als de mediabibliotheek van Synapse de schijf vol raakt, controleer dan eerst welke map of welk volume groeit. Gebruik vervolgens de door Synapse ondersteunde bewaarinstellingen of de beheerders-API om media te verwijderen. Verwijder geen bestanden rechtstreeks vanuit de mediabibliotheek media_store: Synapse bewaart mediagegevens in de database en het verwijderen van bestanden achter Synapse kan leiden tot verbroken verwijzingen of het controleren van de opruiming bemoeilijken. Het veiligste beleid hangt af van de vraag of de schijfruimte wordt gebruikt voor lokale uploads, gecachede media van andere homeservers, miniaturen of een andere service die dezelfde schijf deelt.

Wat neemt die ruimte in beslag?

De mediabibliotheek van Synapse slaat lokaal geüploade avatars, bijlagen en miniaturen op. Ook worden media die van externe Matrix-servers worden opgehaald en bronnen die voor URL-voorbeelden worden gebruikt, in de cache opgeslagen. Deze gegevens staan ​​los van de Synapse-database, containerlogboeken en eventuele externe mediabibliotheken. Een volledig gevuld rootbestandssysteem bewijst op zich niet dat dit media_storede oorzaak is.

Vergelijk op de host of in de container die de gekoppelde gegevens beheert, het bestandssysteemgebruik met de Synapse-gegevensmap. Vervang het voorbeeldpad door de waarde in uw implementatie:

df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store

Synapse media_store_pathgebruikt standaard de map `media` media_store, meestal in de data-directory, maar installaties kunnen dit overschrijven. Containers kunnen schrijven naar een gekoppeld volume waarvan de daadwerkelijke opslag zich op de host bevindt. Controleer homeserver.yamlde `media`-directory, de volume-mapping van uw container of de persistent-volume-configuratie van uw orchestrator voordat u concludeert dat een hostpad veilig kan worden gewijzigd. Als de media-directory niet de grootste verbruiker is, onderzoek dan de component die dudit aangeeft.

Kies een beleid voor het opruimen van ongewenste inhoud dat past bij de media.

Geverifieerd gedrag: De instelling van Synapse media_retentionkan lokale media en in de cache opgeslagen externe media laten verlopen na een periode van inactiviteit. Inactiviteit omvat het laden van media in een ruimte of het downloaden ervan. Als een item nog nooit is gebruikt, gebruikt Synapse de aanmaaktijd. Zowel de originele media als de miniaturen ervan worden verwijderd. De opruimactie wordt uitgevoerd door de media-repository worker, wat het hoofdproces van Synapse kan zijn.

Wat afhangt van uw specifieke gebruikssituatie: bestanden die op afstand in de cache zijn opgeslagen, kunnen na verwijdering doorgaans opnieuw worden opgehaald van de server waarop ze oorspronkelijk stonden. Lokaal geüploade bestanden worden gehost door uw server, waardoor het verwijderen ervan ertoe kan leiden dat oude bijlagen of avatars niet meer beschikbaar zijn. Kies alleen voor lokale retentie als uw gebruikers die consequentie accepteren; een langere lokale bewaartermijn of geen automatische lokale opschoning is mogelijk geschikter voor een community die oude bijlagen als archief beschouwt.

Wat 'retentie' níét betekent: het in quarantaine plaatsen van media blokkeert de toegang, maar verwijdert het bestand of de miniaturen ervan niet. Het maakt de benodigde schijfruimte niet vrij. Als u een item in quarantaine wilt bewaren terwijl u andere gegevens verwijdert, houd dan het onderscheid duidelijk: quarantaine is een beheermaatregel, terwijl retentie en verwijdering beheermaatregelen voor de opslag zijn.

Schakel automatische retentie in Synapse in.

Maak een back-up van de actieve configuratie voordat u deze bewerkt. Voeg een sectie op het hoogste niveau toe media_retentionof werk de bestaande bij. Dit beleid zorgt er bijvoorbeeld voor dat lokale media na 180 dagen zonder toegang verlopen en dat cache-items op afstand na 30 dagen verlopen.

media_retention:
  local_media_lifetime: 180d
  remote_media_lifetime: 30d

Deze waarden zijn voorbeelden, geen universele aanbevelingen. Stel de lokale periode in op basis van uw bewaarverplichtingen en verwachtingen voor oude content in de ruimte. Als u de cache alleen voor externe media wilt beheren, configureert u alleen remote_media_lifetime; een niet-ingestelde of null-levensduur betekent dat dat type niet automatisch wordt verwijderd. Synapse documenteert ook dat in quarantaine geplaatste media en lokale media die beschermd zijn tegen quarantaine, zijn uitgesloten van het opschonen van de bewaarperiode.

Pas de configuratie toe via het normale herstart- of herlaadproces van de implementatie en controleer of de mediarepository-worker actief is enable_media_repo: true. Als Synapse een aparte mediaworker gebruikt, configureer dan het beleid waarin de mediarepository-service is ingeschakeld. Een geldige YAML-bewerking maakt niet direct alle ruimte vrij: de worker moet eerst opschonen en alleen media die ouder zijn dan de gekozen toegangslimiet komen hiervoor in aanmerking.

Maak sneller ruimte vrij met de Admin API.

Als de schijf al kritiek is, biedt Synapse beheerders-eindpunten voor het opschonen ervan. Deze acties verwijderen de media permanent. Maak voordat u ze gebruikt een back-up van de database en de mediagegevens, controleer of de URL naar uw eigen thuisserver verwijst en gebruik een serverbeheerder-toegangstoken via HTTPS. Zorg ervoor dat het token niet in de shellgeschiedenis en gedeelde logbestanden wordt opgeslagen.

Om oude, in de cache opgeslagen externe media te verwijderen, roept u het gedocumenteerde eindpunt aan met een afkap-tijdstempel in milliseconden sinds de Unix-epoch:

POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>

Een shell kan bijvoorbeeld met GNU een grens van 30 dagen geleden berekenen date:

cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
  -H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"

Het antwoord geeft aan hoeveel items uit de cache zijn verwijderd. Als gebruikers deze externe bestanden opnieuw opvragen, haalt Synapse ze opnieuw op van de server waar ze vandaan kwamen; dit kan het schijfgebruik voor populaire media verminderen.

De API voor het verwijderen van lokale media kan lokale media verwijderen op basis van de laatste toegangstijd en, optioneel, een minimale grootte. Het huidige eindpunt is POST /_synapse/admin/v1/media/delete?before_ts=…; het oudere eindpunt met <server_name>is verouderd sinds Synapse 1.78.0. De grens is de laatste toegangstijd, niet de uploaddatum, en de keep_profilesoptie is standaard ingesteld op true. Omdat deze verwijdering bestanden kan verwijderen die gebruikers beschikbaar verwachten te blijven, is het raadzaam om de geconfigureerde bewaartermijn te gebruiken, tenzij u een geschikte grens hebt ingesteld en het effect accepteert. Raadpleeg de officiële API-referentie voor parameters en uw geïnstalleerde Synapse-versie.

Veelvoorkomende misvattingen die u moet vermijden

  • "Het verwijderen van een ruimte wist ook de mediabestanden." Ga hier niet zomaar vanuit. De geschiedenis van een ruimte, mediabestanden en gecachede kopieën worden beheerd via verschillende processen. Gebruik de Media Admin API of het bewaarbeleid om media specifiek te beheren.
  • "Quarantaine maakt schijfruimte vrij." Dat is niet waar: media en miniaturen in quarantaine blijven op de schijf staan. Gebruik een verwijderings- of bewaarfunctie wanneer het doel is om schijfruimte vrij te maken.
  • “Alle media in de repository zijn uploads van mijn gebruikers.” De repository bevat ook gegevens over de externe cache en URL-voorbeelden. Vergelijk de subdirectories van de repository en de opslagconfiguratie van Synapse voordat u een opschoning kiest.
  • "Het handmatig verwijderen van bestanden is gelijk aan de Synapse-opruimfunctie." Dit is geen ondersteund alternatief. Laat Synapse de metadata bijwerken via het bewaarproces of de Admin API.

Controleer of het schijfgebruik afneemt.

Nadat de opschoonworker voldoende tijd heeft gehad om te draaien, controleert u df -hde grootte van de mediadirectory opnieuw. Controleer bij een API-opschoning het aantal verwijderde items in het antwoord en vergelijk de betreffende directory vóór en na de opschoning. Controleer de Synapse-logboeken op configuratie- of workerfouten. Als de directory groot blijft, controleert u of uw implementatie media naar een geconfigureerde provider of een apart volume schrijft; de Synapse API voor het verwijderen van lokale media heeft geen invloed op media die zijn opgeslagen in een externe mediaopslagplaats. Ga er niet van uit dat een succesvol API-antwoord het bestandssysteem van de host zal verkleinen als de bestanden zich elders bevinden.

Officiële referenties

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.