Restaura Matrix Synapse de forma segura con un volcado de PostgreSQL.

Utilice el formato de volcado personalizado de PostgreSQL para realizar una copia de seguridad de la base de datos Synapse, excluya la tabla de claves de un solo uso y restáurela en una base de datos vacía recién creada. El volcado de la base de datos por sí solo no constituye una copia de seguridad completa del servidor principal: conserve también la configuración de Synapse, la clave de firma y los medios locales. La guía oficial de copias de seguridad de Synapse, revisada el 10 de octubre de 2026, advierte específicamente contra la restauración sobre tablas existentes y contra la restauración de claves de un solo uso de cifrado de extremo a extremo antiguas.

Qué contiene (y qué no contiene) una copia de seguridad de la base de datos.

Verificado: pg_dump crea una instantánea consistente mientras PostgreSQL permanece en línea; no es necesario detener Synapse mientras se ejecuta el volcado. Un volcado solo de la base de datos no incluye archivos del almacenamiento de medios de Synapse, homeserver.yamlarchivos de configuración referenciados ni la clave de firma del servidor. Conserve estos archivos en un conjunto de copias de seguridad protegido por separado. Synapse identifica el contenido cargado localmente y, cuando las miniaturas dinámicas están deshabilitadas, las miniaturas locales como datos que deben conservarse. Las cachés de medios remotos y de vista previa de URL generalmente se pueden recuperar o reconstruir.

Acción: identifique el nombre de la base de datos activa, el rol de PostgreSQL, el directorio de configuración de Synapse, la ruta de la clave de firma y la ruta del almacén de medios antes de crear un plan de recuperación. Utilice las rutas configuradas en su servidor; estas varían según el paquete, el contenedor y la implementación.

Error común: una copia de seguridad SQL exitosa no garantiza la recuperación completa del servidor. Acción: realice copias de seguridad de la base de datos, la configuración, la clave de firma y los medios locales necesarios, y pruebe periódicamente la restauración conjunta de todos ellos.

Cree y compruebe un volcado de formato personalizado.

Los siguientes comandos presuponen un host Linux con las herramientas de línea de comandos de PostgreSQL instaladas, una base de datos con el nombre especificado synapsey permisos para ejecutar comandos de PostgreSQL como postgresusuario del sistema operativo. Reemplace el nombre de la base de datos y las rutas con los valores de su implementación. Guarde el volcado en un almacenamiento protegido con suficiente espacio libre; puede contener mensajes privados y datos de la cuenta.

  1. Cree el volcado, excluyendo el contenido de la tabla que Synapse indica que no debe reproducirse desde una copia de seguridad anterior:

    sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump

    -FcSelecciona el formato de archivo personalizado de PostgreSQL, que es adecuado pg_restorey suele ser más pequeño que el SQL estándar. La exclusión afecta a los datos de la tabla; no elimina la definición de la tabla.

  2. Compruebe que el archivo existe y no está vacío, y luego muestre el índice del archivo comprimido:

    ls -lh /secure-backups/synapse.dump
    sudo -u postgres pg_restore --list /secure-backups/synapse.dump

    La lista confirma que PostgreSQL puede leer la estructura del archivo; sin embargo, no prueba que se puedan restaurar todas las filas ni que los demás archivos de copia de seguridad estén completos. Para una verificación más exhaustiva, copie el volcado a un almacenamiento de copia de seguridad independiente y verifique su suma de comprobación después de la transferencia.

Error común: se cree que es necesario detener Synapse para cada copia de seguridad pg_dumplógica. La página oficial de Synapse indica que una instantánea normal pg_dumpes consistente sin detener Synapse ni PostgreSQL. Acción: mantenga el servicio en línea para esta copia de seguridad lógica, pero planifique una ventana de mantenimiento para una restauración completa.

Restaurar en una base de datos vacía

La restauración es una operación de reemplazo. Primero, detenga Synapse y cualquier proceso auxiliar de Synapse para evitar que algo se conecte o escriba en el destino mientras se realiza la recuperación. Confirme el nombre de la base de datos de destino y el volcado antes de ejecutar comandos que modifiquen la base de datos.

  1. Cree una base de datos nueva con codificación UTF-8 y el propietario utilizado por su configuración de Synapse. A continuación se utiliza el rol de ejemplo synapse_user:

    sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

    Si el nombre de la base de datos ya existe, no la restaure sin más. Siga su procedimiento de recuperación para conservar o eliminar la base de datos antigua solo después de confirmar su contenido y asegurarse de tener una copia de seguridad recuperable independiente.

  2. Cargar el archivo en la base de datos vacía:

    sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump

    Verifique el estado de salida del comando y la salida de PostgreSQL. Investigue los errores antes de iniciar Synapse. Evite opciones como --cleanusar un acceso directo para restaurar sobre una base de datos de producción con datos; Synapse advierte que las tablas preexistentes pueden causar errores o inconsistencias sutiles.

  3. Si el volcado no excluyó los datos de clave de un solo uso, bórrelos antes de iniciar. Conéctese a la base de datos restaurada y ejecute:

    sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'

    Synapse documenta esta excepción porque restaurar claves antiguas de un solo uso puede provocar que un cliente reutilice claves que ya se consumieron, lo que puede causar problemas de descifrado de mensajes. Al eliminarlas, se solicita a los clientes que carguen claves nuevas. Si siguió la exclusión recomendada, la tabla no tendrá filas restauradas y este truncamiento adicional es innecesario.

