Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Voeg voor een huidige Matrix mobiele client de oude, zelfstandige Sliding Sync Proxy niet toe aan Docker Compose. De proxy is in november 2025 gearchiveerd; Synapse biedt nu zelf native Simplified Sliding Sync aan, dat standaard is ingeschakeld sinds Synapse 1.114. Update Synapse naar een ondersteunde versie, controleer of de native functionaliteit clients bereikt via uw openbare URL en meet de laadtijd op een client die dit ondersteunt.

Wat is er veranderd en wat heb je nodig?

"Sliding Sync" verwees oorspronkelijk naar de proxy-implementatie van MSC3575, die vóór Synapse werd geplaatst en een aparte service- en discovery-instelling vereiste. De Matrix-specificatie evolueerde: MSC4186, Simplified Sliding Sync, verving dat ontwerp. De officiële proxy-repository is gearchiveerd en geeft aan dat moderne clients er niet langer mee zouden moeten werken. Synapse heeft native ondersteuning voor MSC3575 en MSC4186 toegevoegd en deze standaard ingeschakeld vanaf versie 1.114.0, zoals vermeld in het Synapse-changelog .

Deze handleiding gaat ervan uit dat Synapse al draait met Docker Compose achter een openbare HTTPS-URL, zoals https://matrix.example.org. Je hebt shelltoegang nodig tot het Compose-project, een manier om de imagetag en de homeserver-configuratie te bewerken, en een mobiele app waarvan de huidige versie native Sliding Sync ondersteunt. Als je alleen een snellere initiële laadtijd wilt in een client die dit niet ondersteunt, zal het toevoegen van een proxy er niet voor zorgen dat die client de functie gaat gebruiken.

Bereid een veilige Synapse-update voor.

Gebruik een actuele Synapse-release in plaats van een nieuwe implementatie te baseren op de historische minimale functionaliteit. Bekijk de officiële Synapse-releases en de upgrade-instructies voor de versie waarvan u overstapt. Maak een back-up van de database en de Synapse-data-/configuratievolumes voordat u de upgrade uitvoert en controleer of de instructies tussentijdse upgradestappen vereisen. Dit is vooral belangrijk bij oudere installaties: het beveiligingsadvies van Synapse voor een probleem met de Sliding Sync-ruimtestatus vermeldt getroffen releases tot en met v1.120.0 en lost het probleem op in v1.120.1. Kies een actuele, ondersteunde release met recente oplossingen, niet alleen de eerste gepatchte versie.

Identificeer in uw Compose-bestand de servicesleutel voor Synapse en de bijbehorende imagetag. Als de tag is gekoppeld aan een oude versie, wijzig deze dan naar de ondersteunde release die u hebt geselecteerd. Haal vervolgens alleen die service op en maak deze opnieuw aan; vervang synapseonderstaande code als uw service een andere naam heeft:

Terminal met het Docker Compose-commando om de Synapse-image op te halen.
Download de Synapse-image nadat u de tag ervan hebt bijgewerkt naar de release die u voor uw implementatie hebt geselecteerd.
docker compose pull synapse
Terminal met de Docker Compose-opdracht om de Synapse-service opnieuw aan te maken.
Herstel de Synapse-service zodat Compose de geselecteerde image uitvoert.
docker compose up -d synapse
docker compose logs --tail=100 synapse

Controleer de logbestanden op opstartfouten en een voltooide database-upgrade voordat u verdergaat. Voer geen downgrade zonder overleg uit als het opstarten mislukt; raadpleeg de versiespecifieke upgrade-instructies en herstel een back-up alleen met behulp van de herstelprocedure die geschikt is voor uw database.

Controleer of native Sliding Sync is ingeschakeld.

Synapse schakelt standaard native Sliding Sync in, dus bij een nieuwe installatie is vaak geen extra YAML nodig. De instelling behoudt de oudere MSC-naam, wat verwarrend kan zijn: het regelt de native implementatie van Synapse en is geen verzoek om de verouderde proxy te gebruiken. Controleer of er homeserver.yamleen expliciete 'false'-waarde in uw bestaande configuratie staat. Als u die vindt, wijzig deze dan in het bestaande feature-blok.

YAML-editor die experimental_features weergeeft met msc3575_enabled ingesteld op true.
Als de functionaliteit in je Synapse-configuratie expliciet is uitgeschakeld, schakel deze dan in binnen het bestaande experimental_features-blok.
experimental_features:
  msc3575_enabled: true

Als experimental_featureshet al bestaat, bewerk dat blok dan in plaats van een dubbele YAML-sleutel toe te voegen. Als de instelling ontbreekt of al waar is, laat deze dan ongewijzigd. Maak de Synapse-service opnieuw aan na een configuratiewijziging en controleer de logbestanden. Een inspringfout in YAML kan voorkomen dat Synapse start.

Verwijder het buiten gebruik gestelde proxypad en test de detectie.

Controleer de JSON die wordt aangeboden op https://matrix.example.org/.well-known/matrix/client. Als deze de oude org.matrix.msc3575.proxyeigenschap bevat, verwijder deze dan, maar behoud de niet-gerelateerde client discovery-vermeldingen. Verwijder ook alle reverse-proxy-regels die Matrix-clientverzoeken naar de buiten gebruik gestelde proxy sturen; het standaard /_matrix/client/API-pad moet Synapse bereiken. Voeg geen nieuwe proxypoort toe en adverteer geen proxy-URL voor native MSC4186. Behoud alle andere bekende waarden, inclusief uw homeserver-URL, zoals vereist door uw configuratie.

