Salti al la enhavo

Produktiva instalo

  • Linuksa servilo kun Docker kaj Docker Compose.
  • Domajna nomo (ekzemple visio.example.org), kiu montras al tiu servilo.
  • HTTPS-atestilo: retumiloj rifuzas aliron al kamerao kaj mikrofono sen HTTPS (krom ĉe localhost).
  • Jenaj pordoj malfermitaj en la fajroŝirmilo:
Pordo Protokolo Rolo
443 (aŭ tiu de via prokurilo) TCP Retpaĝo kaj WebSocket-signalado, tra la HTTPS-prokurilo.
10000-10100 (RTC_MIN_PORT-RTC_MAX_PORT) UDP kaj TCP Sonaj kaj videaj fluoj al la SFU-servilo. UDP estas la normala vojo; TCP servas kiel rezerva vojo, kiam la reto blokas UDP. Efektive uzataj estas nur la unuaj NUM_WORKERS pordoj, sed la tuta intervalo estas publikigita.
  1. Kloni la deponejon kaj krei la agordan dosieron:

    Terminal window
    git clone https://codeberg.org/Militant/militant-visio.git
    cd militant-visio
    cp .env.example .env
  2. En .env, agordi almenaŭ DOMAIN=visio.example.org. Se la servilo troviĝas malantaŭ NAT, aŭ se la domajno ne montras rekte al ĝi, agordi ankaŭ ANNOUNCED_IP per ĝia publika IP-adreso.

  3. Starti: make up.

  4. Meti HTTPS-prokurilon antaŭ la pordo 3000. Ĝi devas transdoni WebSocket-konektojn (vojo /socket.io/). Ekzemplo de Nginx-agordo troviĝas en docker/nginx.conf; aldonu al ĝi la TLS-finadon aŭ metu ĝin malantaŭ vian propran HTTPS-aliron.

  5. Kontroli: curl https://visio.example.org/health devas respondi {"status":"ok","mediasoup":"running"}.

La SFU-servilo devas sciigi al la retumiloj, al kiu adreso sendi la fluojn:

  • se ANNOUNCED_IP estas agordita, ĝi estas uzata senŝanĝe;
  • alie, se DOMAIN ne estas localhost, la IPv4-adreso de la domajno estas trovata ĉe la starto;
  • alie, neniu adreso estas anoncata: tio funkcias nur loke.

Iuj retoj (entreprenoj, universitatoj, poŝtelefonaj konektoj) blokas UDP. TURN-servilo, ekzemple Coturn, tiam ebligas la trairon de la fluoj. Du reĝimoj estas subtenataj:

  • Efemeraj akreditaĵoj (rekomendata): WEBRTC_TURN_URLS kaj WEBRTC_TURN_AUTH_SECRET, kun la sama sekreto kiel static-auth-secret en Coturn (use-auth-secret).
  • Fiksaj akreditaĵoj: WEBRTC_TURN_URLS, TURN_USERNAME kaj TURN_CREDENTIAL.

Ekzemplo 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