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

Utilisez le format de sauvegarde personnalisé de PostgreSQL pour votre base de données Synapse, excluez la table des clés à usage unique et restaurez les données dans une nouvelle base de données vide. La sauvegarde de la base de données seule ne constitue pas une sauvegarde complète de votre serveur : il est impératif de préserver également la configuration de Synapse, sa clé de signature et vos supports locaux. Les recommandations officielles de sauvegarde de Synapse, consultées le 10 octobre 2026, mettent en garde contre la restauration par-dessus des tables existantes et contre la restauration d'anciennes clés à usage unique de chiffrement de bout en bout.

Ce qu'une sauvegarde de base de données contient (et ne contient pas)

Vérifié : pg_dump crée un instantané cohérent tant que PostgreSQL reste en ligne ; Synapse n’a pas besoin d’être arrêté pendant la sauvegarde. Une sauvegarde de la base de données uniquement n’inclut pas les fichiers du magasin de médias de Synapse, homeserver.yamlles fichiers de configuration référencés ni la clé de signature du serveur. Conservez-les dans un ensemble de sauvegarde protégé distinct. Synapse identifie le contenu téléchargé localement et, lorsque les vignettes dynamiques sont désactivées, les vignettes locales comme des données à préserver. Les caches de médias distants et d’aperçu d’URL peuvent généralement être récupérés ou reconstruits.

Action : avant d’établir un plan de récupération, identifiez le nom de la base de données active, le rôle PostgreSQL, le répertoire de configuration Synapse, le chemin d’accès à la clé de signature et le chemin d’accès au stockage des médias. Utilisez les chemins d’accès configurés sur votre serveur ; ils varient selon le package, le conteneur et le déploiement.

Idée reçue : une sauvegarde SQL réussie ne garantit pas la restauration complète du serveur. Action : sauvegardez la base de données, la configuration, la clé de signature et les supports locaux nécessaires, et testez régulièrement leur restauration.

Créer et vérifier un dump au format personnalisé

Les commandes ci-dessous supposent un système Linux avec les outils en ligne de commande PostgreSQL installés, une base de données nommée `<nom_de_la_base_de_données>` synapseet les droits d'exécution des commandes PostgreSQL avec le postgrescompte système. Remplacez le nom de la base de données et les chemins d'accès par les valeurs de votre déploiement. Stockez la sauvegarde sur un support sécurisé disposant d'un espace libre suffisant ; elle peut contenir des messages privés et des données de compte.

  1. Créez la sauvegarde, en excluant le contenu de la table que Synapse indique ne pas devoir être rejouée à partir d'une sauvegarde plus ancienne :

    sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump

    -FcCette option sélectionne le format d'archive personnalisé de PostgreSQL, adapté pg_restoreet souvent plus compact que le SQL standard. L'exclusion affecte les données de la table ; elle ne supprime pas sa définition.

  2. Vérifiez que le fichier existe et qu'il n'est pas vide, puis listez la table des matières de l'archive :

    ls -lh /secure-backups/synapse.dump
    sudo -u postgres pg_restore --list /secure-backups/synapse.dump

    La présence de cette liste confirme que PostgreSQL peut lire la structure de l'archive ; elle ne garantit cependant pas que chaque ligne puisse être restaurée ni que les autres fichiers de sauvegarde soient complets. Pour des vérifications plus approfondies, copiez la sauvegarde sur un support de stockage distinct et vérifiez sa somme de contrôle après le transfert.

Idée reçue : il est souvent nécessaire d’arrêter Synapse pour chaque sauvegarde pg_dump. La page officielle de Synapse indique qu’une pg_dumpsauvegarde classique est cohérente sans avoir à arrêter Synapse ni PostgreSQL. Action : maintenez le service en ligne pour cette sauvegarde logique, mais prévoyez une fenêtre de maintenance pour une restauration complète.

Restaurer dans une base de données vide

