Si le dépôt multimédia de Synapse sature l'espace disque, commencez par identifier le répertoire ou le volume concerné, puis utilisez les paramètres de rétention de Synapse ou l'API d'administration pour supprimer les fichiers multimédias. Ne supprimez pas les fichiers directementmedia_store : Synapse conserve les métadonnées des médias dans sa base de données, et la suppression de fichiers situés en arrière-plan peut entraîner des références brisées ou compliquer le nettoyage. La stratégie la plus sûre dépend de l'utilisation de l'espace disque : fichiers téléchargés localement, médias mis en cache depuis d'autres serveurs, vignettes ou tout autre service partageant le même disque.
Qu'est-ce qui prend de la place ?
Le dépôt multimédia de Synapse stocke les avatars, les pièces jointes et les miniatures téléchargés localement. Il met également en cache les médias récupérés depuis les serveurs Matrix distants et les ressources utilisées pour les aperçus d'URL. Ces éléments sont distincts de la base de données Synapse, des journaux de conteneurs et de tout dépôt multimédia externe. Un système de fichiers racine complet ne prouve pas à lui seul que Synapse media_storesoit la cause du problème.
Sur l'hôte ou dans le conteneur qui héberge les données montées, comparez l'utilisation du système de fichiers avec le répertoire de données Synapse. Remplacez le chemin d'exemple par la valeur correspondante dans votre déploiement :
df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store
Synapse media_store_pathutilise par défaut media_storele répertoire `/etc/synapse`, généralement `/etc/synapse`, mais cette configuration peut être modifiée. Les conteneurs peuvent écrire sur un volume monté dont le stockage réel se trouve sur l'hôte. homeserver.yamlAvant de modifier un chemin d'accès à l'hôte, vérifiez la configuration de vos volumes de conteneurs ou la configuration des volumes persistants de votre orchestrateur. Si le répertoire `/etc/synapse` n'est pas le principal consommateur de données, examinez le composant qui dul'affiche.
Choisissez une politique de nettoyage adaptée aux médias
Comportement vérifié : Synapse media_retentionpeut supprimer les fichiers multimédias locaux et les fichiers multimédias distants mis en cache après une période d'inactivité. L'accès inclut le chargement de fichiers multimédias dans une salle ou leur téléchargement. Si un élément n'a jamais été consulté, Synapse utilise sa date de création. Le fichier multimédia original et ses vignettes sont alors supprimés. Le nettoyage est effectué par le processus de traitement du dépôt multimédia, qui peut être le processus principal de Synapse.
Cela dépend de votre cas d'utilisation : les fichiers mis en cache à distance peuvent généralement être récupérés à nouveau depuis leur serveur d'origine après leur suppression. Les fichiers téléchargés localement sont hébergés sur votre serveur ; leur suppression peut donc rendre indisponibles les anciennes pièces jointes ou les avatars. Choisissez la conservation locale uniquement si vos utilisateurs acceptent cette conséquence ; une durée de vie locale plus longue ou l'absence de nettoyage local automatique peuvent être plus appropriées pour une communauté qui considère les anciennes pièces jointes comme des archives.
Ce que la conservation ne signifie pas : la mise en quarantaine d’un fichier multimédia bloque son accès, mais ne le supprime pas, ni ses miniatures. Elle ne libère pas l’espace disque nécessaire. Si vous devez conserver un élément en quarantaine tout en supprimant d’autres données, il est important de bien distinguer la quarantaine d’un contrôle de modération, tandis que la conservation et la suppression sont des contrôles de stockage.
Activer la rétention automatique dans Synapse
Sauvegardez la configuration active avant de la modifier. Ajoutez une section principale media_retentionou mettez à jour celle existante. Par exemple, cette stratégie fait expirer les fichiers multimédias locaux après 180 jours d'inactivité et les entrées du cache distant après 30 jours.
media_retention:
local_media_lifetime: 180d
remote_media_lifetime: 30d
Ces valeurs sont données à titre d'exemple et ne constituent pas des recommandations universelles. Définissez la période locale en fonction de vos obligations de conservation et de vos attentes concernant le contenu des anciennes salles. Si vous souhaitez uniquement contrôler le cache des médias distants, configurez simplement la remote_media_lifetimedurée de vie ; une durée de vie non définie ou nulle signifie que ce type de contenu ne sera pas purgé automatiquement. Synapse indique également que les médias mis en quarantaine et les médias locaux protégés contre la quarantaine sont exclus du nettoyage de la période de conservation.
Appliquez la configuration en utilisant la procédure de redémarrage ou de rechargement habituelle du déploiement et vérifiez que le processus de gestion du référentiel multimédia est en cours d'exécution enable_media_repo: true. Si Synapse utilise un processus de gestion multimédia distinct, configurez la stratégie dans laquelle le service de référentiel multimédia est activé. Une modification YAML valide ne libère pas immédiatement tout l'espace : le processus de nettoyage doit être effectué et seuls les médias plus anciens que la date limite d'accès choisie sont pris en compte.
Récupérez de l'espace plus rapidement grâce à l'API d'administration
Si le disque est déjà critique, Synapse propose des points d'accès administratifs pour le nettoyage. Ces actions suppriment définitivement les médias. Avant de les utiliser, sauvegardez la base de données et les données multimédias, vérifiez que l'URL pointe bien vers votre serveur personnel et utilisez un jeton d'accès administrateur via HTTPS. Ne conservez pas ce jeton dans l'historique du shell ni dans les journaux partagés.
Pour purger les anciens médias distants mis en cache, appelez le point de terminaison documenté avec un horodatage limite en millisecondes depuis l'époque Unix :
POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>
Par exemple, un shell peut calculer une date limite il y a 30 jours avec GNU date:
cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
-H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"
La réponse indique le nombre d'éléments mis en cache qui ont été supprimés. Si les utilisateurs demandent à nouveau ces fichiers distants, Synapse les récupérera auprès du serveur d'origine ; cela permet de libérer de l'espace disque pour les fichiers multimédias populaires.
L'API de suppression des médias locaux permet de supprimer les médias locaux en fonction de la date du dernier accès et, éventuellement, d'une taille minimale. Son point de terminaison actuel estPOST /_synapse/admin/v1/media/delete?before_ts=… ; l'ancien point de terminaison contenant <server_name>est obsolète depuis Synapse 1.78.0. La date limite est le dernier accès, et non la date de chargement, et l' keep_profilesoption est activée par défaut. Étant donné que cette suppression peut supprimer des fichiers que les utilisateurs souhaitent conserver, il est préférable d'utiliser la période de rétention configurée, sauf si vous avez défini une période limite appropriée et que vous acceptez son effet. Consultez la documentation officielle de l'API pour connaître les paramètres et votre version de Synapse installée.
Idées fausses courantes à éviter
- « Supprimer une salle efface ses médias. » Ne tenez pas compte de cette affirmation. L’historique des salles, les fichiers multimédias et les copies en cache sont gérés par des opérations distinctes. Utilisez l’API d’administration des médias ou la politique de rétention pour gérer les médias de manière spécifique.
- « La mise en quarantaine libère de l'espace disque. » C'est faux : les fichiers multimédias et leurs miniatures restent sur le disque. Utilisez une opération de suppression ou de conservation lorsque vous souhaitez récupérer de l'espace de stockage.
- « Tous les fichiers multimédias du dépôt proviennent des téléchargements de mes utilisateurs. » Le dépôt inclut également le cache distant et les données de prévisualisation des URL. Comparez les sous-répertoires du dépôt et la configuration de stockage de Synapse avant de procéder à une purge.
- Supprimer manuellement des fichiers revient à effectuer un nettoyage avec Synapse. Cette méthode n'est pas recommandée. Laissez Synapse mettre à jour ses métadonnées via son processus de conservation ou son API d'administration.
Vérifiez que l'utilisation du disque diminue.
Une fois le processus de nettoyage terminé, vérifiez df -hà nouveau la taille du répertoire multimédia. Pour une purge via l'API, confirmez le nombre d'éléments supprimés et comparez la taille du répertoire concerné avant et après. Consultez les journaux Synapse pour détecter d'éventuelles erreurs de configuration ou de processus. Si le répertoire reste volumineux, vérifiez si votre déploiement écrit les médias sur un fournisseur configuré ou un volume séparé ; l'API de suppression de médias locaux de Synapse n'affecte pas les médias stockés dans un dépôt externe. Ne présumez pas qu'une réponse positive de l'API réduira la taille du système de fichiers hôte si les fichiers se trouvent ailleurs.
Références officielles