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

Para eliminar de forma segura los datos antiguos de Matrix Synapse, trate el historial de salas y los archivos multimedia como tareas independientes. Utilice la API de administración de historial de purga para los eventos antiguos de salas, la API de eliminación de archivos multimedia para los archivos locales y la API de caché de archivos multimedia remotos para los archivos descargados de otros servidores domésticos. Para la limpieza periódica, configure políticas de retención para mensajes y archivos multimedia. La purga de filas de la base de datos no siempre reduce el tamaño del archivo de base de datos en disco de inmediato.

Elige la limpieza que mejor se adapte a tu objetivo.

¿Qué está ocupando espacio?UsoLímite importante
Mensajes antiguos y otros eventos de la salaAPI de administración del historial de purga o retención automática de mensajesLa eliminación del historial es específica de cada sala. El estado de la sala se conserva; Synapse mantiene al menos un mensaje en cada sala.
Contenido multimedia almacenado en su servidor doméstico.Eliminar la API de medios locales o la retención de medios locales.Los archivos multimedia utilizados en los perfiles y avatares de las salas están protegidos de forma predeterminada por el punto final de fecha/tamaño.
Contenido multimedia almacenado en caché desde otros servidores domésticos.Purga la API de medios remotos o retención de medios remotos.Si se solicita de nuevo, Synapse lo vuelve a obtener del servidor de origen.

Estos controles afectan a la base de datos y al repositorio de medios de Synapse. Si utiliza un repositorio de medios externo, como Matrix Media Repository, la función de eliminación de medios local de Synapse no elimina los archivos almacenados allí. Consulte la documentación y la política de copias de seguridad de dicho repositorio antes de eliminar datos.

Prepárate antes de purgarte

  1. Confirme qué instancia de Synapse gestiona los medios. En una implementación de trabajador, la limpieza de medios se ejecuta en el trabajador con enable_media_repo: true; este podría ser el proceso principal. Confirme su enrutamiento y configuración antes de diagnosticar una limpieza que aparentemente no se ejecuta.
  2. Realice una copia de seguridad de la base de datos y del almacenamiento de medios. Cree una copia de seguridad reciente y restaurable antes de una eliminación irreversible. Registre el ID de la sala y la hora límite, y utilice un token de acceso de administrador del servidor. No copie el token en el historial de la consola compartida ni lo publique en los registros.
  3. Planifique cuidadosamente el límite de tiempo. Los puntos finales de purga aceptan marcas de tiempo en milisegundos Unix. Utilice un límite de tiempo basado en UTC y verifique el valor antes de enviar la solicitud. Un límite de tiempo no es una vista previa: puede eliminar permanentemente los datos elegibles.

En los ejemplos siguientes, reemplace https://matrix.example.comcon la URL base visible para el cliente de su servidor doméstico, establezca un ID de sala válido y exporte un token de administrador en ADMIN_TOKEN. Mantenga el token de portador privado.

Eliminar el historial de mensajes antiguos de una habitación.

La API Purge History elimina de la base de datos de Synapse los eventos anteriores a una fecha y hora específicas. No elimina los mensajes de otros servidores y no es lo mismo que eliminar una sala. Por defecto, Synapse elimina los eventos enviados por usuarios remotos, pero conserva los de los usuarios locales; active delete_local_eventsesta opción truesolo si desea eliminar también estos últimos. El estado de la sala, como la membresía y el tema, se conserva.

Por ejemplo, para establecer un límite de 180 días antes de la hora actual en un host Linux, calcule la marca de tiempo en milisegundos, inspecciónela y luego envíe la solicitud para una sola sala:

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}"

Omítalo delete_local_eventso configúrelo falsesi desea el comportamiento predeterminado de Synapse. Si la API devuelve un purge_id, la purga ha comenzado; no necesariamente ha terminado. Consulte el punto final de estado hasta que informe completeo investigue su errorsi el estado es failed:

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

Las purgas de gran tamaño pueden tardar varios minutos o incluso más. Durante la operación, es posible que los usuarios no puedan retroceder en la paginación de la sala desde el punto que se está purgando. Synapse conserva al menos un mensaje en cada sala, por lo que esta API no dejará la línea de tiempo de la sala completamente vacía.

Eliminar archivos multimedia antiguos y archivos remotos almacenados en caché.

