dashboard/NETWORK_CONFIG.md

🌐 Configuration Réseau - MCP Browser

✅ CONFIGURATION ACTUELLE

Mode: HOST NETWORK

Le dashboard utilise le réseau de l'hôte directement (pas de NAT Docker).

URL d'accès:

• MCP Browser: http://192.168.1.2:8000
• Local: http://localhost:8000
• Container: http://localhost:8000 (depuis l'intérieur)

---

🔧 CONFIGURATION

docker-compose.yaml

services:
  dashboard_web:
    network_mode: "host"
    # Pas de mapping de ports nécessaire

IP de l'hôte

hostname -I | awk '{print $1}'
# Résultat: 192.168.1.2

---

📝 URLS À UTILISER

Pour le MCP Browser

http://192.168.1.2:8000              # Dashboard
http://192.168.1.2:8000/health       # Health check
http://192.168.1.2:8000/api/metrics  # API

Pour les tests locaux

http://localhost:8000                # Dashboard
http://localhost:8000/docs           # Swagger UI

---

🧪 COMMANDES DE TEST

Health check

curl http://localhost:8000/health
# {"status":"healthy","clickhouse":"connected"}

Dashboard

curl http://localhost:8000 | grep title
# <title>Bot Detector Dashboard</title>

API Metrics

curl http://localhost:8000/api/metrics | jq '.summary'

---

⚠️ POINTS IMPORTANTS

Ports utilisés

• 8000 - API + Frontend (mode host)
• 3000 - N'est plus utilisé (ancien mode bridge)

Avantages du mode host

• ✅ MCP peut se connecter
• ✅ Pas de NAT → meilleures perfs
• ✅ Plus simple à déboguer

Inconvénients

• ⚠️ Port 8000 doit être libre sur l'hôte
• ⚠️ Moins d'isolation réseau

---

🔄 ROLLBACK (si nécessaire)

Pour revenir au mode bridge avec mapping de ports :

services:
  dashboard_web:
    ports:
      - "3000:8000"
    # network_mode: null

Puis :

docker compose down
docker compose up -d

---

📊 DIAGNOSTIC

Vérifier que le dashboard écoute

curl http://localhost:8000/health

Vérifier l'IP de l'hôte

hostname -I | awk '{print $1}'

Logs du container

docker compose logs -f dashboard_web

Status du container

docker compose ps

---

Date: 2026-03-14
Configuration: HOST NETWORK
IP Hôte: 192.168.1.2
Port: 8000
Status: ✅ OPÉRATIONNEL