Nettoyez vos anciens messages et fichiers multimédias Synapse sans perdre de données.

Pour supprimer en toute sécurité les anciennes données de Matrix Synapse, traitez l'historique des salles et les médias séparément. Utilisez l'API d'administration de purge de l'historique pour les événements de salles anciens, l'API de suppression des médias pour les médias locaux et l'API de cache des médias distants pour les fichiers téléchargés depuis d'autres serveurs. Pour un nettoyage régulier, configurez des politiques de rétention pour les messages et les médias. La purge des lignes de la base de données ne réduit pas toujours immédiatement la taille du fichier de base de données sur le disque.

Choisissez le nettoyage qui correspond à votre objectif.

Qu'est-ce qui prend de la place ?UtiliserLimite importante
Anciens messages et autres événements de la sallePurge de l'historique via l'API d'administration ou conservation automatique des messagesLa purge de l'historique est spécifique à chaque pièce. L'état de la pièce est préservé ; Synapse conserve au moins un message dans chaque pièce.
Médias stockés par votre serveur domestiqueSupprimer l'API des médias locaux ou la conservation des médias locauxLes médias utilisés dans les profils et les avatars de salle sont protégés par défaut par le point de terminaison date/taille.
Médias mis en cache depuis d'autres serveurs domestiquesPurge de l'API des médias distants ou conservation des médias distantsSi la demande est renouvelée, Synapse la récupère à nouveau auprès du serveur d'origine.

Ces commandes concernent la base de données et le dépôt multimédia de Synapse. Si vous utilisez un dépôt multimédia externe, comme Matrix Media Repository, la fonction de suppression locale de Synapse ne supprime pas les fichiers qui y sont stockés. Consultez la documentation et la politique de sauvegarde de ce dépôt avant de supprimer des données.

Préparez-vous avant de purger

  1. Vérifiez quelle instance Synapse gère les médias. Dans un déploiement avec nœuds de calcul, le nettoyage des médias s'exécute sur le nœud de calculenable_media_repo: true ; il peut s'agir du processus principal. Vérifiez votre routage et votre configuration avant de diagnostiquer un nettoyage qui semble ne pas s'exécuter.
  2. Sauvegardez la base de données et le stockage multimédia. Effectuez une sauvegarde récente et restaurable avant toute suppression irréversible. Notez l'identifiant de la salle et l'heure limite, et utilisez un jeton d'accès administrateur du serveur. Ne collez pas ce jeton dans l'historique d'un shell partagé et ne le publiez pas dans les journaux.
  3. Définissez soigneusement la limite de traitement. Les points de terminaison de purge acceptent les horodatages en millisecondes Unix. Utilisez une limite de traitement basée sur l'UTC et vérifiez la valeur avant d'envoyer la requête. Une limite de traitement n'est pas un aperçu : elle peut supprimer définitivement des données éligibles.

Dans les exemples ci-dessous, remplacez https://matrix.example.compar l'URL de base accessible au client pour votre serveur d'accueil, définissez un ID de salle valide et exportez un jeton d'administrateur dans ADMIN_TOKEN. Conservez le jeton d'accès confidentiel.

Supprimer l'historique des anciens messages d'une salle

L'API Purge History supprime de la base de données Synapse les événements antérieurs à une date spécifiée. Elle ne modifie pas les messages provenant d'autres serveurs et est différente de la suppression d'une salle. Par défaut, Synapse supprime les événements envoyés par des utilisateurs distants, mais conserve ceux des utilisateurs locaux ; modifiez delete_local_eventscette option trueuniquement si vous souhaitez également supprimer ces derniers. L'état de la salle, comme les membres et le sujet, est préservé.

Par exemple, pour définir une date limite 180 jours avant l'heure actuelle sur un hôte Linux, calculez l'horodatage en millisecondes, examinez-le, puis soumettez la demande pour une seule salle :

export SYNAPSE_URL='https://matrix.example.com'
export ROOM_ID='!roomid:example.com'
export ADMIN_TOKEN='replace-with-a-server-admin-token'
PURGE_BEFORE_MS=$(python3 -c 'import time; print(int((time.time() - 180*86400) * 1000))')
printf 'Cutoff (Unix milliseconds): %s\n' "$PURGE_BEFORE_MS"

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_history/$ROOM_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"purge_up_to_ts\":$PURGE_BEFORE_MS,\"delete_local_events\":true}"