Un error común: se cree que todas las tablas de la base de datos se pueden restaurar juntas sin problemas. Acción: excluya las tablas e2e_one_time_keys_jsondurante la copia de seguridad o trunque la base de datos después de la restauración, y hágalo antes de que se inicie cualquier proceso de Synapse.

Vuelve a conectar el servidor doméstico y verifícalo.

Restaura la configuración, la clave de firma y los archivos multimedia locales necesarios desde el mismo punto de recuperación, siempre que sea posible. Conserva la clave de firma original: Synapse la utiliza para firmar eventos y solicitudes de federación. Si necesitas reemplazarla, sigue las instrucciones de Synapse para la clave de firma y configura la clave pública antigua como clave de firma antigua. Es posible que la base de datos, los archivos multimedia y la configuración restaurados desde momentos muy diferentes no reflejen el mismo estado, así que verifica la coherencia de tu plan de recuperación.

Inicie Synapse y sus procesos auxiliares solo después de que se complete la restauración y la gestión de la clave de un solo uso. Revise los registros de servicio para detectar fallos de conexión a la base de datos, errores de esquema o permisos faltantes y problemas de actualización en segundo plano. A continuación, inicie sesión con una cuenta de prueba, inspeccione el historial reciente de una sala conocida y abra un archivo adjunto cargado localmente. Compruebe los servicios de federación y de aplicación si su implementación depende de ellos. Estas comprobaciones son una prueba básica, no una garantía de que se hayan recuperado todas las salas u objetos multimedia.

Depende de su implementación: las rutas de comandos, los nombres de los servicios, las funciones de la base de datos, la orquestación de contenedores y la retención de copias de seguridad son específicas de la instalación. Este procedimiento abarca la copia de seguridad y restauración lógica de PostgreSQL, no la recuperación a un punto en el tiempo, las funciones de clúster de PostgreSQL ni un diseño de conmutación por error de alta disponibilidad. Para sistemas de producción, revise la documentación de copia de seguridad de Synapse y la documentación de copia de seguridad y restauración de PostgreSQL para encontrar métodos que se ajusten a su versión de PostgreSQL y a sus objetivos de recuperación. Registre la fecha, las versiones del software y el resultado de la prueba de restauración; no asuma que un archivo no probado es una copia de seguridad recuperable.

Dejar un comentario

Restaura Matrix Synapse de forma segura con un volcado de PostgreSQL.

Realice una copia de seguridad de Synapse con pg_dump, proteja su clave de firma y el medio de almacenamiento, y restáurela en una base de datos PostgreSQL limpia sin reutilizar claves obsoletas de un solo uso.

Ejecuta Mjölnir como un bot de moderación de salas Matrix con Docker.

Ejecuta Mjölnir como un bot de moderación de salas Matrix con Docker.

Configura Mjölnir con una cuenta Matrix dedicada, una sala de administración cifrada, Docker Compose, una lista de políticas y comprobaciones de permisos.

Habilita la sincronización nativa de la matriz deslizante para una carga más rápida en dispositivos móviles.

Habilita la sincronización nativa de la matriz deslizante para una carga más rápida en dispositivos móviles.

Omita el proxy obsoleto y configure la sincronización deslizante integrada de Synapse. Verifique la detección de clientes y luego mida la carga de la lista de salas y el comportamiento de reconexión en un teléfono compatible.

Aloja Element Web en Nginx con un servidor Homeserver personalizado.

Implementa Element Web como un sitio estático, apúntalo a tu servidor principal Matrix, agrega HTTPS y configura Nginx para que sirva las actualizaciones sin archivos obsoletos.

Ejecuta un servidor doméstico Matrix ligero en Raspberry Pi 4

Configura Conduit en una Raspberry Pi 4 de 64 bits con datos persistentes, federación HTTPS, registro protegido y comprobaciones para un servidor doméstico en funcionamiento.

Configura un alias de sala Matrix personalizado en tu propio dominio.

Asigne a una sala de Matrix una dirección fácil de compartir en su dominio utilizando Element o la API de Matrix, con comprobaciones de permisos, nomenclatura Synapse y federación.

Configurar la función de devolución conjunta para llamadas de voz y vídeo fiables de Matrix.

Configure coturn y Synapse con las credenciales TURN correspondientes, abra los puertos de retransmisión necesarios y verifique que los clientes de Matrix puedan obtener candidatos de retransmisión.

Implementar Matrix Synapse con Docker Compose y PostgreSQL

Implementar Matrix Synapse con Docker Compose y PostgreSQL

Configura un servidor Synapse persistente con Docker Compose, PostgreSQL, una configuración privada y comprobaciones antes de exponerlo a través de HTTPS.

Personaliza el tema y la imagen de marca de Element Web.

Define un nombre de marca, colores personalizados y elementos de inicio de sesión para tu implementación de Element Web, teniendo en cuenta qué partes conservarán la marca Element.

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.