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

Para las llamadas de Matrix que fallan cuando los participantes están en redes diferentes, implemente coturn en un host con una IP pública, habilite sus credenciales REST de TURN con límite de tiempo y configure Synapse con la misma clave compartida y URI de TURN. Luego, permita el rango de escucha y retransmisión UDP de TURN a través de todos los firewalls. STUN puede ayudar a los clientes a descubrir rutas de red, pero TURN es el relé que transmite los medios cuando no se puede establecer una ruta directa.

Esta configuración es compatible con un servidor Synapse autohospedado y un host TURN independiente con Debian o Ubuntu y una dirección IPv4 pública estática. El ejemplo utiliza el oyente predeterminado de coturn en el puerto 3478 y el rango de retransmisión UDP predeterminado 49152–65535. Reemplace el dominio, la clave secreta y las rutas del ejemplo con los suyos. Si coturn está detrás de NAT, consulte la nota sobre NAT a continuación; un host público directamente accesible es más sencillo y fiable.

1. Apunte un nombre de host TURN al servidor.

Cree un registro DNS A que turn.example.comapunte a la dirección IPv4 pública del host de coturn. Utilice un nombre de host dedicado para que su configuración de red y certificado se pueda gestionar de forma independiente del servicio web Matrix. No publique un registro AAAA a menos que coturn tenga conectividad IPv6 funcional y las reglas de firewall correspondientes; una dirección IPv6 inaccesible puede provocar que algunos clientes elijan una ruta que falle.

La documentación actual de Synapse sobre TURN indica que el servicio TURN requiere una dirección IP pública. La traducción de direcciones de red (NAT) solo funciona cuando la puerta de enlace tiene una dirección pública y reenvía correctamente los puertos necesarios. La documentación advierte que las configuraciones de NAT aún pueden ser inestables. Consulte la documentación de configuración de Synapse TURN .

2. Instale coturn y configure el relé autenticado.

En Debian o Ubuntu, instale el paquete de distribución:

sudo apt update
sudo apt install coturn

Ábrelo /etc/turnserver.confcon un editor y configura los ajustes esenciales que se indican a continuación. Genera una contraseña secreta larga y aleatoria con un gestor de contraseñas o un generador criptográficamente seguro. Guarda esa misma contraseña en Synapse más adelante; no reutilices una contraseña de usuario de Matrix ni la publiques en un repositorio público.

listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=REPLACE_WITH_A_LONG_RANDOM_SECRET
realm=turn.example.com
server-name=turn.example.com
min-port=49152
max-port=65535

use-auth-secrety static-auth-secrethabilitar el mecanismo de credenciales REST de TURN que Synapse utiliza para emitir credenciales temporales. realmDebe ser un nombre de dominio para su servicio TURN. El rango de puertos de retransmisión es independiente del oyente: los clientes contactan con el puerto 3478 para solicitar una asignación, y luego los medios utilizan los puertos de retransmisión asignados. Los documentos de configuración de ejemplo de coturn incluyen opciones de oyente, retransmisión, TLS e IP externa; los valores predeterminados y las rutas del paquete de distribución pueden variar.

Habilite e inicie el servicio y, a continuación, compruebe su estado:

sudo systemctl enable --now coturn
sudo systemctl status coturn

Si su paquete tiene una bandera de habilitación separada en /etc/default/coturn, siga las instrucciones de ese archivo antes de iniciar el servicio. Revise los registros con sudo journalctl -u coturn -esi no se inicia.

3. Permitir el tráfico de escucha y retransmisión

Permita el tráfico UDP y TCP entrante en el puerto 3478, además de los puertos UDP entrantes 49152–65535, en el firewall del host y en cualquier firewall a nivel de proveedor. Por ejemplo, con UFW:

sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status

