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 .