Recupera espacio en disco de Synapse Media sin dañar los archivos compartidos.

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

Dejar un comentario

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Diagnostique si Synapse alcanzó su límite de archivos abiertos por proceso, configure un archivo de configuración de systemd para el servicio o trabajador adecuado y verifique el límite en tiempo real.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

Averigua si el error se limita a un navegador o a un evento específico y, a continuación, utiliza la clave de recuperación de Element o un dispositivo de confianza sin poner en riesgo el historial cifrado restante.

Limpia los mensajes y archivos multimedia antiguos de Synapse sin perder datos.

Utilice las API de historial y eliminación de medios de Synapse o la configuración de retención para eliminar datos obsoletos de forma segura y, a continuación, verifique que el proceso se haya completado y que se haya recuperado el espacio en disco.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Instala la biblioteca actual, conecta una cuenta Matrix dedicada y ejecuta un pequeño bot !echo con un manejo de credenciales más seguro y una prueba clara.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Configure tres puentes mautrix con registros, inicios de sesión y pruebas independientes, y evite sorpresas con la red, la política de cuentas y la sincronización de Docker.

Recupera espacio en disco de Synapse Media sin dañar los archivos compartidos.

Descubre qué está llenando el almacenamiento de Synapse, configura la retención segura de medios y purga la caché remota sin eliminar archivos directamente del disco.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Revise la actividad del dispositivo, desactive las cuentas de Synapse inactivas confirmadas a través de la API de administración y descubra qué elimina realmente la opción de borrado.

Reduzca la presión de memoria de PostgreSQL en Matrix Synapse.

Determine si la memoria de PostgreSQL proviene del trabajo de consultas, búferes compartidos, conexiones o mantenimiento, y luego realice los cambios necesarios de forma segura para Synapse.

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

Antes de cambiar la configuración de Synapse, analice si hay problemas con las conexiones lentas de salas Matrix a un servidor remoto, el retroceso de la federación, la carga de la base de datos local o una cola de envío saliente.

Cerrar registros de Matrix o requerir tokens de invitación en Synapse

Impida la creación de cuentas abiertas en un servidor Synapse autogestionado o mantenga los registros solo por invitación con tokens de registro de uso limitado.