Bedrud utilise LiveKit pour gérer la communication vidéo et audio en temps réel. LiveKit fournit le serveur média SFU (Selective Forwarding Unit), et Bedrud gère l’authentification, la gestion des salles et les contrôles d’administration.

Intégré vs Externe

Bedrud supporte deux modes de déploiement LiveKit :

1. Mode Intégré (Par Défaut) : Le backend démarre et gère un processus serveur LiveKit en interne. Aucune infrastructure supplémentaire n’est requise - le backend gère le cycle de vie du processus LiveKit.
2. Mode Externe : Bedrud se connecte à un serveur LiveKit séparé ou un cluster. C’est utile pour la mise à l’échelle horizontale ou lors de l’utilisation d’une instance gérée LiveKit Cloud.

Configuration du Mode Externe

Pour utiliser un serveur LiveKit externe, définissez les clés suivantes dans config.yaml :

livekit:
  host: "wss://livekit.example.com:7880"    # Client WebSocket URL (ws:// or wss://)
  internalHost: "https://livekit.example.com:7880"  # Server-to-server API URL
  apiKey: "your-api-key"
  apiSecret: "your-api-secret"
  external: true          # Skip embedded LiveKit startup
  skipTLSVerify: false    # Set true if LiveKit uses self-signed certs

Lorsque embedded est false, Bedrud saute le démarrage du binaire LiveKit intégré. La clé API et le secret doivent correspondre aux identifiants du serveur externe.

Pour la configuration et la mise en place du cluster LiveKit, référez-vous à la documentation LiveKit.

Configuration Webhook (externe uniquement)

Lorsque vous utilisez un serveur LiveKit externe, vous devez configurer des webhooks pour que LiveKit puisse notifier Bedrud des déconnexions de participants et des fermetures de salle. Sans webhooks, l’état de la base de données deviendra obsolète.

Point de terminaison : https://<your-domain>/api/livekit/webhook

Authentification : Utilise la signature JWT de LiveKit — les mêmes apiKey/apiSecret que ceux configurés ci-dessus. Aucun secret séparé nécessaire.

LiveKit Cloud : Paramètres → Webhooks → Créer un nouveau webhook. Saisissez l’URL du point de terminaison et sélectionnez votre clé API.

LiveKit auto-hébergé : Ajoutez à votre configuration YAML LiveKit (ex. livekit.yaml) :

webhook:
  urls: ["https://bedrud.example.com/api/livekit/webhook"]
  api_key: "your-api-key"

Compatibilité des versions LiveKit

Le mode LiveKit intégré de Bedrud génère automatiquement une configuration compatible. Cependant, si vous auto-hébergez un serveur LiveKit externe, soyez conscient des changements de rupture entre les versions de LiveKit :

• LiveKit v1.12+ a supprimé le champ tls de premier niveau de sa configuration. Si vous utilisiez tls: dans votre YAML LiveKit, supprimez-le. Configurez http:// pour internalHost et ws:// pour host dans la configuration de Bedrud. TURN TLS est toujours pris en charge dans la section turn:.
• LiveKit v1.11 et versions antérieures prennent en charge tls: au niveau supérieur. Utilisez https:// pour internalHost et wss:// pour host.

En cas de doute, vérifiez la version de votre serveur LiveKit avec livekit-server --version et consultez les notes de version LiveKit.

Génération de configuration intégrée (Embedded Config Generation)

Lorsque TLS est activé en mode intégré, Bedrud génère une configuration YAML temporaire pour LiveKit (/tmp/bedrud-livekit-*.yaml) avec :

• TURN activé, domain défini automatiquement depuis server.host, udp_port: 3478, tls_port: 5349, et le certificat TLS du serveur réutilisé pour TURN/TLS
• node_ip résolu via livekit.nodeIP → server.host → détection automatique de l’IP sortante
• bind_addresses omis (LiveKit écoute sur toutes les interfaces par défaut)

Le fichier temporaire est supprimé à la sortie du processus LiveKit. Pour contourner la génération automatique avec une configuration statique, définissez livekit.configPath ou LIVEKIT_CONFIG_PATH.

Comment Cela Fonctionne

1. Création de Salle

Lorsqu’un utilisateur crée une salle dans Bedrud, le serveur ne crée pas immédiatement une salle LiveKit. Les salles LiveKit sont créées à la demande lorsque le premier participant rejoint.

2. Jetons de Rejoindre (Join Tokens)

Lorsqu’un utilisateur rejoint une réunion :

1. Le frontend envoie une requête à /api/room/join.

2. Le backend vérifie que l’utilisateur a la permission de rejoindre cette salle.

3. Le backend utilise sa Clé API et Secret pour générer un JWT signé (Jeton de Rejoindre).

4. Le jeton contient :

   • Le nom de la salle.
   • L’identité de l’utilisateur (nom d’affichage).
   • Permissions - par exemple, si l’utilisateur peut publier de l’audio ou partager son écran.

5. Le frontend reçoit ce jeton et se connecte directement au port média LiveKit (défaut 7880).

3. Contrôles de Salle (Admin)

Le backend utilise le SDK Go LiveKit pour effectuer des actions administratives :

• Expulser : Déconnecte un participant.
• Couper le Micro : Force le microphone d’un participant en sourdine.
• Permissions : Change ce qu’un participant peut faire en temps réel.

Architecture Réseau

• Port API (8090/443) : Gère les requêtes HTTP et la signalisation WebSocket pour la configuration des appels.
• Port Média (7880) : Gère les données vidéo et audio en utilisant les protocoles WebRTC. Le repli ICE/TCP utilise le port 7881 lorsque l’UDP est bloqué.
• Port TURN (3478 UDP / 5349 TLS) : Relaie le média pour les clients derrière des NAT ou pare-feux restrictifs. Voir Guide Serveur TURN.

Pour les exigences de pare-feu et de port, voir Connectivité WebRTC.

Troubleshooting

Startup & Config Crashes

Connectivity

Media & TURN

Webhook & State

Recording (Egress)

Bedrud uses LiveKit’s RoomCompositeEgress API to record rooms as MP4 files.

Prerequisites

• Redis — LiveKit egress requires Redis for coordinating egress workers. Without Redis, StartRoomCompositeEgress returns permission errors.

• Egress S3 storage (external mode only) — For external LiveKit, you must configure an egress: section in your LiveKit YAML so recordings are stored to durable S3-compatible storage. Otherwise the FileURL is a local path unreachable from Bedrud.

  egress:
    s3:
      access_key: "your-s3-access-key"
      secret_key: "your-s3-secret-key"
      endpoint: "http://minio:9000"
      bucket: "bedrud-recordings"
      region: "us-east-1"
      force_path_style: true

Troubleshooting: Recording

Voir aussi

• Guide Serveur TURN - Architecture TURN, configuration, TLS et dépannage
• Connectivité WebRTC - pile complète de connectivité STUN/ICE/TURN/SFU
• Vue d’Ensemble de l’Architecture - architecture complète du système