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

Para un cliente móvil Matrix actual, no agregue el antiguo proxy independiente de Sincronización Deslizante a Docker Compose. El proxy se archivó en noviembre de 2025; Synapse proporciona la Sincronización Deslizante Simplificada nativa, habilitada por defecto desde Synapse 1.114. Actualice Synapse a una versión compatible, verifique que la funcionalidad nativa llegue a los clientes a través de su URL pública y mida la carga en un cliente compatible.

Qué ha cambiado y qué necesitas

Originalmente, “Sliding Sync” se refería a la implementación de proxy de MSC3575, que se ubicaba delante de Synapse y requería una configuración de servicio y detección independiente. La especificación Matrix evolucionó: MSC4186, Simplified Sliding Sync, reemplazó ese diseño. El repositorio oficial de proxy está archivado e indica que ya no se espera que los clientes modernos funcionen con él. Synapse agregó soporte nativo para MSC3575 y MSC4186 y lo habilitó por defecto a partir de la versión 1.114.0, como se registra en el registro de cambios de Synapse .

Esta guía asume que Synapse ya se ejecuta con Docker Compose detrás de una URL HTTPS pública como https://matrix.example.org. Necesitas acceso a la línea de comandos del proyecto Compose, una forma de editar su etiqueta de imagen y la configuración del servidor principal, y una aplicación móvil cuya versión actual admita la sincronización deslizante nativa. Si solo deseas una carga inicial más rápida en un cliente que no la admite, agregar un proxy no hará que ese cliente utilice la función.

Prepara una actualización segura de Synapse.

Utilice una versión de Synapse con soporte vigente en lugar de basar una nueva implementación en la versión histórica con las características mínimas. Revise las versiones oficiales de Synapse y las notas de actualización de la versión desde la que está migrando. Realice una copia de seguridad de la base de datos y los volúmenes de datos/configuración de Synapse antes de actualizar, y verifique si las notas requieren pasos de actualización intermedios. Esto es especialmente importante en instalaciones antiguas: el aviso de seguridad de Synapse sobre una divulgación del estado de la sala de Sliding Sync enumera las versiones afectadas hasta la v1.120.0 y la corrige en la v1.120.1. Elija una versión actual con soporte y correcciones posteriores, no solo la primera versión parcheada.

En tu archivo Compose, identifica la clave de servicio de Synapse y la etiqueta de imagen que utiliza. Si la etiqueta está vinculada a una versión antigua, cámbiala a la versión compatible que seleccionaste. Luego, descarga y vuelve a crear solo ese servicio; reemplaza synapselo siguiente si tu servicio tiene otro nombre:

Terminal que muestra el comando Docker Compose para descargar la imagen de Synapse.
Descarga la imagen de Synapse después de actualizar su etiqueta a la versión seleccionada para tu implementación.
docker compose pull synapse
Terminal que muestra el comando Docker Compose para recrear el servicio Synapse.
Recrea el servicio Synapse para que Compose ejecute la imagen seleccionada.
docker compose up -d synapse
docker compose logs --tail=100 synapse

Antes de continuar, revise los registros para detectar errores de inicio y una actualización de base de datos completada. Si el inicio falla, no realice una degradación a ciegas; consulte la guía de actualización específica de la versión y restaure una copia de seguridad utilizando únicamente el proceso de recuperación adecuado para su base de datos.

Confirme que la sincronización deslizante nativa esté habilitada.

Synapse normalmente habilita la sincronización deslizante nativa por defecto, por lo que una instalación nueva a menudo no requiere YAML adicional. La configuración conserva el nombre MSC anterior, lo que puede resultar confuso: controla la implementación nativa de Synapse y no es una solicitud para ejecutar el proxy obsoleto. Verifique si existe homeserver.yamlun valor falso explícito. Si encuentra alguno, cámbielo en el bloque de características existente:

Editor YAML que muestra experimental_features con msc3575_enabled establecido en true.
Si la configuración de Synapse desactiva explícitamente esta función, habilítela en el bloque experimental_features existente.
experimental_features:
  msc3575_enabled: true

