Startseite
» Gewusst wie
»
Aktivieren Sie die native Matrix-Gleitsynchronisierung für schnelleres Laden auf Mobilgeräten.
Aktivieren Sie die native Matrix-Gleitsynchronisierung für schnelleres Laden auf Mobilgeräten.
Fügen Sie für einen aktuellen Matrix-Mobilclient den alten, eigenständigen Sliding-Sync-Proxy nicht zu Docker Compose hinzu. Der Proxy wurde im November 2025 archiviert; Synapse bietet selbst natives, vereinfachtes Sliding Sync, das seit Synapse 1.114 standardmäßig aktiviert ist. Aktualisieren Sie Synapse auf eine unterstützte Version, prüfen Sie, ob die native Funktion über Ihre öffentliche URL erreichbar ist, und messen Sie die Auslastung auf einem Client, der diese Funktion unterstützt.
Was hat sich geändert und was brauchen Sie?
„Sliding Sync“ bezeichnete ursprünglich die Proxy-Implementierung von MSC3575, die vor Synapse geschaltet war und separate Dienst- und Erkennungseinstellungen benötigte. Die Matrix-Spezifikation wurde weiterentwickelt: MSC4186, Simplified Sliding Sync, ersetzte dieses Design. Das offizielle Proxy-Repository ist archiviert und gibt an, dass moderne Clients nicht mehr damit kompatibel sein sollen. Synapse hat native Unterstützung für MSC3575 und MSC4186 hinzugefügt und diese ab Version 1.114.0 standardmäßig aktiviert, wie im Synapse-Changelog dokumentiert .
Diese Anleitung setzt voraus, dass Synapse bereits mit Docker Compose hinter einer öffentlichen HTTPS-URL wie z. B. ausgeführt wird https://matrix.example.org. Sie benötigen Shell-Zugriff auf das Compose-Projekt, eine Möglichkeit, dessen Image-Tag und Homeserver-Konfiguration zu bearbeiten, sowie eine mobile App, deren aktuelle Version natives Sliding Sync unterstützt. Wenn Sie lediglich einen schnelleren Start auf einem Client wünschen, der diese Funktion nicht unterstützt, wird das Hinzufügen eines Proxys diese Funktion auf diesem Client nicht aktivieren.
Bereiten Sie ein sicheres Synapse-Update vor.
Verwenden Sie eine aktuell unterstützte Synapse-Version, anstatt eine neue Installation auf den minimalen Funktionsumfang einer älteren Version festzulegen. Prüfen Sie die offiziellen Synapse-Versionen und die Upgrade-Hinweise für die Version, von der Sie aktualisieren. Sichern Sie vor dem Upgrade die Datenbank und die Synapse-Daten-/Konfigurationsvolumes und prüfen Sie, ob in den Hinweisen Zwischenschritte für das Upgrade vorgesehen sind. Dies ist insbesondere bei älteren Installationen wichtig: Die Sicherheitswarnung von Synapse zu einer Schwachstelle im Raumstatus von Sliding Sync listet betroffene Versionen bis einschließlich v1.120.0 auf und behebt das Problem in v1.120.1. Wählen Sie eine aktuell unterstützte Version mit neueren Korrekturen und nicht nur die erste gepatchte Version.
Identifizieren Sie in Ihrer Compose-Datei den Dienstschlüssel für Synapse und das zugehörige Image-Tag. Falls das Tag auf eine ältere Version verweist, ändern Sie es in die von Ihnen ausgewählte unterstützte Version. Laden Sie anschließend nur diesen Dienst herunter und erstellen Sie ihn neu. Ersetzen Sie synapseden unten stehenden Namen, falls Ihr Dienst einen anderen Namen hat:
Laden Sie das Synapse-Image herunter, nachdem Sie dessen Tag auf die für Ihre Bereitstellung ausgewählte Version aktualisiert haben.
docker compose pull synapse
Der Synapse-Dienst wird neu erstellt, damit Compose das ausgewählte Image ausführt.
docker compose up -d synapse
docker compose logs --tail=100 synapse
Prüfen Sie vor dem Fortfahren die Protokolle auf Startfehler und ein abgeschlossenes Datenbank-Upgrade. Führen Sie kein Downgrade ohne vorherige Prüfung durch, wenn der Start fehlschlägt. Beachten Sie stattdessen die versionsspezifischen Upgrade-Richtlinien und stellen Sie eine Sicherung nur mit dem für Ihre Datenbank geeigneten Wiederherstellungsprozess wieder her.
Prüfen Sie, ob die native Gleitsynchronisierung aktiviert ist.
Synapse aktiviert normalerweise standardmäßig die native Sliding-Sync-Funktion, daher ist bei einer Neuinstallation oft keine zusätzliche YAML-Konfiguration erforderlich. Die Einstellung behält den älteren Namen „MSC“ bei, was verwirrend sein kann: Sie steuert die native Implementierung von Synapse und fordert nicht die Ausführung des veralteten Proxys an. Prüfen Sie Ihre bestehende Konfiguration homeserver.yamlauf den expliziten Wert „false“. Falls Sie einen solchen Wert finden, ändern Sie ihn im entsprechenden Feature-Block.
Falls Ihre Synapse-Konfiguration die Funktion explizit deaktiviert, aktivieren Sie sie im vorhandenen experimentellen Funktionsblock.
experimental_features:
msc3575_enabled: true
Falls experimental_featuresder entsprechende Block bereits existiert, bearbeiten Sie ihn, anstatt einen doppelten YAML-Schlüssel hinzuzufügen. Ist die Einstellung nicht vorhanden oder bereits aktiviert, lassen Sie sie unverändert. Starten Sie den Synapse-Dienst nach einer Konfigurationsänderung neu und überprüfen Sie die Protokolle. Ein Fehler in der YAML-Einrückung kann den Start von Synapse verhindern.
Entfernen Sie den deaktivierten Proxy-Pfad und testen Sie die Erkennung.
Prüfen Sie die unter [URL] bereitgestellte JSON-Datei https://matrix.example.org/.well-known/matrix/client. Falls sie die alte Eigenschaft enthält org.matrix.msc3575.proxy, entfernen Sie diese, wobei Sie alle nicht zugehörigen Client-Erkennungseinträge beibehalten. Entfernen Sie außerdem alle Reverse-Proxy-Regeln, die Matrix-Client-Anfragen an den deaktivierten Proxy senden; der Standard /_matrix/client/-API-Pfad muss Synapse erreichen. Fügen Sie keinen neuen Proxy-Port hinzu und veröffentlichen Sie keine Proxy-URL für den nativen MSC4186. Behalten Sie alle anderen bekannten Werte, einschließlich Ihrer Homeserver-URL, wie in Ihrer Konfiguration erforderlich, bei.
Von einem Rechner aus, der den öffentlichen Homeserver erreichen kann, kann der Client-Server-Versionsendpunkt abgefragt werden. Dadurch wird überprüft, welcher Dienst von den Clients tatsächlich erkannt wird, und nicht nur ein Container im privaten Docker-Netzwerk:
Prüfen Sie die öffentliche Homeserver-Antwort auf die native simplified_msc3575-Funktionalität.
Bei einer Synapse-Version mit aktivierter nativer Unterstützung und einem korrekt gerouteten Endpunkt sollte dies eine Fehlermeldung ausgeben true. Falls jqdiese nicht verfügbar ist, führen Sie die curlAnfrage ohne Pipe aus und überprüfen Sie das JSON-Feld. Ein fehlender oder falscher Wert ist ein hilfreiches Fehlersignal: Stellen Sie sicher, dass DNS und HTTPS den erwarteten Server erreichen, dass der Reverse-Proxy den Client-API-Pfad an Synapse weiterleitet, dass das verwendete Image der von Ihnen ausgewählten Version entspricht und dass keine explizite Konfiguration die Funktion deaktiviert. Geben Sie beim Teilen von Diagnoseausgaben keine Zugriffstoken preis; diese öffentliche Versionsanfrage benötigt keins.
Überprüfen Sie das Ergebnis auf einem kompatiblen Telefon.
Melden Sie sich mit einer Clientversion an oder stellen Sie die Verbindung wieder her, die das native Protokoll unterstützt. Verwenden Sie dabei dasselbe Konto und dasselbe Telefon, das Sie auch für den Vergleich nutzen. Erstellen Sie nach Möglichkeit vor einem Serverwechsel eine Basislinie. Vergleichen Sie einen Kaltstart der App nach dem Löschen oder Neuerstellen lokaler App-Daten nur dann, wenn Sie wissen, dass dadurch zwischengespeicherte Inhalte entfernt werden. Vergleichen Sie anschließend normale Warmstarts und eine Wiederverbindung, nachdem das Telefon offline war. Achten Sie darauf, dass Netzwerk, Konto, Raum und Testmethode einheitlich bleiben.
Messen Sie die Zeit vom Öffnen der App bis zur Nutzbarkeit der Raumliste, nicht nur bis zum Verschwinden des Startbildschirms.
Prüfen Sie, ob nach dem erneuten Verbinden umgehend die Namen der zuletzt aufgerufenen Räume, der Status „ungelesen“ und neue Nachrichten angezeigt werden.
Überprüfen Sie die Synapse-Protokolle auf Endpunktfehler, wiederholte Wiederholungsversuche oder Worker-/Datenbankauslastung während desselben Tests.
Eine schnellere Anzeige der ersten Raumliste und ein reibungsloser Verbindungsaufbau nach der Wiederverbindung sind praktische Anzeichen dafür, dass der Client den erwarteten Pfad nutzt. Es gibt keinen universellen Geschwindigkeitsvorteil: Client-Implementierung und lokaler Cache, Netzwerklatenz, Datenbankleistung, Anzahl der Räume pro Konto und Serverlast beeinflussen das Ergebnis. Sliding Sync beschleunigt auch keine Mediendownloads und behebt keine Datenbanküberlastung. Wenn die Funktionsprüfung erfolgreich ist, die App aber weiterhin langsam läuft, vergleichen Sie sie mit einem anderen unterstützten Client und untersuchen Sie die Engpässe, bevor Sie Proxy- oder Cache-Einstellungen ändern. Wenn Sie noch ältere Clients verwenden, die auf dem veralteten MSC3575-Proxy basieren, testen Sie deren Kompatibilität separat, bevor Sie den alten Erkennungspfad entfernen. Gehen Sie nicht davon aus, dass ein einziger Endpunkt für alle Client-Generationen geeignet ist.