Actualización, 6 de octubre de 2026: El proxy independiente Matrix Sliding Sync ya no es el componente adecuado para instalar. Matrix.org archivó su matrix-org/sliding-syncrepositorio en noviembre de 2025 porque implementaba la API MSC3575 anterior, que fue reemplazada por Simplified Sliding Sync (MSC4186). Synapse ha sido compatible con la implementación nativa desde la versión 1.114, con soporte habilitado por defecto. En julio de 2026, el equipo principal de Matrix Spec aceptó la propuesta principal de MSC4186; las propuestas de extensión relacionadas siguen siendo un trabajo independiente.
Para una implementación móvil moderna de Synapse, la configuración práctica consiste en ejecutar una versión actual de Synapse, confirmar que anuncia la sincronización deslizante nativa, garantizar que el proxy inverso transmita las rutas de la API del cliente Matrix sin modificaciones y utilizar un cliente móvil compatible. No se requiere un contenedor de proxy independiente, una base de datos de proxy ni una URL de detección de proxy antigua.
No, no para una nueva implementación destinada a los clientes móviles actuales de Matrix. El proxy archivado implementa MSC3575, no el flujo nativo MSC4186 más reciente. El propio repositorio del proyecto indica que ya no recibe mantenimiento y que no se espera que los clientes modernos de Matrix funcionen con él. Matrix.org también anunció el cambio a la compatibilidad nativa y la eliminación de la compatibilidad con el proxy MSC3575 en Element X en enero de 2025.
La guía histórica sobre proxies aún puede ser útil para identificar una instalación antigua: utilizaba PostgreSQL, un secreto persistente y una SYNCV3_*configuración de entorno. Estas instrucciones describen una arquitectura obsoleta. No las copie en un servidor nuevo ni exponga públicamente un proxy antiguo solo porque un tutorial antiguo lo recomiende como más rápido.
El proxy anterior era un servicio independiente que se ubicaba entre el cliente y su servidor principal. La sincronización deslizante simplificada está implementada en Synapse. Permite que los clientes compatibles soliciten una ventana relevante de la lista de salas de un usuario y la actualicen de forma incremental, lo que puede reducir la cantidad de trabajo de sincronización que debe realizar una aplicación móvil al abrir o volver a una cuenta grande.
Se trata de una mejora de sincronización, no de una garantía de que todas las pantallas se carguen al instante. No elimina problemas como un servidor multimedia lento, una conexión a una sala remota con retraso, una cobertura móvil deficiente o una base de datos saturada. La aplicación móvil debe ser compatible con MSC4186 y el servidor principal debe anunciarlo. El anuncio de Matrix.org indica que la implementación nativa de Synapse evita el almacenamiento de datos independiente y la limitación de sincronización completa inicial del antiguo proxy.
Consulta el punto final de versiones de la API pública cliente-servidor desde una terminal. Reemplaza el host de ejemplo con la URL base pública que utilizan tus clientes Matrix:
curl -fsS https://matrix.example.org/_matrix/client/versions | jq -r '.unstable_features["org.matrix.simplified_msc3575"]'Una respuesta de truesignifica que el servidor anuncia la función nativa de Sincronización deslizante simplificada. Una respuesta de false, null, o una clave faltante significa que debe verificar la versión y la configuración de Synapse antes de probar el cliente. Si jqno está instalado, solicite la misma URL en un navegador o ejecute curl -fsS https://matrix.example.org/_matrix/client/versionse inspeccione la respuesta JSON.
Este indicador señala la capacidad del servidor; no prueba que una versión específica de la aplicación sea compatible ni que todas las rutas del proxy inverso sean correctas. Utilice un cliente cuyas notas de la versión documenten la compatibilidad nativa con Sliding Sync y verifique la ruta de la solicitud en sus registros o en los diagnósticos del navegador/red, si están disponibles.
Synapse 1.114 y versiones posteriores habilitan la sincronización deslizante nativa de forma predeterminada. Si la respuesta de versiones ya está disponible true, normalmente no es necesario instalar ningún servicio adicional ni crear una nueva base de datos de sincronización. Evite agregar configuraciones especulativas solo porque las guías antiguas describan el proxy.
Si la función está explícitamente deshabilitada en su configuración de Synapse, revise la configuración en experimental_features. En las versiones que utilizan la bandera documentada, el YAML relevante es:
experimental_features:
msc3575_enabled: trueSolo agregue o modifique esta configuración después de consultar la documentación de configuración de su versión de Synapse instalada. Realice una copia de seguridad homeserver.yaml, conserve el resto del experimental_featuresbloque existente y mantenga la indentación YAML consistente. Valide el archivo con el comando de validación de configuración de Synapse para su instalación y, a continuación, reinicie Synapse mediante el administrador de servicios o el método de orquestación de contenedores que ya utiliza. Vuelva a comprobarlo /_matrix/client/versionsposteriormente.
Si utiliza una versión anterior a la 1.114, planifique una actualización de Synapse siguiendo las instrucciones oficiales. Lea las notas de la versión intermedia, realice una copia de seguridad de la base de datos y los archivos de configuración/medios, y siga la ruta de actualización compatible con su implementación. No combine la actualización del servidor principal, la reescritura del proxy inverso y la eliminación del proxy antiguo en un único cambio no verificado.
Normalmente no. Native Sliding Sync utiliza una ruta de API de cliente-servidor de Matrix en /_matrix/client, por lo que su proxy inverso existente debería reenviar el espacio de nombres de la API del cliente de Matrix a Synapse. La guía oficial del proxy inverso de Synapse indica que se deben reenviar /_matrixy /_synapse/clienty que se debe conservar la URI de la solicitud en lugar de canonizarla o normalizarla.
/_matrix/client/versionsSi Synapse funciona pero una aplicación compatible no puede sincronizarse, revise sus reglas de proxy . Confirme que las solicitudes /_matrix/client/unstable/org.matrix.simplified_msc3575/llegan a Synapse y no se envían a un proxy MSC3575 residual, no son bloqueadas por un firewall de aplicaciones web ni se modifican mediante una regla de ruta. Si Synapse se ejecuta detrás de un proxy, conserve los encabezados forwarded-protocol y client-IP correctos descritos en la documentación de Synapse.
No cree una nueva org.matrix.msc3575.proxyentrada /.well-known/matrix/clientpara la compatibilidad nativa. Esa clave anuncia la API de proxy obsoleta. Si la agregó previamente en un archivo JSON estático conocido o en Synapse extra_well_known_client_content, elimine únicamente esa propiedad de proxy heredada después de verificar que ningún cliente antiguo requerido dependa de ella. Mantenga intacta la información normal de detección del servidor principal.
true.La base de datos del proxy almacenaba el estado de sincronización del proxy en lugar de reemplazar el historial de salas de Synapse. Aun así, evite eliminarla durante la migración inicial: sirve como referencia para solucionar problemas de la configuración anterior y como límite de reversión más seguro mientras los usuarios migran a sesiones nativas.
Si dispone de mediciones de referencia fiables, compare el mismo cliente, cuenta, dispositivo y red antes y después del cambio. Registre el tiempo transcurrido desde que se abre la aplicación hasta que aparece una lista de salas utilizable, compruebe si los mensajes recientes se muestran sin un indicador de carga prolongado y si la aplicación se actualiza tras un breve periodo sin conexión. Repita la comparación varias veces; un único inicio puede verse afectado por el estado de la caché, las condiciones de la red o una descarga de archivos multimedia de gran tamaño.
Si el cliente sigue realizando /syncsolicitudes normales y nunca anuncia ni intenta usar la compatibilidad nativa, compruebe la versión del cliente y su configuración de sincronización. Si solicita el punto final simplificado pero recibe un error, revise los registros de Synapse y del proxy inverso para esa solicitud. Compruebe el estado de la base de datos y la carga del servidor si muchos usuarios informan de una carga lenta. La sincronización deslizante puede reducir el trabajo de sincronización, pero no puede compensar una base de datos sobrecargada ni una solicitud de API mal enrutada.
| Acercarse | Mejor ajuste | Costo o limitación |
|---|---|---|
| Sincronización deslizante simplificada nativa en Synapse | Implementaciones de Synapse nuevas o mantenidas y clientes compatibles | Requiere un cliente compatible; el rendimiento aún depende del estado del servidor y de la base de datos. |
| proxy MSC3575 heredado | Únicamente para comprender o mantener temporalmente una configuración de prueba antigua. | Archivado, sin mantenimiento y sin posibilidad de trabajar con clientes modernos. |
| Sincronización de matriz heredada | Clientes o servidores domésticos sin compatibilidad nativa con Sliding Sync | Sigue funcionando para clientes compatibles, pero no ofrece el mismo comportamiento nativo de lista de salas deslizantes. |
El repositorio proxy independiente está archivado. La implementación nativa de Synapse data de la versión 1.114. El equipo principal de la especificación Matrix aceptó la propuesta principal MSC4186 en julio de 2026, mientras que las extensiones relacionadas permanecen separadas. Synapse, los clientes móviles y la especificación Matrix siguen evolucionando, así que consulte la documentación y las notas de la versión para conocer las versiones exactas que utiliza.
Diagnosticar y reducir de forma segura el almacenamiento multimedia de Matrix Synapse, purgar la caché remota, gestionar las cargas locales y configurar la retención para evitar incidentes de disco lleno.
Solucione el problema de la advertencia HSTS faltante en Nextcloud configurando el servidor web HTTPS o el proxy inverso, y luego verifique de forma segura el encabezado Strict-Transport-Security.
Solucione el error "CSync Unknown Error" del cliente de escritorio de ownCloud reconstruyendo la base de datos de sincronización oculta y, a continuación, verifique la conectividad, los permisos, los nombres de archivo, el espacio en disco y los registros.
El proxy Matrix Sliding Sync está archivado y reemplazado. Habilite la sincronización deslizante simplificada nativa en Synapse, verifique la compatibilidad del cliente, actualice el enrutamiento del proxy y pruebe la sincronización móvil de forma segura.
Diagnostique la lentitud en la federación de Matrix Synapse y en las uniones a salas comprobando la conectividad, el estado de reintento del servidor remoto, las métricas, la carga de la base de datos y los límites de velocidad de unión.
Configure la retención de la papelera de Nextcloud y las tareas en segundo plano para eliminar automáticamente los archivos borrados, verificar la limpieza y evitar comandos de purga inseguros para todos los usuarios.
Diagnostica el eco de BigBlueButton y el retardo de audio de WebRTC separando la retroalimentación del micrófono del retardo de la red, comprobando la prueba de eco, los dispositivos del navegador, la conectividad UDP y la carga del servidor.
Configura un repositorio Restic cifrado y una tarea programada (cron job) para Nextcloud, incluyendo el modo de mantenimiento, una copia de seguridad de MariaDB, retención, registros y comprobaciones de restauración.
Solucione los problemas de cargas de ownCloud que se quedan atascadas en el 99 % revisando los registros, el almacenamiento temporal, el espacio de fragmentos, los límites de PHP, las sesiones, los proxies y el bloqueo de archivos en el orden correcto.
Habilite y aplique correctamente la autenticación de dos factores (2FA) de Zimbra, registre una cuenta de administrador, elija la verificación por TOTP o correo electrónico y pruebe el inicio de sesión en la consola de administración.