Omettez cette option delete_local_eventsou définissez-la sur `true` falsesi vous souhaitez conserver le comportement par défaut de Synapse. Si l'API renvoie `true` purge_id, la purge a commencé ; elle n'est pas nécessairement terminée. Interrogez le point de terminaison d'état jusqu'à ce qu'il renvoie une réponse completeou examinez son état errorsi l'état estfailed :

curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

Les purges importantes peuvent prendre plusieurs minutes, voire plus. Pendant l'opération, il se peut que les utilisateurs ne puissent pas naviguer plus loin dans la conversation à partir du point de purge. Synapse conserve au moins un message par conversation ; cette API ne videra donc pas complètement la chronologie de la conversation.

Supprimer les anciens fichiers multimédias et les fichiers distants mis en cache

Pour un nettoyage ponctuel des fichiers multimédias locaux utilisés pour la dernière fois avant une date limite, utilisez le point de terminaison des fichiers multimédias locaux actuel. Il before_tss'agit d'un horodatage Unix en millisecondes, et il peut également cibler size_gtles fichiers dépassant un certain seuil d'octets. Par défaut, les fichiers multimédias encore utilisés pour les images de profil ou d'avatar de salle sont conservés ; ne modifiez pas ce paramètre keep_profiles=falsesauf si vous souhaitez intentionnellement supprimer ces fichiers.

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/media/delete?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

Vérifiez les identifiants de réponse totalet des médias supprimés. Ce point de terminaison supprime les fichiers originaux locaux et leurs miniatures. Évitez l'ancien chemin d'accès contenant/media/<server_name>/delete ; la documentation Synapse indique que cette route est obsolète depuis la version 1.78.0. Le point de terminaison actuel pour les médias locaux ne fonctionne pas avec un dépôt de médias externe distinct.

Les médias distants mis en cache constituent une catégorie distincte. Pour supprimer les médias distants mis en cache et consultés pour la dernière fois avant la même heure limite, utilisez :

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_media_cache?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

La réponse indique le nombre d'éléments mis en cache qui ont été supprimés. Si les utilisateurs demandent ces fichiers ultérieurement, Synapse peut les télécharger à nouveau depuis leur serveur d'origine ; cette opération implique donc une utilisation accrue du disque local au profit d'un trafic réseau potentiel et d'un délai de récupération.

Configurez une période de rétention récurrente au lieu de purges manuelles répétées.

La conservation des messages Synapse est désactivée par défaut. Pour appliquer une durée de conservation par défaut à l'ensemble du serveur pour les salons sans gestion spécifique de la conservation, ajoutez une règle à la configuration et activez-la. Cet exemple définit une durée maximale d'un an :

retention:
  enabled: true
  default_policy:
    max_lifetime: 1y

Utilisez les unités de durée prises en charge par Synapse, par exemple dles jours et yles années. Les administrateurs et modérateurs de salon peuvent également définir un m.room.retentionévénement d'état pour un salon, tandis que les administrateurs de serveur peuvent limiter la durée de vie maximale autorisée allowed_lifetime_min. allowed_lifetime_maxConsultez votre politique complète avant de l'activer : les événements éligibles sont définitivement supprimés par les tâches de purge en arrière-plan. Synapse masque les événements expirés aux clients dès leur expiration, mais la purge de la base de données s'effectue périodiquement ; des lignes peuvent donc subsister jusqu'à l'exécution d'une tâche. Les événements d'état ne sont pas concernés par la conservation des messages.

Pour les médias, ajoutez media_retentionles durées de vie, par exemple :

media_retention:
  local_media_lifetime: 90d
  remote_media_lifetime: 14d

Ces durées de vie correspondent à des périodes d'inactivité, et non à une simple limite d'âge pour les fichiers téléchargés : lorsqu'un fichier a été consulté, Synapse utilise la date de sa dernière consultation ; pour les fichiers multimédias jamais consultés, il utilise la date de leur création. Les fichiers originaux et leurs miniatures sont supprimés. Les fichiers multimédias mis en quarantaine et les fichiers multimédias locaux protégés contre la quarantaine ne sont pas concernés par ce nettoyage. Configurez la conservation des médias au niveau du processus hébergeant le dépôt multimédia, puis vérifiez ce paramètre en vous référant au manuel de configuration de votre version de Synapse.

