MiroTalk BRO: cómo montar tu propio streaming WebRTC para un ponente y cientos de espectadoresNota · digest del 19 de noviembre
MiroTalk BRO: cómo montar tu propio streaming WebRTC para un ponente y cientos de espectadores
Nota3 secciones≈ 5 min

MiroTalk BRO: cómo montar tu propio streaming WebRTC para un ponente y cientos de espectadores

Cinco comandos en la terminal y en un par de minutos tienes en localhost:3016 tu propia plataforma para transmisiones en directo. El video y la pantalla llegan al navegador de los espectadores con menos de un segundo de retraso y sin límite de duración. Eso sí, esa sencillez solo aguanta grupos pequeños: para una audiencia grande toca cambiar el modo de emisión desde el principio.

Hablamos de MiroTalk BRO, de Miroslav Pejic. Hace poco entró en Best of JS, aunque no es un experimento de ayer: el repositorio lleva vivo desde mayo de 2023, va por la versión v1.4.86 y suma cerca de 215 estrellas en GitHub.

P2P frente a SFU: por qué un solo ponente puede tumbar su propia conexión

Meet y Zoom están pensados para llamadas «todos con todos», mientras que un webinar o demo day pide un esquema «un ponente, muchos espectadores». YouTube Live y Twitch encajan mal en reuniones privadas: por el protocolo HLS meten varios segundos de retardo y además el tráfico pasa por servidores externos.

MiroTalk BRO usa WebRTC, el conjunto de protocolos integrado en los navegadores para video en tiempo real. Por defecto viene activo BROADCASTING=p2p: el navegador del presentador envía una copia independiente del flujo a cada espectador. El servidor descansa y no hace falta abrir puertos. Para cinco colegas va perfecto, pero con un par de decenas de espectadores la conexión y la CPU del ponente se ahogan.

Para emisiones de más de 100 espectadores se cambia al modo BROADCASTING=sfu. Un SFU (Selective Forwarding Unit) es un enrutador multimedia sobre el motor en C++/Node.js mediasoup. El ponente envía el flujo al servidor una sola vez, y mediasoup reparte copias al resto. De paso se activa simulcast: el presentador envía varios niveles de calidad para que quien tenga mala conexión reciba un video más ligero.

Arranque en cinco comandos y ajuste bajo carga

Para pruebas locales basta Node.js. Si compilas el SFU nativo en Ubuntu 24.04 LTS, instala antes build-essential y Python 3 (apt-get install -y build-essential python3 python3-pip), o mediasoup no compilará. Después es muy directo:

# Clonamos el proyecto y creamos las configuraciones desde las plantillas
git clone https://github.com/miroslavpejic85/mirotalkbro.git
cd mirotalkbro
cp .env.template .env
cp public/js/config.template.js public/js/config.js

# Instalamos dependencias y arrancamos en el puerto 3016
npm install && npm start

Abre http://localhost:3016 y las salas ya funcionan. El archivo public/js/config.js está en .gitignore, así que tus ajustes de interfaz y SFU no se pierden al hacer git pull.

Para pasar de P2P a mediasoup y evitar que cualquiera lance emisiones, editamos .env:

# Cambiamos a SFU y restringimos la emisión mediante token
BROADCASTING=sfu
ADMIN_ONLY_BROADCAST=true
ADMIN_TOKEN=replace_with_strong_token

# Puertos e IP externa (obligatoria detrás de NAT o en Docker)
MEDIASOUP_RTC_MIN_PORT=20000
MEDIASOUP_RTC_MAX_PORT=20099
MEDIASOUP_LISTEN_IP=0.0.0.0
MEDIASOUP_ANNOUNCED_IP=YOUR_PUBLIC_SERVER_IP

Olvidar MEDIASOUP_ANNOUNCED_IP es la causa número uno de pantalla negra en espectadores detrás de NAT. En producción resulta más cómodo usar la imagen mirotalk/bro:latest (corre bajo el usuario 1000:1000). En la documentación de self-hosting proponen este docker-compose.yml:

services:
  mirotalkbro:
    image: mirotalk/bro:latest
    user: '1000:1000'
    restart: unless-stopped
    ports:
      # Interfaz web y puertos multimedia SFU (UDP + TCP)
      - '${PORT}:${PORT}'
      - '20000-20099:20000-20099/udp'
      - '20000-20099:20000-20099/tcp'
    volumes:
      - .env:/src/.env:ro
      - ./public/js/config.js:/src/public/js/config.js:ro

Hay que abrir los puertos 20000-20099 en el firewall tanto en UDP como en TCP. Y copia public/js/config.js antes de lanzar docker-compose up -d: si no existe, Docker creará en silencio una carpeta vacía en su lugar y el contenedor fallará.

RTMP desde OBS, el costo de tu servidor y los matices de AGPL-3.0

También puedes transmitir desde OBS Studio: en modo SFU funciona la recepción RTMP (RTMP_ENABLED=true) mediante MediaMTX y FFmpeg. Para la webcam hay desenfoque o reemplazo de fondo directo en el navegador (imagen de hasta 10 MB, sin subirla al servidor, aunque se desactiva al compartir pantalla o usar RTMP).

Ahora el precio de la independencia. Además del VPS, necesitas dominio con HTTPS (sin cifrado el navegador bloquea la cámara) y puertos multimedia abiertos. Tras firewalls corporativos estrictos casi seguro hará falta un servidor TURN como Coturn. Además, el repositorio tiene solo dos colaboradores: salen actualizaciones con buen ritmo, pero no hay un gran equipo de soporte.

Otro detalle clave es la licencia AGPL-3.0. Para demos internas y webinars es gratuita. Pero si modificas el código e integras la plataforma en un SaaS comercial, el copyleft exige abrir el código fuente de todos tus cambios o comprar una licencia comercial. En resumen, MiroTalk BRO resuelve muy bien transmisiones privadas de decenas o un par de cientos de personas; para miles de espectadores distribuidos por CDN conviene ir directo a soluciones HLS como Owncast o a un sistema mayor como LiveKit.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3