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 :

Terminal affichant la commande Docker Compose permettant de récupérer l'image Synapse.
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
Terminal affichant la commande Docker Compose permettant de recréer le service 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.

Éditeur YAML affichant experimental_features avec msc3575_enabled défini sur true.
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é.

Terminal avec une commande curl et jq qui lit la capacité simplifiée du MSC3575 à partir du point de terminaison des versions publiques de Matrix.
Vérifiez la réponse du serveur d'accueil public pour la capacité native simplified_msc3575.
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.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.

Laisser un commentaire

Restaurez Matrix Synapse en toute sécurité à l'aide d'une sauvegarde PostgreSQL.

Sauvegardez Synapse avec pg_dump, protégez sa clé de signature et son support, et restaurez-le dans une base de données PostgreSQL propre sans réutiliser de clés à usage unique obsolètes.

Exécutez Mjölnir comme bot de modération de salle Matrix avec Docker

Exécutez Mjölnir comme bot de modération de salle Matrix avec Docker

Configurez Mjölnir avec un compte Matrix dédié, une salle de gestion chiffrée, Docker Compose, une liste de politiques et des contrôles d'autorisation.

Activez la synchronisation matricielle native pour un chargement mobile plus rapide

Activez la synchronisation matricielle native pour un chargement mobile plus rapide

Ignorez le proxy obsolète et configurez la synchronisation glissante intégrée de Synapse. Vérifiez la détection des clients, puis mesurez le chargement de la liste des salons et le comportement de reconnexion sur un téléphone compatible.

Hébergement Web Element sur Nginx avec un serveur d'accueil personnalisé

Déployez Element Web en tant que site statique, pointez-le vers votre serveur d'accueil Matrix, ajoutez HTTPS et configurez Nginx pour servir les mises à jour sans fichiers obsolètes.

Exécutez un serveur domestique Matrix léger sur Raspberry Pi 4

Configurer Conduit sur un Raspberry Pi 4 64 bits avec des données persistantes, une fédération HTTPS, un enregistrement protégé et des vérifications pour un serveur domestique fonctionnel.

Configurez un alias Matrix Room personnalisé sur votre propre domaine

Attribuez à une salle Matrix une adresse facile à partager sur votre domaine en utilisant Element ou l'API Matrix, avec vérification des autorisations, nommage Synapse et fédération.

Configurer coturn pour des appels vocaux et vidéo fiables avec Matrix

Configurez coturn et Synapse avec les identifiants TURN correspondants, ouvrez les ports de relais requis et vérifiez que les clients Matrix peuvent obtenir des candidats relais.

Déploiement de Matrix Synapse avec Docker Compose et PostgreSQL

Déploiement de Matrix Synapse avec Docker Compose et PostgreSQL

Configurez un serveur Synapse persistant avec Docker Compose, PostgreSQL, une configuration privée et des vérifications avant de l'exposer via HTTPS.

Personnalisez le thème et l'image de marque d'Element Web

Définissez un nom de marque, des couleurs personnalisées et des éléments de connexion pour votre déploiement Element Web tout en identifiant les éléments qui restent de marque Element.

Augmenter la limite de fichiers systemd de Synapse sans tâtonnement

Augmenter la limite de fichiers systemd de Synapse sans tâtonnement

Déterminez si Synapse a atteint sa limite de fichiers ouverts par processus, configurez un module systemd pour le service ou le processus approprié et vérifiez la limite en temps réel.