Effi/docs/04-depannage/reseau-et-ports.md

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