Matrix Room-beheerdersrechtenfouten oplossen via actie
Traceer M_FORBIDDEN naar het stroomniveau van de ruimte, het lidmaatschap of de Synapse-serverbeheerderstoegang en herstel vervolgens alleen de machtiging die de geblokkeerde actie nodig heeft.
Als Matrix Synapse geheugenproblemen ondervindt tijdens het synchroniseren van clients, controleer dan eerst of Linux daadwerkelijk een Synapse-proces heeft beëindigd en meet vervolgens het geheugengebruik tijdens een normale /_matrix/client/v3/syncbelasting. Als de oorzaak een groeiende cache is, pas de cache dan enigszins aan in plaats van direct een extreem lage limiet in te stellen; trage databasereacties kunnen een opeenhoping van aanvragen veroorzaken die het probleem verergert.
Volgens de officiële releasegeschiedenis van Synapse is versie 1.162.0 (29 september) per 10 oktober 2026 de meest recente stabiele release en 1.163.0rc1 een prerelease. Het is verstandig om een verouderde installatie bij te werken, maar een releasenummer alleen biedt geen diagnose of garantie voor een oplossing voor geheugenuitputting als gevolg van synchronisatieproblemen.
Clients die eindeloos synchroniseren, een gatewayfout vertonen of een verbroken sessie hebben, veroorzaken op zichzelf geen OOM-gebeurtenis (Out of Memory). Controleer op een typische Linux systemd-installatie het kernel- en servicelogboek rond het tijdstip waarop de client vastliep:
sudo journalctl -k --since "1 hour ago" | grep -Ei 'oom|out of memory|killed process'
sudo journalctl -u matrix-synapse --since "1 hour ago" --no-pager
Zoek naar een kernel OOM-killerbericht waarin een Synapse- of Python-proces wordt genoemd, een systemd-status zoals oom-killof een Python-fout MemoryError. Deze duiden op verschillende faalmechanismen: de kernel kan een proces beëindigen wanneer een geheugenlimiet van de host of container wordt bereikt, terwijl een fout MemoryErrorbinnen Python kan optreden vóór een systeemwijde OOM-kill. De servicenaam verschilt per pakket; vervang deze door de naam van uw eigen unit of container.
Registreer vervolgens de hostdruk en de grootste processen tijdens het reproduceren van een normale synchronisatie:
free -h
ps -eo pid,rss,%mem,args --sort=-rss | head -n 12
systemctl show matrix-synapse -p MemoryCurrent -p MemoryMax
RSSHet residentiële geheugen wordt in kilobytes gemeten, dit is geen precieze maatstaf voor het unieke applicatiegeheugen; gedeelde pagina's kunnen in meerdere processen voorkomen. Controleer in Docker ook docker statsde geconfigureerde geheugenlimiet van de container. Als PostgreSQL, Redis en meerdere Synapse-workers de host delen, beoordeel dan hun gecombineerde geheugenverbruik in plaats van alleen het hoofdproces van Synapse de schuld te geven.
Synapse bewaart bewust recente gebeurtenissen en kamergegevens in het geheugen om synchronisatieverzoeken snel af te handelen. De caches.global_factorstandaardwaarde is 0.5; het verlagen van deze factor verkleint over het algemeen de cache, maar verhoogt de kans op meer databasewerk. De Synapse-beheerders-FAQ waarschuwt dat een te kleine cache op trage opslag kan leiden tot een opeenhoping van verzoeken en een nog hoger geheugenverbruik.
Maak een back-up van de actieve configuratie homeserver.yaml, controleer of er een bestaand caches:blok is en wijzig alleen de relevante waarden. Dit is een testconfiguratie voor een instantie die een toenemend cachegebruik vertoont, geen universeel afstemmingsdoel:
caches:
global_factor: 0.3
sync_response_cache_duration: 1m
De cache-instelling voor synchronisatiereacties bepaalt hoe lang voltooide /syncresultaten in de cache blijven; Synapse documenteert een 2mstandaardwaarde. Een kortere periode kan het aantal bewaarde reacties verminderen, maar kan ook de werkdruk verhogen voor clients met intermitterende verbindingen. Voeg geen tweede caches:sleutel toe als er al een bestaat. Als uw installatie deze instelling SYNAPSE_CACHE_FACTORin de service- of containeromgeving heeft, heeft die variabele voorrang op de YAML-factor.
Valideer het bestand met de Python-omgeving die door uw Synapse-installatie wordt gebruikt en pas het configuratiepad indien nodig aan:
python -m synapse.config -c /etc/matrix-synapse/homeserver.yaml
Start de server pas opnieuw op na validatie. Voor systemd-pakketten in Debian-stijl is dit vaak nodig sudo systemctl restart matrix-synapse; containerimplementaties gebruiken hun eigen orchestratie. Controleer direct daarna het servicelogboek op configuratiefouten. De Synapse-configuratiehandleiding beschrijft ook het herladen van cachefactoren met SIGHUP, maar dat impliceert niet dat andere instellingen, waaronder het bewaren van synchronisatiereacties, ook herladen kunnen worden. Een gecontroleerde herstart is duidelijker wanneer beide worden gewijzigd.
Als het geheugen blijft toenemen terwijl clients vastlopen, kan het verder verlagen van de caches contraproductief zijn. Vergelijk de timing van de stijgende RSS met de CPU-belasting, schijf-I/O en databaseactiviteit. Een overbelaste server of trage PostgreSQL-query's kunnen leiden tot meer gelijktijdige, lopende verzoeken, die elk gegevens kunnen vasthouden totdat ze zijn voltooid.
Controleer eerst of de database reageert en of de schijfruimte en I/O in orde zijn. Productieomgevingen van Synapse zijn ontworpen voor PostgreSQL in plaats van SQLite, zoals beschreven in de Synapse-configuratiehandleiding . Als het een oudere SQLite-instantie betreft, plan dan een ondersteunde databasemigratie met een geteste back-up; probeer geen live databasewissel als noodoplossing voor geheugenproblemen.
Als u global_factorde waarde eerder extreem hebt verlaagd en de synchronisatievertraging is verslechterd, herstel dan de eerdere waarde of test een iets hogere instelling en houd daarbij zowel de reactietijden als het totale geheugen in de gaten. In de FAQ voor Synapse-beheerders wordt expliciet vermeld dat meer cache kan helpen wanneer trage backends wachtrijen veroorzaken. Er bestaat geen veilige, vaste RAM-doelwaarde die geschikt is voor elk aantal kamers, federatiebelasting en implementatieconfiguratie.
Bij een drukke implementatie met meerdere processen is het belangrijk om te bepalen of het hoofdproces of een specifieke synchronisatieworker groeit. Workers zorgen ervoor dat het synchronisatieverkeer van de client verdeeld wordt, maar elke worker heeft ook geheugen nodig. Het toevoegen van workers zonder extra capaciteit kan de geheugenproblemen van de host verergeren. Volg de Synapse worker-documentatie in plaats van clientverzoeken naar willekeurige workers te routeren zonder de vereiste gedeelde configuratie.
Op een systeem waar een geschikte jemalloc-configuratie al wordt ondersteund en geverifieerd, biedt Synapse de mogelijkheid om dit te doen cache_autotuning. Het vereist alle drie de gedocumenteerde waarden max_cache_memory_usage— , target_cache_memory_usage, en min_cache_ttl— en gebruikt cache-eviction om het cachegebruik rond een streefwaarde te houden. De volgende cijfers zijn illustratief en moeten worden aangepast om ruimte te laten voor Python, de database, andere services en pieken in het aantal actieve verzoeken:
caches:
cache_autotuning:
max_cache_memory_usage: 512M
target_cache_memory_usage: 384M
min_cache_ttl: 5m
Voeg dit blok samen met de bestaande cache-instellingen in plaats van ze te vervangen. Deze getallen zijn cachebudgetten, geen RSS-limieten voor processen ; het gebruik ervan garandeert niet dat het proces onder de 512 MiB blijft. De Synapse-configuratiehandleiding vereist jemalloc voor deze functie, en de Synapse-beheerders-FAQ waarschuwt dat de allocator van Python de boekhouding van jemalloc kan verstoren, waardoor mogelijk een aanpassing nodig is PYTHONMALLOC=malloc. Omdat de preload-paden en pakketten van allocators variëren, dient u de daadwerkelijke bibliotheek en opstartomgeving van uw implementatie te controleren voordat u wijzigingen aanbrengt LD_PRELOAD. Kopieer niet blindelings een architectuurspecifiek bibliotheekpad.
Voer na elke afzonderlijke wijziging dezelfde realistische clientactiviteit uit die eerder de fout veroorzaakte: maak opnieuw verbinding met een bestaande client, sta een eerste synchronisatie toe waar mogelijk en wacht tot een aantal normale incrementele synchronisaties zijn voltooid. Registreer de piek-RSS van alle Synapse-processen, de swapactiviteit, de responsiviteit van de database en of de kernel een nieuwe OOM-gebeurtenis registreert. Een korte dip direct na een herstart is geen bewijs van een duurzame oplossing; caches starten van nature leeg.
Als monitoring is ingeschakeld, vergelijk dan het geheugengebruik van processen en het aanvraaggedrag in de loop van de tijd met behulp van het metrics-eindpunt van Synapse. De Synapse-monitoringdocumentatie legt uit dat workers onafhankelijk metrics beschikbaar stellen en daarom afzonderlijk moeten worden gemonitord; houd metrics-eindpunten privé of beveiligd in plaats van interne gegevens openbaar te maken.
De wijziging werkte als clients de synchronisatie voltooien zonder herhaaldelijk opnieuw verbinding te maken, de logboeken geen nieuwe geheugenproblemen laten zien en het geheugen zich stabiliseert op een duurzaam niveau onder dezelfde werkbelasting. Als geheugenproblemen aanhouden ondanks een gezonde synchronisatielatentie en zorgvuldig afgestelde caches, is de volgende praktische stap het vergroten van het beschikbare RAM-geheugen of het verlagen van de werkbelasting per host, waarbij gebruik wordt gemaakt van gemeten piekverbruik in plaats van een willekeurig aanbevolen servergrootte.
Traceer M_FORBIDDEN naar het stroomniveau van de ruimte, het lidmaatschap of de Synapse-serverbeheerderstoegang en herstel vervolgens alleen de machtiging die de geblokkeerde actie nodig heeft.
Configureer Synapse discovery, HTTPS en proxy routing zodat andere Matrix homeservers uw server kunnen vinden en ermee in contact kunnen komen.
Configureer een Keycloak OIDC-client en een Synapse-provider zodat Element Web-gebruikers zich kunnen aanmelden via uw identiteitsserver zonder clientgeheimen prijs te geven.
Sla een herstelsleutel op, verifieer uw Element-sessies en controleer of versleutelde berichtsleutels kunnen worden hersteld zonder de back-up te verwarren met uw accountwachtwoord.
Diagnoseer geheugenproblemen bij Synapse tijdens synchronisatie, pas de caching veilig aan, identificeer achterstanden in aanvragen en controleer of het geheugengebruik stabiel is.
Traceer Matrix-federatiecertificaatfouten naar de juiste server, herstel de TLS-keten of het CA-vertrouwen en verifieer de oplossing zonder de beveiligingscontroles uit te schakelen.
Routeer Matrix-clients en federatie via Cloudflare op HTTPS 443, behoud Synapse-ontdekking en voorkom cachen van API-verkeer of problemen met media-uploads.
Maak een back-up van Synapse met pg_dump, bescherm de ondertekeningssleutel en de media, en herstel de back-up in een schone PostgreSQL-database zonder verouderde eenmalige sleutels opnieuw te gebruiken.
Configureer Mjölnir met een speciaal Matrix-account, een versleutelde beheerruimte, Docker Compose, een beleidslijst en toegangsrechtencontroles.
Sla de verouderde proxy over en configureer Synapse's ingebouwde Sliding Sync. Controleer de clientdetectie en meet vervolgens het laadgedrag van de kamerlijst en het herverbindingsgedrag op een compatibele telefoon.