Ir al contenido

Puesta en producción

  • Un servidor Linux con Docker y Docker Compose.
  • Un nombre de dominio (por ejemplo visio.example.org) que apunte a ese servidor.
  • Un certificado HTTPS: los navegadores niegan el acceso a la cámara y al micrófono sin HTTPS (salvo en localhost).
  • Estos puertos abiertos en el cortafuegos:
Puerto Protocolo Función
443 (o el de tu proxy) TCP Página web y señalización WebSocket, a través del proxy HTTPS.
10000-10100 (RTC_MIN_PORT-RTC_MAX_PORT) UDP y TCP Flujos de audio y vídeo hacia el servidor SFU. El UDP es la vía normal; el TCP sirve de respaldo cuando la red bloquea el UDP. Solo se usan realmente los primeros NUM_WORKERS puertos, pero se publica todo el rango.
  1. Clonar el repositorio y crear el archivo de configuración:

    Ventana de terminal
    git clone https://codeberg.org/Militant/militant-visio.git
    cd militant-visio
    cp .env.example .env
  2. En .env, indicar como mínimo DOMAIN=visio.example.org. Si el servidor está detrás de un NAT, o si el dominio no apunta directamente a él, indicar también ANNOUNCED_IP con su dirección IP pública.

  3. Arrancar: make up.

  4. Colocar un proxy HTTPS delante del puerto 3000. Debe transmitir las conexiones WebSocket (ruta /socket.io/). Se incluye un ejemplo de configuración Nginx en docker/nginx.conf; hay que añadirle la terminación TLS o ponerlo detrás de tu propio acceso HTTPS.

  5. Comprobar: curl https://visio.example.org/health debe responder {"status":"ok","mediasoup":"running"}.

El servidor SFU debe indicar a los navegadores a qué dirección enviar los flujos:

  • si ANNOUNCED_IP está definida, se usa tal cual;
  • si no, y si DOMAIN no es localhost, la dirección IPv4 del dominio se resuelve al arrancar;
  • si no, no se anuncia ninguna dirección: solo funciona en local.

Algunas redes (empresas, universidades, conexiones móviles) bloquean el UDP. Un servidor TURN, por ejemplo Coturn, permite entonces que pasen los flujos. Se admiten dos modos:

  • Credenciales efímeras (recomendado): WEBRTC_TURN_URLS y WEBRTC_TURN_AUTH_SECRET, con el mismo secreto que static-auth-secret en Coturn (use-auth-secret).
  • Credenciales estáticas: WEBRTC_TURN_URLS, TURN_USERNAME y TURN_CREDENTIAL.

Ejemplo de WEBRTC_TURN_URLS:

turn:turn.example.org:3478?transport=udp,turn:turn.example.org:3478?transport=tcp,turns:turn.example.org:5349?transport=tcp