Home
» Hoe
»
Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.
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:
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
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.
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.
Controleer het antwoord van de openbare homeserver op de native simplified_msc3575-functionaliteit.
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.