Vanaf een machine die de openbare thuisserver kan bereiken, kunt u het Client-Server-versie-eindpunt raadplegen. Hiermee wordt gecontroleerd welke service clients daadwerkelijk detecteren, in plaats van alleen een container op het privé Docker-netwerk te controleren.

Terminal met een curl- en jq-commando dat de vereenvoudigde MSC3575-functionaliteit uitleest van het openbare Matrix-versie-eindpunt.
Controleer het antwoord van de openbare homeserver op de native simplified_msc3575-functionaliteit.
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'

Voor een Synapse-release met native ondersteuning ingeschakeld en een correct gerouteerd eindpunt, zou dit moeten worden afgedrukt true. Als jqniet beschikbaar is, voer dan het curlverzoek uit zonder de pipe en inspecteer het JSON-veld. Een ontbrekende of onjuiste waarde is een nuttig foutsignaal: controleer of DNS en HTTPS de verwachte server bereiken, of de reverse proxy het API-pad van de client doorgeeft aan Synapse, of de actieve image de versie is die u hebt geselecteerd en of er geen expliciete configuratie is die de functie uitschakelt. Geef geen toegangstokens weer bij het delen van diagnostische uitvoer; dit verzoek voor openbare versies heeft er geen nodig.

Beoordeel het resultaat op een compatibele telefoon.

Meld u aan of maak opnieuw verbinding met een clientversie die het native protocol ondersteunt, met hetzelfde account en dezelfde telefoon die u voor de vergelijking zult gebruiken. Leg indien mogelijk een basislijn vast voordat u de server wijzigt. Vergelijk een koude start van de app na het wissen of opnieuw opbouwen van lokale app-gegevens alleen als u begrijpt dat dit de cachegegevens verwijdert; vergelijk vervolgens een normale warme start en een herverbinding nadat de telefoon offline is geweest. Houd het netwerk, het account, de kamerinstellingen en de testmethode consistent.

  • Meet de tijd vanaf het moment dat de app wordt geopend totdat de kamerslijst bruikbaar is, niet alleen totdat het opstartscherm verdwijnt.
  • Controleer of recente kamernamen, de ongelezen status en nieuwe berichten direct verschijnen nadat de verbinding opnieuw tot stand is gebracht.
  • Houd de Synapse-logboeken in de gaten voor eindpuntfouten, herhaalde pogingen of overbelasting van de worker/database tijdens dezelfde test.

Een snellere eerste lijst met kamers en een vlotte inhaalslag na herverbinding zijn praktische indicaties dat de client het verwachte pad gebruikt. Er is geen universele snelheidsverbetering: de clientimplementatie en lokale cache, netwerklatentie, databaseprestaties, het aantal kamers in het account en de serverbelasting hebben allemaal invloed op het resultaat. Sliding Sync versnelt ook geen mediadownloads en herstelt geen overbelaste database. Als de compatibiliteitscontrole slaagt, maar de app traag blijft, vergelijk dan met een andere ondersteunde client en onderzoek de knelpunten voordat u de proxy- of cache-instellingen wijzigt. Als u nog steeds oudere clients gebruikt die afhankelijk zijn van de uitgefaseerde MSC3575-proxy, test dan hun compatibiliteit afzonderlijk voordat u hun oude ontdekkingspad verwijdert; ga er niet vanuit dat één eindpunt alle clientgeneraties bedient.

Laat een reactie achter

Herstel Matrix Synapse veilig met een PostgreSQL-dump.

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.

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Configureer Mjölnir met een speciaal Matrix-account, een versleutelde beheerruimte, Docker Compose, een beleidslijst en toegangsrechtencontroles.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

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.

Element Web hosten op Nginx met een aangepaste homeserver

Implementeer Element Web als een statische site, verwijs deze naar uw Matrix-homeserver, voeg HTTPS toe en configureer Nginx om updates te leveren zonder verouderde bestanden.

Een lichtgewicht Matrix-homeserver draaien op een Raspberry Pi 4

Configureer Conduit op een 64-bits Raspberry Pi 4 met permanente dataopslag, HTTPS-federatie, beveiligde registratie en controles voor een werkende thuisserver.

Stel een aangepaste Matrix-ruimtealias in op uw eigen domein.

Geef een Matrix-ruimte een eenvoudig te delen adres op uw domein met behulp van Element of de Matrix API, inclusief controles op machtigingen, Synapse-naamgeving en federatie.

Stel coturn in voor betrouwbare Matrix-spraak- en videogesprekken.

Configureer coturn en Synapse met overeenkomende TURN-gegevens, open de vereiste relaypoorten en controleer of Matrix-clients relaykandidaten kunnen verkrijgen.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Zet een permanente Synapse-homeserver op met Docker Compose, PostgreSQL, een privéconfiguratie en controles voordat je deze via HTTPS beschikbaar stelt.

Het thema en de huisstijl van Element Web aanpassen

Stel een merknaam, aangepaste kleuren en inloggegevens in voor uw Element Web-implementatie, en zorg ervoor dat u weet welke onderdelen het Element-merk behouden.

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.