Puesta en producción
Requisitos
Sección titulada «Requisitos»- 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. |
-
Clonar el repositorio y crear el archivo de configuración:
Ventana de terminal git clone https://codeberg.org/Militant/militant-visio.gitcd militant-visiocp .env.example .env -
En
.env, indicar como mínimoDOMAIN=visio.example.org. Si el servidor está detrás de un NAT, o si el dominio no apunta directamente a él, indicar tambiénANNOUNCED_IPcon su dirección IP pública. -
Arrancar:
make up. -
Colocar un proxy HTTPS delante del puerto
3000. Debe transmitir las conexiones WebSocket (ruta/socket.io/). Se incluye un ejemplo de configuración Nginx endocker/nginx.conf; hay que añadirle la terminación TLS o ponerlo detrás de tu propio acceso HTTPS. -
Comprobar:
curl https://visio.example.org/healthdebe responder{"status":"ok","mediasoup":"running"}.
Dirección IP anunciada
Sección titulada «Dirección IP anunciada»El servidor SFU debe indicar a los navegadores a qué dirección enviar los flujos:
- si
ANNOUNCED_IPestá definida, se usa tal cual; - si no, y si
DOMAINno eslocalhost, la dirección IPv4 del dominio se resuelve al arrancar; - si no, no se anuncia ninguna dirección: solo funciona en local.
Redes restrictivas (TURN)
Sección titulada «Redes restrictivas (TURN)»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_URLSyWEBRTC_TURN_AUTH_SECRET, con el mismo secreto questatic-auth-secreten Coturn (use-auth-secret). - Credenciales estáticas:
WEBRTC_TURN_URLS,TURN_USERNAMEyTURN_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