Mise en production
Ce qu’il faut
Section intitulée « Ce qu’il faut »- 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. |
-
Cloner le dépôt et créer le fichier de configuration :
Fenêtre de terminal git clone https://codeberg.org/Militant/militant-visio.gitcd militant-visiocp .env.example .env -
Dans
.env, renseigner au minimumDOMAIN=visio.example.org. Si le serveur est derrière un NAT, ou si le domaine ne pointe pas directement vers lui, renseigner aussiANNOUNCED_IPavec son adresse IP publique. -
Démarrer :
make up. -
Placer un proxy HTTPS devant le port
3000. Il doit transmettre les connexions WebSocket (chemin/socket.io/). Un exemple de configuration Nginx est fourni dansdocker/nginx.conf; il faut y ajouter la terminaison TLS ou le placer derrière votre propre accès HTTPS. -
Vérifier :
curl https://visio.example.org/healthdoit répondre{"status":"ok","mediasoup":"running"}.
Adresse IP annoncée
Section intitulée « Adresse IP annoncée »Le serveur SFU doit indiquer aux navigateurs l’adresse à laquelle envoyer les flux :
- si
ANNOUNCED_IPest renseignée, elle est utilisée telle quelle ; - sinon, et si
DOMAINn’est paslocalhost, l’adresse IPv4 du domaine est résolue au démarrage ; - sinon, aucune adresse n’est annoncée : cela ne fonctionne qu’en local.
Réseaux restrictifs (TURN)
Section intitulée « Réseaux restrictifs (TURN) »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_URLSetWEBRTC_TURN_AUTH_SECRET, avec le même secret questatic-auth-secretdans Coturn (use-auth-secret). - Identifiants statiques :
WEBRTC_TURN_URLS,TURN_USERNAMEetTURN_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