Si el repositorio de medios de Synapse está llenando el disco, primero confirme qué directorio o volumen está creciendo y luego use la configuración de retención compatible de Synapse o la API de administración para eliminar los archivos multimedia. No elimine archivos directamente desde Synapse media_store: Synapse guarda los metadatos de los archivos multimedia en su base de datos, y eliminar archivos que no están en Synapse puede dejar referencias rotas o dificultar la auditoría de la limpieza. La política más segura depende de si el espacio lo utilizan cargas locales, archivos multimedia en caché de otros servidores, miniaturas u otro servicio que comparta el mismo disco.
¿Qué está ocupando el espacio?
El repositorio multimedia de Synapse almacena avatares, archivos adjuntos y miniaturas cargados localmente. También almacena en caché el contenido multimedia obtenido de servidores remotos de Matrix y los recursos utilizados para las vistas previas de URL. Estos elementos son independientes de la base de datos de Synapse, los registros de contenedores y cualquier repositorio multimedia externo. Un sistema de archivos raíz lleno no demuestra por sí solo que esa media_storesea la causa.
En el host o dentro del contenedor que posee los datos montados, compare el uso del sistema de archivos con el directorio de datos de Synapse. Reemplace la ruta de ejemplo con el valor de su implementación:
df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store
Synapse media_store_pathutiliza por defecto media_store, generalmente en el directorio de datos, pero las instalaciones pueden anularlo. Los contenedores pueden escribir en un volumen montado cuyo almacenamiento real se encuentra en el host. Verifique homeserver.yaml, las asignaciones de volumen de su contenedor o la configuración de volumen persistente de su orquestador antes de concluir que una ruta del host es segura para cambiar. Si el directorio de medios no es el mayor consumidor, investigue el componente que dumuestra en su lugar.
Elija una política de limpieza que se ajuste a los medios.
Comportamiento verificado: La configuración de Synapse media_retentionpuede hacer que los archivos multimedia locales y los archivos multimedia remotos almacenados en caché caduquen tras periodos sin acceso. El acceso incluye la carga o descarga de archivos multimedia en una sala. Si un elemento nunca se ha accedido, Synapse utiliza su fecha de creación. Se eliminan tanto el archivo multimedia original como sus miniaturas. La limpieza se ejecuta en el proceso de trabajo del repositorio multimedia, que puede ser el proceso principal de Synapse.
Depende de tu caso de uso: Los archivos almacenados en caché de forma remota generalmente se pueden recuperar de su servidor de origen cuando se solicitan después de su eliminación. Los archivos subidos localmente se alojan en tu servidor, por lo que eliminarlos puede hacer que los archivos adjuntos o avatares antiguos no estén disponibles. Elige la retención local solo si tus usuarios aceptan esa consecuencia; una vida útil local más larga o la ausencia de limpieza local automática pueden ser más apropiadas para una comunidad que trata los archivos adjuntos antiguos como un archivo.
Qué no significa retención: poner en cuarentena un archivo multimedia bloquea el acceso, pero no lo elimina ni sus miniaturas. No liberará el espacio en disco que necesita. Si necesita conservar un elemento en cuarentena mientras elimina otros datos, tenga presente que la cuarentena es un control de moderación, mientras que la retención y la eliminación son controles de almacenamiento.
Habilitar la retención automática en Synapse
Realice una copia de seguridad de la configuración activa antes de editarla. Añada una media_retentionsección de nivel superior o actualice la existente. Por ejemplo, esta política hace que los medios locales caduquen después de 180 días sin acceso y las entradas de caché remotas después de 30 días:
media_retention:
local_media_lifetime: 180d
remote_media_lifetime: 30d
Estos valores son ejemplos, no recomendaciones universales. Configure el período local según sus obligaciones y expectativas de retención para el contenido antiguo de la sala. Si solo desea controlar la caché para medios remotos, configure solo remote_media_lifetime; un tiempo de vida no establecido o nulo significa que ese tipo no se purgará automáticamente. Synapse también documenta que los medios en cuarentena y los medios locales protegidos de la cuarentena se excluyen de la limpieza de retención.
Aplique la configuración mediante el proceso normal de reinicio o recarga de la implementación y verifique que el trabajador del repositorio de medios se esté ejecutando enable_media_repo: true. Si Synapse utiliza un trabajador de medios independiente, configure la política donde se habilita el servicio de repositorio de medios. Una edición YAML válida no recupera inmediatamente todo el espacio: el trabajador debe ejecutar la limpieza y solo los medios anteriores al límite de acceso seleccionado cumplen los requisitos.
Recupera espacio más rápido con la API de administración.
Si el disco ya está en estado crítico, Synapse proporciona puntos de acceso administrativos para su limpieza. Estas acciones eliminan permanentemente los archivos multimedia. Antes de utilizarlas, realice una copia de seguridad de la base de datos y los datos multimedia, confirme que la URL apunta a su propio servidor y utilice un token de acceso de administrador del servidor a través de HTTPS. Mantenga el token fuera del historial de comandos y de los registros compartidos.
Para eliminar los archivos multimedia remotos antiguos almacenados en caché, llame al punto final documentado con una marca de tiempo límite en milisegundos desde la época Unix:
POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>
Por ejemplo, un shell puede calcular un punto de corte de hace 30 días con 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 respuesta indica cuántos elementos almacenados en caché se eliminaron. Si los usuarios vuelven a solicitar esos archivos remotos, Synapse los recuperará del servidor de origen; esto puede liberar espacio en disco para los archivos multimedia más utilizados.
La API de eliminación de medios locales puede eliminar medios locales según la hora del último acceso y, opcionalmente, un tamaño mínimo. Su punto final actual es POST /_synapse/admin/v1/media/delete?before_ts=…; el punto final anterior que contiene <server_name>está obsoleto desde Synapse 1.78.0. El límite es el último acceso, no la fecha de carga, y la keep_profilesopción está activada por defecto. Dado que esta eliminación puede eliminar archivos que los usuarios esperan que permanezcan disponibles, se recomienda usar la retención configurada a menos que se haya identificado un límite adecuado y se acepte el efecto. Consulte la referencia oficial de la API para obtener información sobre los parámetros y la versión de Synapse instalada.
Conceptos erróneos comunes que se deben evitar
- «Eliminar una sala borrará automáticamente sus archivos multimedia». No dé esto por sentado. El historial de la sala, los archivos multimedia y las copias en caché se gestionan mediante operaciones diferentes. Utilice la API de administración de medios o la política de retención para gestionar los archivos multimedia de forma específica.
- «La cuarentena libera espacio en disco». No es cierto: los archivos multimedia y las miniaturas en cuarentena permanecen en el disco. Utilice una operación de eliminación o retención cuando el objetivo sea recuperar espacio de almacenamiento.
- “Todo el contenido multimedia del repositorio proviene de las cargas de mis usuarios”. El repositorio también incluye datos de caché remota y vista previa de URL. Compare los subdirectorios del repositorio y la configuración de almacenamiento de Synapse antes de realizar una limpieza.
- «Eliminar archivos manualmente equivale a la limpieza de Synapse». No es una alternativa compatible. Deja que Synapse actualice sus metadatos mediante su proceso de retención o la API de administración.
Verifica que el uso del disco esté disminuyendo.
Una vez que el proceso de limpieza haya finalizado, compruebe df -hde nuevo el tamaño del directorio de medios. Para una purga mediante API, confirme la cantidad de elementos eliminados en la respuesta y compare el directorio correspondiente antes y después. Revise los registros de Synapse en busca de errores de configuración o del proceso. Si el directorio sigue siendo grande, compruebe si su implementación escribe los medios en un proveedor configurado o en un volumen independiente; la API de eliminación de medios locales de Synapse no afecta a los medios almacenados en un repositorio de medios externo. No dé por sentado que una respuesta exitosa de la API reducirá el sistema de archivos del host si los archivos se encuentran en otra ubicación.
Referencias oficiales