Si experimental_featuresya existe, edite ese bloque en lugar de agregar una clave YAML duplicada. Si la configuración no existe o ya está activada, déjela como está. Recree el servicio Synapse después de un cambio de configuración y revise sus registros. Un error de indentación en YAML puede impedir que Synapse se inicie.

Elimine la ruta proxy obsoleta y pruebe el descubrimiento.

Inspeccione el JSON servido en https://matrix.example.org/.well-known/matrix/client. Si contiene la org.matrix.msc3575.proxypropiedad antigua, elimínela conservando las entradas de descubrimiento de cliente no relacionadas. Elimine también cualquier regla de proxy inverso que envíe solicitudes de cliente Matrix al proxy obsoleto; la /_matrix/client/ruta API estándar debe llegar a Synapse. No agregue un nuevo puerto de proxy ni anuncie una URL de proxy para MSC4186 nativo. Mantenga cualquier otro valor conocido, incluida la URL de su servidor principal, según lo requiera su configuración.

Desde una máquina que pueda acceder al servidor público, consulte el punto final de versiones Cliente-Servidor. Esto verifica el servicio que los clientes descubren realmente, en lugar de solo verificar un contenedor en la red privada de Docker:

Terminal con un comando curl y jq que lee la capacidad simplificada del MSC3575 desde el punto final de las versiones públicas de Matrix.
Compruebe la respuesta del servidor público para la capacidad nativa simplified_msc3575.
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'

Para una versión de Synapse con soporte nativo habilitado y un punto final correctamente enrutado, esto debería imprimir true. Si jqno está disponible, ejecute la curlsolicitud sin la tubería e inspeccione el campo JSON. Un valor faltante o falso es una señal de error útil: verifique que DNS y HTTPS lleguen al servidor esperado, que el proxy inverso pase la ruta de la API del cliente a Synapse, que la imagen en ejecución sea la versión que seleccionó y que ninguna configuración explícita desactive la función. No exponga tokens de acceso al compartir la salida de diagnóstico; esta solicitud de versiones públicas no necesita uno.

Comprueba el resultado en un teléfono compatible.

Inicia sesión o vuelve a conectarte con una versión del cliente que admita el protocolo nativo, usando la misma cuenta y el mismo teléfono que usarás para la comparación. Si es posible, registra una línea base antes de cambiar de servidor. Compara un inicio en frío de la aplicación después de borrar o reconstruir los datos locales de la aplicación solo si entiendes que esto elimina el contenido en caché; luego, compara los inicios en caliente habituales con una reconexión después de que el teléfono haya estado sin conexión. Mantén la red, la cuenta, la configuración de la sala y el método de prueba constantes.

  • Mide el tiempo que transcurre desde que abres la aplicación hasta que la lista de habitaciones está disponible, no solo hasta que desaparece la pantalla de inicio.
  • Comprueba si los nombres de las salas recientes, el estado de mensajes no leídos y los mensajes nuevos aparecen rápidamente después de volver a conectarte.
  • Supervise los registros de Synapse para detectar errores en los puntos finales, reintentos repetidos o sobrecarga en los procesos de trabajo o la base de datos durante la misma prueba.

Una lista de salas inicial más rápida y una recuperación fluida tras la reconexión son indicadores prácticos de que el cliente está utilizando la ruta esperada. No existe una mejora de velocidad universal: la implementación del cliente y la caché local, la latencia de la red, el rendimiento de la base de datos, el número de salas de la cuenta y la carga del servidor influyen en el resultado. La sincronización deslizante tampoco acelera las descargas de contenido multimedia ni repara una base de datos sobrecargada. Si la comprobación de compatibilidad es correcta, pero la aplicación sigue siendo lenta, compare con otro cliente compatible e investigue los cuellos de botella antes de modificar la configuración del proxy o la caché. Si aún utiliza clientes antiguos que dependen del proxy MSC3575 (ya obsoleto), pruebe su compatibilidad por separado antes de eliminar su antigua ruta de detección; no dé por sentado que un único punto final sirve para todas las generaciones de clientes.

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.