Documentation Essensys Raspberry Pi¶

Bienvenue dans la documentation complète pour l'installation et la configuration d'Essensys sur Raspberry Pi 4.

🚀 Démarrage rapide¶

🔍 Voir les versions disponibles

Débuter l'installation pas à pas 1. Préparation du matériel - SSD, adaptateur USB-SATA, Raspberry Pi 4 2. Installation de l'OS - Installation de Raspberry Pi OS sur le SSD 3. Choix du Domaine WAN - Choix du domaine pour l'accès extérieur (Optionnel) 4. Installation Essensys - Installation automatique ou manuelle 5. Configuration réseau - Configuration SSH et réseau 6. Accès aux services - URLs locales et WAN

📚 Sections principales¶

Installation¶

• Introduction
• 1. Préparation du matériel
• 2. Installation de l'OS
• 3. Choix du Domaine WAN
• 4. Installation d'Essensys

Connexion¶

• Connexion SSH
• Configuration réseau

Logs¶

• Logs backend
• Logs Nginx
• Logs Traefik

Accès¶

• Accès local
• Accès WAN

Configuration Routeur¶

• Ubiquiti Dream Machine Pro
• Freebox
• SFR
• Orange Livebox

Architecture¶

• Vue d'ensemble
• Backend
• Frontend
• Nginx
• Traefik
• Ports utilisés

Maintenance¶

• Mise à jour
• Désinstallation
• Dépannage
• Interface de Débogage
• MCP Essensys

🏗️ Architecture¶

graph TB
    Client[Client Essensys<br/>192.168.1.151]
    BrowserLocal[Navigateur Local<br/>mon.essensys.fr]
    BrowserWAN[Navigateur WAN<br/>essensys.acme.com]

    AdGuard[AdGuard Home<br/>Port 53: DNS]
    Nginx[Nginx<br/>Port 80: API locales<br/>Port 9090: Frontend interne]
    Traefik[Traefik<br/>Port 443: Frontend WAN HTTPS]
    Backend[Backend Go<br/>Port 7070]
    Frontend[Frontend React<br/>Fichiers statiques]

    Client -->|DNS| AdGuard
    BrowserLocal -->|DNS| AdGuard
    AdGuard -->|mon.essensys.fr = 192.168.x.x| Client

    Client -->|mon.essensys.fr/api/*| Nginx
    BrowserLocal -->|mon.essensys.fr/| Nginx
    BrowserWAN -->|essensys.acme.com/| Traefik

    Nginx -->|/api/*| Backend
    Nginx -->|/| Frontend
    Traefik -->|Frontend| Nginx

    style AdGuard fill:#dcedc8
    style Client fill:#e1f5ff
    style BrowserLocal fill:#fff4e1
    style BrowserWAN fill:#fff4e1
    style Nginx fill:#e8f5e9
    style Traefik fill:#e3f2fd
    style Backend fill:#f3e5f5
    style Frontend fill:#fff4e1

📦 Composants¶

• Backend Go : API REST et communication avec les clients Essensys legacy
• Frontend React : Interface web moderne
• Nginx : Configurations Nginx - Reverse proxy pour les API locales et le frontend local
• Traefik : Reverse proxy avancé pour l'accès WAN avec HTTPS et authentification
• AdGuard Home : Serveur DNS local et bloqueur de publicités

🔒 Sécurité¶

• Local : Accès HTTP sans authentification
• WAN : Accès HTTPS avec authentification basique
• API WAN : Seul /api/admin/inject est accessible en WAN (HTTPS + auth)
• Autres API WAN : Bloquées (403 Forbidden)

📝 Notes importantes¶

• Le client Essensys legacy (BP_MQX_ETH) nécessite des réponses HTTP en un seul paquet TCP
• Nginx est configuré spécifiquement pour cette compatibilité
• Traefik gère uniquement le frontend WAN, les API locales restent sur Nginx