Aller au contenu

Mise en production

  • Un serveur Linux avec Docker et Docker Compose.
  • Un nom de domaine (par exemple visio.example.org) qui pointe vers ce serveur.
  • Un certificat HTTPS : les navigateurs refusent l’accès à la caméra et au micro sans HTTPS (sauf sur localhost).
  • Les ports suivants ouverts dans le pare-feu :
Port Protocole Rôle
443 (ou celui de votre proxy) TCP Page web et signalisation WebSocket, via le proxy HTTPS.
10000-10100 (RTC_MIN_PORT-RTC_MAX_PORT) UDP et TCP Flux audio et vidéo vers le serveur SFU. L’UDP est la voie normale ; le TCP sert de repli quand le réseau bloque l’UDP. Seuls les NUM_WORKERS premiers ports sont réellement utilisés, mais toute la plage est publiée.
  1. Cloner le dépôt et créer le fichier de configuration :

    Fenêtre de terminal
    git clone https://codeberg.org/Militant/militant-visio.git
    cd militant-visio
    cp .env.example .env
  2. Dans .env, renseigner au minimum DOMAIN=visio.example.org. Si le serveur est derrière un NAT, ou si le domaine ne pointe pas directement vers lui, renseigner aussi ANNOUNCED_IP avec son adresse IP publique.

  3. Démarrer : make up.

  4. Placer un proxy HTTPS devant le port 3000. Il doit transmettre les connexions WebSocket (chemin /socket.io/). Un exemple de configuration Nginx est fourni dans docker/nginx.conf ; il faut y ajouter la terminaison TLS ou le placer derrière votre propre accès HTTPS.

  5. Vérifier : curl https://visio.example.org/health doit répondre {"status":"ok","mediasoup":"running"}.

Le serveur SFU doit indiquer aux navigateurs l’adresse à laquelle envoyer les flux :

  • si ANNOUNCED_IP est renseignée, elle est utilisée telle quelle ;
  • sinon, et si DOMAIN n’est pas localhost, l’adresse IPv4 du domaine est résolue au démarrage ;
  • sinon, aucune adresse n’est annoncée : cela ne fonctionne qu’en local.

Certains réseaux (entreprises, universités, connexions mobiles) bloquent l’UDP. Un serveur TURN, par exemple Coturn, permet alors de faire passer les flux. Deux modes sont pris en charge :

  • Identifiants éphémères (recommandé) : WEBRTC_TURN_URLS et WEBRTC_TURN_AUTH_SECRET, avec le même secret que static-auth-secret dans Coturn (use-auth-secret).
  • Identifiants statiques : WEBRTC_TURN_URLS, TURN_USERNAME et TURN_CREDENTIAL.

Exemple 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