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