Coloca un servidor Synapse Matrix detrás de Cloudflare de forma segura.

Para colocar un servidor Synapse Matrix detrás del proxy estándar orange-cloud de Cloudflare, envíe tanto el tráfico de la API del cliente como el tráfico de federación entrante a través de HTTPS en el puerto 443. Mantenga TLS habilitado desde Cloudflare a su origen con Full (estricto), enrute las rutas de Matrix sin cambios a Synapse, publique el descubrimiento de federación que apunta a su nombre de host 443 y omita la caché en las rutas de la API. No apunte un registro proxy normal al puerto de federación predeterminado de Matrix, el 8448: el proxy estándar de Cloudflare no incluye ese puerto como compatible.

Comprueba que la configuración 443 sea compatible con tu servidor.

Este ejemplo asume que Synapse se ejecuta detrás de un proxy inverso como Nginx, Caddy o Traefik. Synapse puede permanecer en su red privada Docker en el puerto HTTP 8008; el proxy frontal gestiona TLS público. La federación puede usar HTTPS 443 cuando el descubrimiento apunta los servidores remotos a ese puerto. Synapse admite el puerto 443 como alternativa al puerto predeterminado 8448, mientras que Cloudflare incluye el puerto 443, pero no el 8448, entre sus puertos proxy estándar. Consulte la guía de puertos de Synapse y la lista de puertos compatibles de Cloudflare .

Utilice este método cuando los clientes y la federación deban compartir un nombre de host HTTPS con proxy. Si necesita mantener la federación en el puerto 8448, utilice un registro DNS únicamente o un producto de Cloudflare compatible con ese puerto TCP. El ejemplo utiliza example.orgidentificadores de matriz como @alice:example.orgy matrix.example.orgpara Synapse. Sustituya sus nombres de host, pero conserve el Synapse existente server_name; al cambiarlo, se modifican los identificadores de matriz de los usuarios.

Configura DNS, TLS y el proxy inverso.

1. Proxy únicamente para los nombres de host HTTP(S)

En Cloudflare DNS, configure el registro A/AAAA con matrix.example.orgla dirección pública de su proxy inverso y márquelo como "Proxyed". El example.orgnombre de host también debe llegar a un servidor web para los archivos de descubrimiento. Elimine un registro AAAA que no se pueda usar. Mantenga los registros MX, de solo correo y los que no son HTTP como "Solo DNS". Cloudflare finaliza TLS en su borde y abre una conexión separada a su origen.

Una tabla esquemática de registros DNS muestra los registros A con proxy para example.org y matrix.example.org, con iconos de estado en forma de nube de color naranja.
Configure un proxy para el servidor web de Matrix y el nombre de host que sirve para el descubrimiento; mantenga los registros de correo solo en DNS.

En la configuración SSL/TLS de Cloudflare, seleccione Completo (estricto). El proxy de origen debe aceptar HTTPS en el puerto 443 y presentar un certificado vigente emitido por una autoridad de confianza o la CA de origen de Cloudflare. Esto cifra y valida ambas partes; el modo Flexible puede dejar la conexión de origen sin cifrar o provocar bucles de redireccionamiento. Consulte la guía de configuración Completa (estricta)matrix.example.org de Cloudflare .

2. Pasar las solicitudes de Matrix a Synapse sin reescribirlas.

Configure el host virtual HTTPS del proxy inverso para matrix.example.orgque pase rutas que comiencen con /_matrixy /_synapse/clienta Synapse en la red privada, generalmente http://synapse:8008en Compose. Conserve la ruta de solicitud completa, reenvíe el Host original y configure X-Forwarded-Fory X-Forwarded-Proto. Estas rutas incluyen llamadas a la API del cliente y puntos finales de federación; evite enviar solo la página de inicio del navegador a Synapse o recortar un prefijo de ruta.

Un editor de configuración de proxy inverso genérico muestra las rutas de la API de Matrix reenviadas a Synapse en el puerto 8008 y el encabezado X-Forwarded-Proto.
Reenvía ambas familias de rutas de la API de Matrix a Synapse y conserva la ruta de la solicitud y los encabezados de reenvío.

En el oyente HTTP existente de Synapse, configúrelo x_forwarded: truepara que lea la dirección del cliente y el esquema del proxy. No vincule un oyente en contenedores a , ya que esto impide que otros contenedores lo alcancen. Mantenga el puerto 8008 privado para Compose. Consulte las instrucciones de proxy inverso127.0.0.1 de Synapse para obtener la sintaxis de su proxy específico.

Publicar el descubrimiento y evitar el almacenamiento en caché de la API.

3. Indica a los demás servidores domésticos que utilicen el puerto 443.

Debido a que los ID de Matrix de los usuarios se utilizan example.orgmientras se accede a Synapse en matrix.example.org, se sirve un archivo de descubrimiento de federación en https://example.org/.well-known/matrix/server. Devuelve el estado 200, el contenido JSON y este valor:

{"m.server":"matrix.example.org:443"}

El comando explícito :443envía servidores remotos al puerto proxy compatible. La especificación de federación Matrix define esta m.serverdelegación. Si el nombre del servidor Synapse es matrix.example.org, sirva el archivo conocido correspondiente allí o use serve_server_wellknownla opción de Synapse cuando ese nombre de host se enrute a Synapse en el puerto 443.