La restauration est une opération de remplacement. Commencez par arrêter Synapse et tous les processus Synapse afin d'éviter toute connexion ou écriture sur la cible pendant la restauration. Vérifiez le nom de la base de données cible et sa sauvegarde avant d'exécuter des commandes de modification de la base de données.

  1. Créez une nouvelle base de données avec l'encodage UTF-8 et le propriétaire utilisé par votre configuration Synapse. L'exemple suivant utilise le rôle donnésynapse_user :

    sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

    Si le nom de la base de données existe déjà, ne la restaurez pas sans précaution. Suivez votre procédure de récupération pour conserver ou supprimer l'ancienne base de données uniquement après avoir vérifié son contenu et vous être assuré de disposer d'une sauvegarde distincte et récupérable.

  2. Charger l'archive dans la base de données vide :

    sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump

    Vérifiez le code de sortie de la commande et la sortie PostgreSQL. Analysez les erreurs avant de lancer Synapse. Évitez les options permettant --cleande restaurer une base de données de production déjà remplie ; Synapse avertit que les tables préexistantes peuvent engendrer des erreurs ou des incohérences subtiles.

  3. Si la sauvegarde n'a pas exclu les données de clés à usage unique, effacez-les avant le démarrage. Connectez-vous à la base de données restaurée et exécutez :

    sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'

    Synapse documente cette exception car la restauration d'anciennes clés à usage unique peut inciter un client à réutiliser des clés déjà consommées, ce qui peut entraîner des problèmes de déchiffrement des messages. Leur suppression invite les clients à télécharger de nouvelles clés. Si vous avez suivi l'exclusion recommandée, la table ne contient aucune ligne restaurée et cette troncature supplémentaire est inutile.

Idée reçue : toutes les tables de la base de données peuvent être restaurées simultanément sans risque. Action : exclure e2e_one_time_keys_jsonles tables concernées lors de la sauvegarde ou les tronquer après la restauration, et ce, avant tout processus Synapse.

Remettez le serveur domestique en marche et vérifiez-le.

Restaurez la configuration, la clé de signature et les fichiers multimédias locaux requis à partir du même point de restauration, si possible. Conservez la clé de signature d'origine : Synapse l'utilise pour signer les événements et les requêtes de fédération. Si vous devez la remplacer, suivez les instructions de Synapse relatives aux clés de signature et configurez l'ancienne clé publique comme ancienne clé de signature. La base de données, les fichiers multimédias et la configuration restaurés à partir de périodes très différentes peuvent ne pas correspondre à l'état initial ; vérifiez donc la cohérence de votre plan de restauration.

Ne démarrez Synapse et ses processus qu'une fois la restauration et la gestion de la clé à usage unique terminées. Consultez les journaux de service pour détecter les échecs de connexion à la base de données, les erreurs de schéma ou d'autorisation, ainsi que les problèmes de mise à jour en arrière-plan. Connectez-vous ensuite avec un compte de test, examinez l'historique récent d'une salle connue et ouvrez une pièce jointe téléchargée localement. Vérifiez les services de fédération et d'application si votre déploiement en dépend. Ces vérifications constituent un test rapide, mais ne garantissent pas la récupération de toutes les salles ou de tous les fichiers multimédias.

Cela dépend de votre déploiement : les chemins d’accès aux commandes, les noms de service, les rôles de base de données, l’orchestration des conteneurs et la durée de conservation des sauvegardes sont spécifiques à chaque installation. Cette procédure décrit une sauvegarde et une restauration logiques de PostgreSQL, et non une restauration à un point précis dans le temps, les rôles à l’échelle d’un cluster PostgreSQL ou une architecture de haute disponibilité avec basculement. Pour les systèmes de production, consultez la documentation de sauvegarde de Synapse et la documentation de sauvegarde et de restauration de PostgreSQL afin de trouver les méthodes adaptées à votre version de PostgreSQL et à vos objectifs de restauration. Notez la date, les versions logicielles et le résultat du test de restauration ; ne considérez pas qu’une archive non testée est une sauvegarde récupérable.

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.