Initial commit: Documentation Effi v1.0

- Structure complète du projet - Docker compose de production - Documentation organisée par thèmes - Guides d'installation et configuration - Section dépannage détaillée - Journal historique
2026-04-04 08:45:59 +02:00
commit d1e12cff60
35 changed files with 4656 additions and 0 deletions
@@ -0,0 +1,256 @@
+# 🌐 Dépannage Réseau et Ports
+
+## Conflits de ports
+
+### Symptôme : `bind: address already in use`
+
+**Erreur :**
+```
+Error starting userland proxy: listen tcp 0.0.0.0:8200: bind: address already in use
+```
+
+**Diagnostic :**
+```bash
+# Trouver quel processus utilise le port
+sudo ss -tlnp | grep 8200
+# ou
+sudo lsof -i :8200
+
+# Voir tous les ports utilisés
+sudo ss -tlnp
+```
+
+**Solutions :**
+
+1. **Changer le port dans docker-compose.yml :**
+```yaml
+ports:
+  - "8201:8000"  # Au lieu de 8200:8000
+```
+
+2. **Ou arrêter le processus existant :**
+```bash
+sudo kill -9 <PID>
+```
+
+---
+
+## Wake-on-LAN (WOL) non fonctionnel
+
+### Diagnostic
+
+```bash
+# Vérifier que wol-proxy est configuré
+docker logs wol-proxy | tail -20
+
+# Tester le WoL manuellement
+sudo apt install wakeonlan
+wakeonlan XX:XX:XX:XX:XX:XX  # MAC de folzo-Corp
+
+# Vérifier que la carte réseau supporte WoL
+ethtool enp3s0 | grep -i wake
+```
+
+### Configuration wol-proxy
+
+**Vérifier les variables dans `.env` :**
+```bash
+OLLAMA_HOST=192.168.1.11
+PC_GAMING_MAC=XX:XX:XX:XX:XX:XX
+BROADCAST_IP=192.168.1.255
+```
+
+### Activer WoL sur le PC Gaming (folzo-Corp)
+
+```bash
+# Sur Bazzite/Fedora
+sudo ethtool -s enp3s0 wol g
+
+# Rendre permanent
+echo 'ACTION=="add", SUBSYSTEM=="net", NAME=="enp3s0", RUN+="/usr/sbin/ethtool -s enp3s0 wol g"' | \
+  sudo tee /etc/udev/rules.d/99-wol.rules
+```
+
+---
+
+## Interface réseau qui tombe (effi-server)
+
+### Symptôme : effi-server inaccessible après reboot
+
+**Cause :** Problème de carte réseau Intel i225/i226 avec power saving
+
+**Solution immédiate :**
+```bash
+sudo systemctl restart NetworkManager
+```
+
+**Solution permanente :**
+```bash
+# Désactiver le power saving
+echo 'ACTION=="add", SUBSYSTEM=="net", NAME=="enp3s0", RUN+="/usr/sbin/ethtool -s enp3s0 wol g"' | \
+  sudo tee /etc/udev/rules.d/99-disable-net-powersave.rules
+
+# Recharger les règles
+sudo udevadm control --reload-rules
+sudo udevadm trigger
+```
+
+---
+
+## Conflit DHCP - Deux machines avec même IP
+
+### Symptôme : `conflict detected for IP address`
+
+**Diagnostic :**
+```bash
+# Sur effi-server
+ip addr show
+# Vérifier si l'IP est correcte
+```
+
+**Solution temporaire :**
+```bash
+# Renouveler le bail DHCP
+sudo nmcli device disconnect enp6s0
+sudo nmcli device connect enp6s0
+```
+
+**Solution permanente :**
+- Configurer des réservations DHCP par MAC sur le routeur
+- Ou configurer des IPs statiques
+
+---
+
+## Erreurs de connexion entre machines
+
+### Ollama inaccessible depuis effi-server
+
+**Diagnostic :**
+```bash
+# Depuis effi-server
+curl http://192.168.1.11:11434/api/tags
+
+# Vérifier que Ollama écoute sur 0.0.0.0
+# Sur folzo-Corp :
+sudo ss -tlnp | grep 11434
+# Devrait afficher 0.0.0.0:11434, pas 127.0.0.1:11434
+```
+
+**Solution :** Configurer Ollama pour écouter sur toutes les interfaces :
+```bash
+# Sur folzo-Corp
+sudo systemctl edit ollama.service
+```
+
+Ajouter :
+```ini
+[Service]
+Environment="OLLAMA_HOST=0.0.0.0:11434"
+```
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl restart ollama
+```
+
+---
+
+## Firewall et pare-feu
+
+### Ouvrir les ports sur folzo-Corp (Fedora/Bazzite)
+
+```bash
+# Ouvrir les ports pour STT et TTS
+sudo firewall-cmd --add-port=8200/tcp --permanent  # speaches
+sudo firewall-cmd --add-port=8100/tcp --permanent  # openedai-speech
+sudo firewall-cmd --add-port=11434/tcp --permanent # Ollama
+sudo firewall-cmd --reload
+```
+
+### Ouvrir les ports sur effi-server (Ubuntu)
+
+```bash
+# Avec UFW
+sudo ufw allow 3000/tcp   # OpenWebUI
+sudo ufw allow 5678/tcp   # n8n
+sudo ufw allow 5984/tcp   # CouchDB
+sudo ufw allow 6333/tcp   # Qdrant
+sudo ufw allow 8000/tcp   # mcpo
+sudo ufw reload
+```
+
+---
+
+## Erreur 500 / Connection refused
+
+### OpenWebUI : "Server Connection Error"
+
+**Diagnostic :**
+```bash
+# Voir les logs
+docker logs open-webui | grep -i "error\|connection"
+
+# Vérifier si Ollama répond
+curl http://192.168.1.27:3011/v1/models
+```
+
+**Causes possibles :**
+1. PC Gaming éteint → WoL devrait le réveiller
+2. wol-proxy mal configuré
+3. Ollama planté sur folzo-Corp
+
+**Solutions :**
+```bash
+# Redémarrer wol-proxy
+docker restart wol-proxy
+
+# Sur folzo-Corp, vérifier Ollama
+sudo systemctl status ollama
+sudo systemctl restart ollama
+```
+
+---
+
+## Latence réseau élevée
+
+### Test de connectivité
+
+```bash
+# Ping entre les machines
+ping 192.168.1.11
+
+# Test de bande passante
+iperf3 -s  # Sur serveur
+iperf3 -c 192.168.1.27  # Sur client
+
+# Vérifier les erreurs réseau
+ifconfig | grep -i error
+```
+
+### Optimisations
+
+1. **Utiliser des IPs fixes** : Éviter les délais DHCP
+2. **Câblage Ethernet** : Préférer le filaire au WiFi
+3. **MTU** : Vérifier la taille des paquets
+```bash
+ping -M do -s 1472 192.168.1.11
+```
+
+---
+
+## Tableau des ports utilisés
+
+| Port | Service | Machine | Protocole |
+|------|---------|---------|-----------|
+| 3000 | Open WebUI | effi-server | TCP |
+| 3011 | wol-proxy | effi-server | TCP |
+| 3100 | Obsidian | effi-server | TCP |
+| 5678 | n8n | effi-server | TCP |
+| 5984 | CouchDB | effi-server | TCP |
+| 6333 | Qdrant HTTP | effi-server | TCP |
+| 6334 | Qdrant gRPC | effi-server | TCP |
+| 8000 | mcpo | effi-server | TCP |
+| 8100 | openedai-speech | folzo-Corp | TCP |
+| 8200 | speaches | folzo-Corp | TCP |
+| 9099 | pipelines | effi-server | TCP |
+| 11434 | Ollama | folzo-Corp | TCP |