Accueil
» Comment faire
»
Activez la synchronisation matricielle native pour un chargement mobile plus rapide
Activez la synchronisation matricielle native pour un chargement mobile plus rapide
Pour une version actuelle du client mobile Matrix, n'ajoutez pas l'ancien proxy Sliding Sync autonome à Docker Compose. Ce proxy a été archivé en novembre 2025 ; Synapse intègre nativement la synchronisation glissante simplifiée, activée par défaut depuis la version 1.114. Mettez à jour Synapse vers une version compatible, vérifiez que la fonctionnalité native est accessible aux clients via votre URL publique et mesurez la charge sur un client compatible.
Qu'est-ce qui a changé, et de quoi avez-vous besoin ?
À l'origine, le terme « synchronisation glissante » désignait l'implémentation proxy de MSC3575, qui s'exécutait en amont de Synapse et nécessitait un service et une configuration de découverte distincts. La spécification Matrix a évolué : MSC4186, la synchronisation glissante simplifiée, a remplacé cette conception. Le dépôt proxy officiel est archivé et indique que les clients modernes ne sont plus censés fonctionner avec celui-ci. Synapse a intégré la prise en charge native de MSC3575 et MSC4186 et l'a activée par défaut à partir de la version 1.114.0, comme indiqué dans le journal des modifications de Synapse .
Ce guide suppose que Synapse est déjà installé avec Docker Compose et accessible via une URL HTTPS publique https://matrix.example.org. Vous devez disposer d'un accès shell au projet Compose, d'un moyen de modifier son étiquette d'image et la configuration de son serveur d'accueil, ainsi que d'une application mobile dont la version actuelle prend en charge la synchronisation glissante native. Si vous souhaitez uniquement un chargement initial plus rapide sur un client ne prenant pas en charge cette fonctionnalité, l'ajout d'un proxy ne permettra pas à ce client de l'utiliser.
Préparez une mise à jour Synapse sécurisée
Utilisez une version de Synapse actuellement maintenue plutôt que de limiter une nouvelle installation aux fonctionnalités minimales requises. Consultez les versions officielles de Synapse et les notes de mise à niveau de la version actuelle. Sauvegardez la base de données et les volumes de données/configuration Synapse avant la mise à niveau et vérifiez si les notes prévoient des étapes intermédiaires. Ceci est particulièrement important pour les anciennes installations : l’ avis de sécurité de Synapse concernant une vulnérabilité de synchronisation glissante (Sliding Sync) mentionne les versions concernées jusqu’à la version 1.120.0 et corrige le problème dans la version 1.120.1. Choisissez une version prise en charge et intégrant les correctifs les plus récents, et non pas simplement la première version corrigée.
Dans votre fichier Compose, identifiez la clé de service de Synapse et l'étiquette d'image associée. Si l'étiquette pointe vers une ancienne version, remplacez-la par la version compatible que vous avez sélectionnée. Ensuite, récupérez et recréez uniquement ce service ; remplacez les informations synapseci-dessous si votre service porte un autre nom :
Récupérez l'image Synapse après avoir mis à jour son étiquette avec la version sélectionnée pour votre déploiement.
docker compose pull synapse
Recréez le service Synapse pour que Compose exécute l'image sélectionnée.
docker compose up -d synapse
docker compose logs --tail=100 synapse
Avant de poursuivre, vérifiez les journaux pour détecter les erreurs de démarrage et vous assurer que la mise à niveau de la base de données est terminée. En cas d'échec du démarrage, n'effectuez pas de retour à une version antérieure sans consulter les instructions de mise à niveau spécifiques à votre version et restaurez une sauvegarde uniquement à l'aide de la procédure de récupération appropriée à votre base de données.
Vérifiez que la synchronisation coulissante native est activée.
Synapse active généralement la synchronisation glissante native par défaut ; une nouvelle installation ne nécessite donc souvent aucun fichier YAML supplémentaire. Ce paramètre conserve l’ancien nom MSC, ce qui peut prêter à confusion : il contrôle l’implémentation native de Synapse et ne correspond pas à une demande d’exécution du proxy obsolète. Vérifiez homeserver.yamlsi la valeur « false » est explicitement présente dans votre configuration. Si c’est le cas, modifiez-la dans le bloc de fonctionnalités existant.
Si votre configuration Synapse désactive explicitement cette fonctionnalité, activez-la dans le bloc experimental_features existant.
experimental_features:
msc3575_enabled: true
Si experimental_featuresle bloc existe déjà, modifiez-le plutôt que d'ajouter une clé YAML en double. Si le paramètre est absent ou déjà défini, ne le modifiez pas. Recréez le service Synapse après toute modification de configuration et consultez ses journaux. Une erreur d'indentation YAML peut empêcher le démarrage de Synapse.
Supprimez le chemin proxy obsolète et testez la découverte
Examinez le JSON servi à l'adresse indiquée https://matrix.example.org/.well-known/matrix/client. S'il contient l'ancienne org.matrix.msc3575.proxypropriété, supprimez-la tout en conservant les entrées de découverte client non liées. Supprimez également toute règle de proxy inverse qui envoie les requêtes du client Matrix vers le proxy obsolète ; le /_matrix/client/chemin API standard doit atteindre Synapse. N'ajoutez pas de nouveau port de proxy et ne publiez pas d'URL de proxy pour le MSC4186 natif. Conservez toutes les autres valeurs connues, y compris l'URL de votre serveur d'accueil, conformément à votre configuration.
Depuis une machine pouvant accéder au serveur d'accueil public, interrogez le point de terminaison des versions client-serveur. Cela permet de vérifier les services réellement découverts par les clients, et non pas seulement un conteneur sur le réseau Docker privé.
Vérifiez la réponse du serveur d'accueil public pour la capacité native simplified_msc3575.
Pour une version de Synapse avec prise en charge native activée et un point de terminaison correctement routé, cette requête devrait afficher un résultat true. Si jqce résultat est indisponible, exécutez la curlrequête sans le paramètre « || » et examinez le champ JSON. Une valeur manquante ou fausse indique un problème : vérifiez que le DNS et le HTTPS atteignent le serveur attendu, que le proxy inverse transmet le chemin de l’API client à Synapse, que l’image en cours d’exécution correspond à la version sélectionnée et qu’aucune configuration explicite ne désactive la fonctionnalité. Ne divulguez pas les jetons d’accès lors du partage des résultats de diagnostic ; cette requête de versions publiques n’en nécessite pas.
Jugez le résultat sur un téléphone compatible
Connectez-vous ou reconnectez-vous avec une version cliente compatible avec le protocole natif, en utilisant le même compte et le même téléphone que ceux utilisés pour la comparaison. Si possible, enregistrez une configuration de référence avant de changer de serveur. Comparez un démarrage à froid de l'application après avoir effacé ou recréé les données locales uniquement si vous comprenez que cela supprime le contenu mis en cache ; comparez ensuite les démarrages à chaud habituels et une reconnexion après une période hors ligne du téléphone. Veillez à ce que le réseau, le compte, la salle et la méthode de test restent les mêmes.
Mesurez le temps écoulé entre l'ouverture de l'application et le moment où la liste des chambres est utilisable, et non pas seulement jusqu'à la disparition de l'écran de démarrage.
Vérifiez si les noms des salons récents, le statut des messages non lus et les nouveaux messages apparaissent rapidement après la reconnexion.
Surveillez les journaux Synapse pour détecter les erreurs de point de terminaison, les tentatives répétées ou la pression sur le processus/la base de données pendant le même test.
Une première liste de salles s'affiche plus rapidement et la reconnexion se fait sans problème ; ce sont des signes concrets que le client utilise le chemin attendu. Il n'y a pas de gain de vitesse universel : l'implémentation du client et le cache local, la latence du réseau, les performances de la base de données, le nombre de salles du compte et la charge du serveur influent tous sur le résultat. La synchronisation glissante n'accélère pas non plus les téléchargements multimédias et ne répare pas une base de données surchargée. Si le test de compatibilité réussit mais que l'application reste lente, comparez-la avec un autre client compatible et identifiez les goulots d'étranglement avant de modifier les paramètres du proxy ou du cache. Si vous utilisez encore d'anciens clients qui dépendent du proxy MSC3575 obsolète, testez leur compatibilité séparément avant de supprimer leur ancien chemin de découverte ; ne partez pas du principe qu'un seul point de terminaison est compatible avec toutes les générations de clients.