Para el descubrimiento automático de clientes, sirva https://example.org/.well-known/matrix/clientcon {"m.homeserver":{"base_url":"https://matrix.example.org"}}. Los clientes de navegador también necesitan los encabezados CORS requeridos por la especificación cliente-servidor de Matrix . Configure Synapse public_baseurlcon la URL HTTPS que los usuarios deben ingresar. Consulte la especificación de descubrimiento de servidores de Matrix y la referencia de configuración de Synapse .

Un editor JSON muestra la delegación de la federación m.server a matrix.example.org en el puerto 443 y la URL base del servidor principal del cliente.
Ofrecer delegación de federación en el dominio Matrix ID y dirigir a los clientes a la URL del servidor HTTPS.

4. Evitar la caché y los desafíos del navegador en las rutas de protocolo.

Crea una regla de caché para matrix.example.orgrutas coincidentes que comiencen con /_matrix/o /_synapse/client/, y selecciona Omitir caché . Esto protege las API de inicio de sesión, sincronización, federación y medios de las reglas personalizadas de caché de todo. Verifica también las reglas de WAF, bot y redireccionamiento: los clientes de Matrix no pueden resolver desafíos de intersticial del navegador. Mantén las protecciones habilitadas y limita cualquier excepción a las rutas de protocolo. Cloudflare describe la omisión en las instrucciones de su panel de control .

Verificar desde fuera de su red

Ejecute estas comprobaciones desde una máquina fuera de la LAN del servidor, de modo que la solicitud siga el DNS público y Cloudflare:

Una terminal muestra comprobaciones de curl para el archivo conocido de la federación Matrix y el punto final de versiones del cliente Synapse.
Compruebe el descubrimiento de la federación pública y la API del cliente a través del nombre de host de Cloudflare.
curl -i https://example.org/.well-known/matrix/server
curl -i https://example.org/.well-known/matrix/client
curl -i https://matrix.example.org/_matrix/client/versions
curl -i https://matrix.example.org/_matrix/federation/v1/version

Confirma que la primera solicitud devuelva JSON con m.serverel valor establecido en matrix.example.org:443, que el archivo del cliente nombre la URL base HTTPS y que las dos últimas devuelvan JSON válido en lugar de una página de desafío de Cloudflare, 404 o 502. Luego, inicia sesión desde un cliente y prueba la sincronización de una sala, sube un archivo y federa con una sala en otro servidor principal. Los servidores Matrix almacenan en caché las respuestas de descubrimiento de federación, por lo que los servidores remotos pueden conservar un valor anterior durante un tiempo después de que lo cambies; usa los encabezados de caché de la respuesta y deja tiempo para que caduquen los registros almacenados en caché.

Si las cargas de archivos fallan con HTTP 413, compare el tamaño del archivo con el límite de carga actual de la zona de Cloudflare y el de Synapse max_upload_size; el proxy inverso también tiene su propio límite de cuerpo de solicitud. El valor predeterminado documentado de Synapse es de 50 MB, y el límite de cuerpo predeterminado de Nginx puede ser menor. Los límites de Cloudflare varían según el plan y se pueden ajustar dentro de las reglas del plan, así que revise su documentación de límite de carga actual antes de aumentar el límite de Synapse. Si la API funciona pero la federación falla, primero verifique que la URL conocida del servidor sea pública, que su certificado de nombre de host sea válido y que el puerto delegado sea explícitamente 443. Si intencionalmente mantiene el puerto 8448, deje de usar el proxy DNS estándar de Cloudflare para ese registro y use un nombre de host de federación solo DNS directo en su lugar.

Dejar un comentario

Solucionar errores de permisos de administrador de sala de matriz mediante una acción

Rastrea el evento M_FORBIDDEN hasta los niveles de energía de la sala, la membresía o el acceso de administrador del servidor Synapse, y luego restaura solo el permiso que necesita la acción bloqueada.

Haga que su servidor Matrix Synapse sea accesible para la federación.

Haga que su servidor Matrix Synapse sea accesible para la federación.

Configure la detección de Synapse, HTTPS y el enrutamiento proxy para que otros servidores domésticos de Matrix puedan encontrar y contactar con su servidor.

Conectar Element Web con Keycloak a través de Synapse OIDC

Configure un cliente OIDC de Keycloak y un proveedor Synapse para que los usuarios de Element Web puedan iniciar sesión a través de su servidor de identidad sin exponer las credenciales de cliente.

Configure de forma segura la copia de seguridad de claves de elementos y la firma cruzada.

Configure de forma segura la copia de seguridad de claves de elementos y la firma cruzada.

Guarda una clave de recuperación, verifica tus sesiones de Element y comprueba que las claves de mensajes cifrados se puedan restaurar sin confundir la copia de seguridad con la contraseña de tu cuenta.

Evitar fallos de memoria de Matrix Synapse durante la sincronización del cliente

Diagnostica los fallos de falta de memoria de Synapse durante la sincronización, ajusta el almacenamiento en caché de forma segura, identifica las colas de solicitudes y verifica el uso estable de la memoria.

Solucionar errores de certificado TLS de Synapse Federation

Rastrea los fallos del certificado de federación de Matrix hasta el servidor correcto, repara la cadena TLS o la confianza de la CA y verifica la solución sin deshabilitar las comprobaciones de seguridad.

Coloca un servidor Synapse Matrix detrás de Cloudflare de forma segura.

Coloca un servidor Synapse Matrix detrás de Cloudflare de forma segura.

Los clientes de Route Matrix y la federación a través de Cloudflare en HTTPS 443 preservan el descubrimiento de Synapse y evitan el almacenamiento en caché del tráfico de la API o la interrupción de las cargas de medios.

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.