Files
Effi/docs/04-depannage/reseau-et-ports.md
T
Folzo d1e12cff60 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

5.1 KiB

🌐 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 :

# 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 :
ports:
  - "8201:8000"  # Au lieu de 8200:8000
  1. Ou arrêter le processus existant :
sudo kill -9 <PID>

Wake-on-LAN (WOL) non fonctionnel

Diagnostic

# 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 :

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)

# 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 :

sudo systemctl restart NetworkManager

Solution permanente :

# 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 :

# Sur effi-server
ip addr show
# Vérifier si l'IP est correcte

Solution temporaire :

# 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 :

# 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 :

# Sur folzo-Corp
sudo systemctl edit ollama.service

Ajouter :

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"
sudo systemctl daemon-reload
sudo systemctl restart ollama

Firewall et pare-feu

Ouvrir les ports sur folzo-Corp (Fedora/Bazzite)

# 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)

# 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 :

# 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 :

# 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é

# 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
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