Ir al contenido

Configuración

Todas las variables van en .env; .env.example las documenta. make pasa --env-file .env a Compose para que los puertos publicados (PORT, RTC_MIN_PORT, RTC_MAX_PORT) también sigan el .env. Sin make, usa docker compose --env-file .env -f docker/docker-compose.yml up -d.

Variable Función Por defecto
PORT Puerto HTTP expuesto por Docker en el anfitrión. 3000
DOMAIN Nombre de dominio público; también sirve para detectar la IP anunciada. localhost
ANNOUNCED_IP Dirección IP pública anunciada a los navegadores para los flujos. detectada desde DOMAIN
RTC_MIN_PORT Primer puerto (UDP y TCP) de los flujos de audio y vídeo. 10000
RTC_MAX_PORT Último puerto (UDP y TCP) de los flujos de audio y vídeo; limita el número de workers. 10100
NUM_WORKERS Número de workers de mediasoup; cada sala funciona en un worker y cada worker escucha en su puerto (RTC_MIN_PORT, +1, +2…). Si Coturn u otros servicios comparten la máquina, deja un núcleo libre (p. ej. 3 de 4 núcleos). uno por núcleo
PEERS_PER_ROUTER Cuando una sala tiene este número de personas en un worker, las siguientes van a otro worker y sus flujos se retransmiten entre workers (pipeToRouter). Así una sala grande ya no queda limitada a un solo núcleo (unas 20 personas con vídeo). 0 = una sala siempre queda en un solo worker. 10
MAX_INCOMING_BITRATE Tasa máxima recibida por participante, en bit/s. 3500000
INITIAL_OUTGOING_BITRATE Tasa inicial enviada a cada participante, en bit/s. 2000000
HEALTH_DETAILS true: /health indica también el número de salas y de personas conectadas. desactivado
Variable Función Por defecto
STUN_URLS Servidores STUN, separados por comas. ninguno
WEBRTC_TURN_URLS Servidores TURN, separados por comas. ninguno
WEBRTC_TURN_AUTH_SECRET Secreto compartido de Coturn para credenciales efímeras. ninguno
WEBRTC_TURN_REALM Realm de Coturn. ninguno
WEBRTC_TURN_TTL Validez de las credenciales efímeras, en segundos. 3600
TURN_USERNAME Usuario TURN estático (si no hay secreto compartido). ninguno
TURN_CREDENTIAL Contraseña TURN estática. ninguno
Variable Función Por defecto
NEXT_PUBLIC_SOCKET_URL Dirección del servidor de señalización, si difiere de la página. dirección de la página
NEXT_PUBLIC_SOURCE_URL Enlace «Código fuente» del pie de página. Cámbialo si despliegas una versión modificada (obligación de la AGPL). repositorio de Codeberg
NEXT_PUBLIC_DOCS_URL Dirección del sitio de documentación, usada por los enlaces «Documentación» y «Autoalojar» de la portada. sitio de documentación oficial

Las variables NEXT_PUBLIC_* se integran en el código durante npm run build: para cambiarlas con Docker hay que reconstruir la imagen (make build).

Contenedor y seguridad (se leen al arrancar)

Sección titulada «Contenedor y seguridad (se leen al arrancar)»
Variable Función Por defecto
FRAME_ANCESTORS Sitios autorizados a integrar Visio en un <iframe>, separados por espacios (p. ej. https://militant.example.org). El servidor envía Content-Security-Policy: frame-ancestors. Las entradas no válidas se ignoran. vacío: cualquier sitio puede integrarlo
MEMORY_LIMIT Memoria máxima del contenedor. 1g
PIDS_LIMIT Número máximo de procesos del contenedor. 512

El contenedor funciona sin privilegios: no-new-privileges, ninguna capacidad de Linux (cap_drop: ALL), sistema de archivos de solo lectura (solo /tmp es escribible). El servidor envía Strict-Transport-Security, X-Content-Type-Options, Referrer-Policy y Permissions-Policy, y ya no revela X-Powered-By.