Veuillez lire la documentation officielle relative à l'API d'historique de purge , à l'API d'administration des médias , au manuel de configuration de Synapse et à la politique de conservation des messages avant d'appliquer des modifications. Le comportement de l'API décrit ici correspond à la documentation officielle consultée le 10 octobre 2026 ; veuillez vérifier les points de terminaison et la configuration par rapport à votre version installée.

Vérifier que l'espace de stockage a été récupéré

  • Interrogez l'historique de purge jusqu'à ce qu'il indiquecomplete ; conservez l'ID de purge et la réponse pour votre journal de maintenance.
  • Vérifiez le nombre de fichiers supprimés dans les caches locaux et distants, puis examinez les journaux Synapse et l'utilisation du système de fichiers après le nettoyage.
  • Ne présumez pas qu'un nombre réduit de lignes dans la base de données implique automatiquement un fichier de base de données plus petit. La documentation de Synapse indique que PostgreSQL peut réutiliser l'espace libéré sans le restituer au système d'exploitation. Pour PostgreSQL, VACUUM FULLil est possible de récupérer de l'espace disque, mais cela nécessite un verrou exclusif ; planifiez cette opération en tenant compte de l'indisponibilité du service et de son impact, et suivez la documentation relative à la commande VACUUM de PostgreSQL . Pour SQLite, la documentation de Synapse sur la rétention des données identifie VACUUMl'opération correspondante.
  • Vérifiez que les fichiers attendus ou les événements plus anciens ne sont plus servis et assurez-vous que votre sauvegarde reste disponible avant de fermer la tâche de maintenance.

Laisser un commentaire

Nettoyez vos anciens messages et fichiers multimédias Synapse sans perdre de données.

Utilisez les API d'historique et de purge multimédia de Synapse ou les paramètres de rétention pour supprimer les données obsolètes en toute sécurité, puis vérifiez l'achèvement de l'opération et la récupération de l'espace disque.

Créez un robot Matrix Echo en Python avec Simple-Matrix-Bot-Lib

Créez un robot Matrix Echo en Python avec Simple-Matrix-Bot-Lib

Installez la bibliothèque actuelle, connectez un compte Matrix dédié et exécutez un petit bot !echo avec une gestion des identifiants plus sûre et un test clair.

Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.

Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.

Configurez trois ponts Mautrix avec des enregistrements, des connexions et des tests distincts, et évitez ainsi les surprises liées au réseau Docker, aux politiques de compte et à la synchronisation.

Récupérez de l'espace disque sur Synapse Media sans endommager les fichiers partagés

Découvrez ce qui occupe l'espace de stockage de Synapse, définissez une durée de conservation des médias sécurisée et purgez le cache distant sans supprimer directement les fichiers du disque.

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Consultez l'activité des appareils, désactivez les comptes Synapse inactifs confirmés via l'API d'administration et découvrez ce que supprime réellement l'option d'effacement.

Réduire la pression sur la mémoire de PostgreSQL dans Matrix Synapse

Déterminez si la mémoire utilisée par PostgreSQL provient des requêtes, des tampons partagés, des connexions ou de la maintenance, puis apportez des modifications ciblées compatibles avec Synapse.

Pourquoi les jonctions de salles Matrix Synapse sont-elles lentes ? Que vérifier ?

Pourquoi les jonctions de salles Matrix Synapse sont-elles lentes ? Que vérifier ?

Avant de modifier les paramètres Synapse, vérifiez si la lenteur des connexions à une salle Matrix se fait à un serveur distant, si le délai de fédération est dépassé, si la charge de la base de données locale est excessive ou si la file d'attente de l'expéditeur est trop longue.

Fermer les inscriptions à Matrix ou exiger des jetons d'invitation sur Synapse

Empêchez la création de comptes ouverts sur un serveur Synapse auto-hébergé, ou limitez les inscriptions aux invitations uniquement avec des jetons d'inscription à usage limité.

Avertissement relatif à l'identité de session : vérifiez votre connexion en toute sécurité.

L'avertissement de session non vérifiée de Clear Element utilise un appareil de confiance ou une clé de récupération, avec des contrôles qui protègent votre historique de conversation chiffré.

Évitez les délais d'expiration de verrouillage de fichiers ownCloud grâce au bon backend

Distinguez les conflits de verrouillage de base de données des verrous WebDAV expirés, puis choisissez et configurez le correctif ownCloud 10 approprié.