Para una limpieza única de los medios locales usados ​​antes de una fecha límite, utilice el punto final de medios locales actual. Este before_tses una marca de tiempo Unix en milisegundos y también puede aceptar size_gtarchivos que superen un umbral de bytes. Por defecto, conserva los medios que aún se usan para imágenes de perfil o avatares de sala; no modifique esta opción keep_profiles=falsea menos que desee eliminar esos archivos intencionadamente.

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 '{}'

Revise la respuesta totaly los ID de medios eliminados. El punto final elimina los originales locales y las miniaturas. Evite la ruta antigua que contiene /media/<server_name>/delete; la documentación de Synapse marca esa ruta como obsoleta desde la versión 1.78.0. El punto final de medios locales actual no funciona en un repositorio de medios externo independiente.

Los medios remotos almacenados en caché constituyen una categoría aparte. Para eliminar los medios remotos de la caché a los que se accedió por última vez antes de la misma fecha límite, utilice:

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 respuesta indica cuántos elementos almacenados en caché se eliminaron. Si los usuarios solicitan esos archivos posteriormente, Synapse podría volver a descargarlos desde su servidor de origen, por lo que esta operación sacrifica el uso del disco local a cambio de un posible tráfico de red y un retraso en la recuperación.

Configurar la retención recurrente en lugar de realizar purgas manuales repetitivas.

La retención de mensajes de Synapse está deshabilitada de forma predeterminada. Para aplicar una configuración predeterminada a nivel de servidor para las salas sin estado de retención propio, agregue una política a la configuración y habilítela. Este ejemplo establece un máximo de un año:

retention:
  enabled: true
  default_policy:
    max_lifetime: 1y

Utilice las unidades de duración compatibles con Synapse, como ddías y yaños. Los administradores y moderadores de salas también pueden establecer el m.room.retentionevento de estado de una sala, mientras que los administradores de servidores pueden limitar las duraciones máximas permitidas con allowed_lifetime_miny allowed_lifetime_max. Revise su política completa antes de habilitarla: los eventos elegibles se eliminan permanentemente mediante trabajos de purga en segundo plano. Synapse oculta los eventos caducados a los clientes tan pronto como caducan, pero la purga de la base de datos se ejecuta periódicamente, por lo que pueden permanecer filas hasta que se ejecute un trabajo. Los eventos de estado no están cubiertos por la retención de mensajes.

Para los medios, agregue media_retentionlos periodos de vida, por ejemplo:

media_retention:
  local_media_lifetime: 90d
  remote_media_lifetime: 14d

Estos periodos de inactividad no se limitan a un límite de antigüedad de la carga: cuando se accede a un archivo, Synapse utiliza su último acceso; para los archivos multimedia que nunca se han accedido, utiliza su fecha de creación. Los archivos originales y las miniaturas se eliminan. Los archivos multimedia en cuarentena y los archivos multimedia locales protegidos de la cuarentena no se eliminan durante esta limpieza. Configure la retención de archivos multimedia en el proceso que aloja el repositorio de archivos multimedia y, a continuación, valide la configuración según el manual de configuración de la versión de Synapse que utilice.

Lea la documentación oficial de la API de historial de purga , la API de administración de medios , el manual de configuración de Synapse y la política de retención de mensajes antes de aplicar los cambios. El comportamiento de la API que se describe aquí refleja la documentación oficial revisada el 10 de octubre de 2026; confirme los puntos finales y la configuración con la versión instalada.

Verifique que el espacio de almacenamiento haya sido recuperado.

  • Consulta el estado de purga del historial hasta que diga complete; guarda el ID de purga y la respuesta para tu registro de mantenimiento.
  • Compruebe el recuento de elementos eliminados en los medios locales y en la caché remota, y luego inspeccione los registros de Synapse y el uso del sistema de archivos después de la limpieza.
  • No asuma que menos filas en la base de datos significan automáticamente un archivo de base de datos más pequeño. La documentación de Synapse indica que PostgreSQL puede reutilizar el espacio liberado sin devolverlo al sistema operativo. Para PostgreSQL, VACUUM FULLpuede recuperar espacio en disco, pero requiere un bloqueo exclusivo; prográmelo teniendo en cuenta el tiempo de inactividad/impacto y siga la documentación de PostgreSQL VACUUM . Para SQLite, la documentación de retención de Synapse identifica VACUUMcomo la operación correspondiente.
  • Confirme que los archivos esperados o los eventos antiguos ya no se sirven y verifique que su copia de seguridad siga disponible antes de cerrar la tarea de mantenimiento.

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.