fix: détection automatique IP réseau pour connexions multi-appareils

Problème : Le serveur retournait ws://localhost:7880 aux clients, empêchant les connexions depuis d'autres appareils sur le réseau. Solution : - Ajout détection automatique IP réseau (WiFi/Ethernet) - Variable LIVEKIT_URL=AUTO pour mode auto-détection - Fonction getNetworkIP() avec priorité interfaces (en0, en1, eth0, wlan0) - Affichage IP détectée au démarrage du serveur - Fallback vers localhost si IP non détectée Modifications : - server/index.js : ajout getNetworkIP() et détection AUTO - server/.env : LIVEKIT_URL=AUTO par défaut - server/.env.example : documentation modes configuration - NETWORK_SETUP.md : guide complet configuration réseau et dépannage Les clients reçoivent maintenant ws://IP_RESEAU:7880 et peuvent se connecter depuis n'importe quel appareil sur le même réseau WiFi. Ports utilisés : - 3000 : API REST - 7880 : LiveKit WebSocket - 7882 : LiveKit UDP (RTP) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-22 22:27:34 +02:00
parent efd697a9d3
commit 24edf36d3c
3 changed files with 217 additions and 3 deletions
@@ -0,0 +1,150 @@
+# Configuration Réseau - Connexion Multi-Appareils
+
+## Problème résolu
+
+Le serveur retournait précédemment `ws://localhost:7880` aux clients, ce qui empêchait les connexions depuis d'autres appareils sur le réseau.
+
+## Solution
+
+Le serveur détecte maintenant automatiquement l'IP réseau locale et retourne l'URL LiveKit correcte aux clients.
+
+## Configuration
+
+### Fichier `.env`
+
+```bash
+# AUTO = détection automatique de l'IP réseau
+LIVEKIT_URL=AUTO
+
+# OU spécifier manuellement l'IP du serveur
+# LIVEKIT_URL=ws://192.168.1.100:7880
+```
+
+### Mode AUTO (recommandé)
+
+Le mode `AUTO` détecte automatiquement l'IP réseau :
+- **macOS** : WiFi (en0) ou Ethernet (en1)
+- **Linux** : eth0, wlan0, ou première interface réseau
+
+L'IP détectée est affichée au démarrage :
+```
+📡 IP réseau détectée : 10.1.1.111
+🔗 URL LiveKit clients : ws://10.1.1.111:7880
+```
+
+### Mode manuel
+
+Si la détection automatique ne fonctionne pas, spécifiez l'IP manuellement :
+
+1. Trouvez l'IP du serveur :
+   ```bash
+   # macOS
+   ifconfig | grep "inet " | grep -v 127.0.0.1
+
+   # Linux
+   ip addr show | grep "inet " | grep -v 127.0.0.1
+   ```
+
+2. Modifiez `.env` :
+   ```bash
+   LIVEKIT_URL=ws://VOTRE_IP:7880
+   ```
+
+## Test connexion multi-appareils
+
+### 1. Démarrer le serveur
+
+```bash
+cd server
+npm run dev
+```
+
+Notez l'IP affichée (ex: `10.1.1.111`)
+
+### 2. Accéder depuis un autre appareil
+
+#### Sur smartphone (même WiFi)
+
+1. Ouvrir navigateur
+2. Aller sur : `http://10.1.1.111:3000` (remplacer par l'IP serveur)
+3. Le client PWA va automatiquement recevoir l'URL LiveKit correcte
+
+#### Depuis un autre ordinateur
+
+Même procédure : `http://IP_SERVEUR:3000`
+
+## Ports utilisés
+
+- **3000** : API REST (serveur Express)
+- **7880** : LiveKit WebSocket (connexions WebRTC)
+- **7882** : LiveKit UDP (trafic RTP audio/vidéo)
+
+## Firewall et réseau
+
+### macOS
+
+Autorisez Node.js et LiveKit dans les préférences réseau si demandé.
+
+### Configuration WiFi recommandée
+
+- **QoS activée** : Priorisation trafic audio/vidéo
+- **Isolation client désactivée** : Permet communication entre appareils
+- **Band 5GHz** : Meilleure latence que 2.4GHz
+
+## Dépannage
+
+### Erreur "bind: address already in use"
+
+Un autre processus utilise le port 7880 ou 7882 :
+
+```bash
+# Trouver le processus
+lsof -i :7880
+lsof -i :7882
+
+# Tuer le processus si nécessaire
+kill -9 PID
+```
+
+### Client ne peut pas se connecter
+
+1. Vérifiez que le serveur tourne :
+   ```bash
+   curl http://IP_SERVEUR:3000/health
+   ```
+
+2. Vérifiez l'URL LiveKit retournée :
+   ```bash
+   curl http://IP_SERVEUR:3000/config
+   ```
+
+3. Testez la connexion LiveKit :
+   ```bash
+   # Depuis un navigateur sur le client
+   # Console DevTools :
+   const ws = new WebSocket('ws://IP_SERVEUR:7880');
+   ws.onopen = () => console.log('LiveKit accessible !');
+   ws.onerror = (e) => console.error('Erreur:', e);
+   ```
+
+### IP détectée incorrecte
+
+Si le serveur détecte la mauvaise IP (ex: VPN, Docker, etc.) :
+
+1. Utilisez le mode manuel dans `.env`
+2. Ou modifiez la priorité des interfaces dans `server/index.js` (ligne 28)
+
+## Sécurité
+
+⚠️ **En production**, utilisez HTTPS/WSS :
+
+```bash
+# .env
+LIVEKIT_URL=wss://votre-domaine.com:7880
+```
+
+Et configurez des certificats SSL pour LiveKit et Express.
+
+---
+
+**Dernière mise à jour** : 2026-05-22
@@ -5,5 +5,13 @@
 LIVEKIT_API_KEY=devkey
 LIVEKIT_API_SECRET=secret

-# Optionnel : override URL LiveKit
-# LIVEKIT_URL=ws://localhost:7880
+# URL LiveKit pour les clients
+# Pour permettre les connexions réseau, utilisez l'IP locale du serveur
+# Exemples :
+#   - Local uniquement : ws://localhost:7880
+#   - Réseau local : ws://192.168.1.100:7880 (remplacer par votre IP)
+#   - Utiliser AUTO pour détecter automatiquement l'IP réseau
+LIVEKIT_URL=AUTO
+
+# Mode LiveKit local (démarre livekit-server automatiquement)
+USE_LOCAL_LIVEKIT=true
@@ -6,6 +6,7 @@ import { spawn } from 'child_process';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { networkInterfaces } from 'os';
 import YAML from 'yaml';
 import { AccessToken } from 'livekit-server-sdk';

@@ -16,14 +17,61 @@ const configPath = join(__dirname, 'config', 'config.yaml');
 const configFile = readFileSync(configPath, 'utf8');
 const config = YAML.parse(configFile);

+/**
+ * Détecte l'IP réseau locale (WiFi/Ethernet)
+ * @returns {string|null} IP réseau ou null si non trouvée
+ */
+function getNetworkIP() {
+  const nets = networkInterfaces();
+
+  // Priorité : WiFi (en0 sur macOS) > Ethernet (en1)
+  const priorityInterfaces = ['en0', 'en1', 'eth0', 'wlan0'];
+
+  for (const interfaceName of priorityInterfaces) {
+    const interfaces = nets[interfaceName];
+    if (interfaces) {
+      for (const net of interfaces) {
+        // IPv4, non-interne
+        if (net.family === 'IPv4' && !net.internal) {
+          return net.address;
+        }
+      }
+    }
+  }
+
+  // Fallback : première IP non-interne trouvée
+  for (const name of Object.keys(nets)) {
+    for (const net of nets[name]) {
+      if (net.family === 'IPv4' && !net.internal) {
+        return net.address;
+      }
+    }
+  }
+
+  return null;
+}
+
 // Variables d'environnement
 const LIVEKIT_API_KEY = process.env.LIVEKIT_API_KEY || 'devkey';
 const LIVEKIT_API_SECRET = process.env.LIVEKIT_API_SECRET || 'secret';
-const LIVEKIT_URL = process.env.LIVEKIT_URL || config.server.livekit.url;
 const USE_LOCAL_LIVEKIT = process.env.USE_LOCAL_LIVEKIT === 'true';
 const SERVER_PORT = parseInt(process.env.PORT || config.server.port, 10);
 const SERVER_HOST = config.server.host;

+// Configuration URL LiveKit
+let LIVEKIT_URL = process.env.LIVEKIT_URL || config.server.livekit.url;
+
+// AUTO : détection automatique de l'IP réseau
+if (LIVEKIT_URL === 'AUTO') {
+  const networkIP = getNetworkIP();
+  if (networkIP) {
+    LIVEKIT_URL = `ws://${networkIP}:7880`;
+  } else {
+    console.warn('⚠️  IP réseau non détectée, utilisation de localhost');
+    LIVEKIT_URL = 'ws://localhost:7880';
+  }
+}
+
 // Logging
 const LOG_LEVEL = config.logging.level;

@@ -253,6 +301,14 @@ async function start() {
    log('info', 'Phase 1 - MVP');
    log('info', '');

+    // Affichage configuration réseau
+    const networkIP = getNetworkIP();
+    if (networkIP) {
+      log('info', `📡 IP réseau détectée : ${networkIP}`);
+    }
+    log('info', `🔗 URL LiveKit clients : ${LIVEKIT_URL}`);
+    log('info', '');
+
    // 1. Démarrer LiveKit (si mode local)
    if (USE_LOCAL_LIVEKIT) {
      await startLiveKitServer();