Mantenga el rango de retransmisión lo más estrecho posible, dentro de las posibilidades de su implementación, y asegúrese min-portde max-portque coincida con el rango del firewall. Si habilita un receptor TLS, abra también su puerto configurado y utilice la turns:URI y la configuración de certificado correspondientes. El uso de TLS en la conexión TURN es opcional para este ejemplo básico; las instrucciones de Synapse indican que los medios de voz y vídeo de WebRTC permanecen cifrados incluso cuando TURN utiliza su receptor UDP/TCP estándar, mientras que la seguridad de la señalización depende de la configuración HTTPS de su Matrix.

Para un host detrás de NAT, configure el mapeo de coturn external-ip=PUBLIC_IP/PRIVATE_IPy reenvíe tanto el puerto 3478 como todo el rango de retransmisión al host de coturn sin modificar los números de puerto de retransmisión externos. Por ejemplo, un puerto de retransmisión público 52000 debe alcanzar el puerto interno 52000. La guía de Synapse indica que NAT aún puede causar problemas; si no puede reenviar un amplio rango UDP, suele ser más práctico instalar coturn en un VPS con IP pública.

4. Conecta Synapse con coturn

Agregue la siguiente configuración al archivo de configuración activo de Synapse, generalmente homeserver.yaml. Haga coincidir el nombre de host, el puerto y el secreto con la configuración de coturn:

turn_uris:
  - "turn:turn.example.com:3478?transport=udp"
  - "turn:turn.example.com:3478?transport=tcp"
turn_shared_secret: "REPLACE_WITH_A_LONG_RANDOM_SECRET"
turn_user_lifetime: 86400000
turn_allow_guests: false

El valor de tiempo de vida se expresa en milisegundos; este ejemplo solicita a Synapse que emita credenciales válidas por 24 horas. Configure el acceso de invitados según su política de registro; no es necesario simplemente habilitar las llamadas para usuarios registrados. Manténgalo turn_shared_secretprivado e idéntico al de coturn static-auth-secret. No agregue una stun:URI como sustituto de TURN: ambos protocolos cumplen funciones relacionadas pero diferentes.

Reinicie Synapse después de validar la sintaxis YAML:

sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service

Las implementaciones de contenedores deben actualizar la configuración de Synapse montada y reiniciar el contenedor de Synapse. Es posible que los clientes deban recargar o actualizar la configuración de su servidor; Synapse indica que los clientes también pueden tardar hasta una hora en actualizar la configuración de TURN.

Verificar un candidato para el relevo

Realice la prueba desde un navegador o dispositivo en una red diferente a la del servidor TURN, como un teléfono con datos móviles. En un cliente Matrix basado en navegador, inspeccione la solicitud de autenticación del servidor principal /_matrix/client/v3/voip/turnServer(los clientes más antiguos pueden usar la ruta heredada /r0/). La respuesta debe incluir las URI de TURN y los campos de nombre de usuario y contraseña temporales; la especificación de Matrix define la respuesta de credenciales de este punto final.

Utilice esas credenciales en la prueba oficial WebRTC Trickle ICE , ingrese un servidor como turn:turn.example.com:3478?transport=udpy seleccione prueba de retransmisión si la página ofrece filtrado de tipo de candidato. Un resultado exitoso incluye un candidato cuyo tipo es relay. Finalmente, realice una llamada Matrix entre dispositivos en redes separadas. Una llamada que suena pero permanece en “conectando” a menudo indica puertos de retransmisión bloqueados, una asignación NAT incorrecta o credenciales que no coinciden; revise los registros de coturn y las notas de solución de problemas de TURN de Synapse antes de cambiar configuraciones de llamada no relacionadas.

Para el diagnóstico del navegador, Synapse recomienda chrome://webrtc-internals/usar Chrome y about:webrtcFirefox. Si el candidato a relé no aparece, primero confirme que la clave secreta coincide exactamente y luego verifique el puerto UDP 3478 y el rango completo de relés en los firewalls del host y del proveedor. El proyecto coturn documenta las opciones de puerto e IP externa en su referencia de turnserver .

Dejar un comentario

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.

¿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.