WireGuard Dashboard : Visualisez vos tunnels VPN

WireGuard est devenu le protocole VPN de référence : rapide, sécurisé, simple. Mais sur OpenWrt, le monitoring reste rudimentaire — quelques commandes wg show dans un terminal.

J’ai créé luci-app-wireguard-dashboard pour apporter une interface moderne et intuitive à la surveillance de vos tunnels WireGuard.

Pourquoi WireGuard ?

WireGuard est intégré au noyau Linux depuis 5.6, avec un support natif dans OpenWrt depuis la version 21.02.

Fonctionnalités du dashboard

🌐 Vue Status

• Interfaces actives : Nombre de tunnels configurés
• Peers totaux : Nombre de pairs configurés
• Peers connectés : Handshakes récents (< 3 min)
• Trafic total : RX/TX cumulés

Chaque interface affiche :

• Clé publique (tronquée)
• Port d’écoute
• Adresse IP du tunnel
• MTU et état

👥 Vue Peers

Liste détaillée de tous les pairs avec :

• Statut en temps réel : Active (🟢), Idle (🟡), Inactive (⚪)
• Endpoint : IP:port du pair distant (ou “roaming”)
• Allowed IPs : Réseaux routés via ce pair
• Last handshake : Dernier échange cryptographique
• Trafic : RX/TX par pair
• PSK : Indicateur de clé pré-partagée

📊 Vue Traffic

Statistiques de bande passante :

• Totaux par interface
• Barres de progression RX/TX
• Répartition par pair
• Pourcentages visuels

⚙️ Vue Configuration

Affichage de la configuration au format WireGuard :

• Syntaxe colorée [Interface] et [Peer]
• Clés publiques (jamais les privées !)
• Visualisation du tunnel

Architecture technique

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

┌─────────────────────────────────────────────────────────┐
│                    LuCI Dashboard                        │
│          (status.js, peers.js, traffic.js)              │
└───────────────────────────┬─────────────────────────────┘
                            │ ubus RPC
                            ▼
┌─────────────────────────────────────────────────────────┐
│                    RPCD Backend                          │
│           /usr/libexec/rpcd/wireguard-dashboard         │
└───────────────────────────┬─────────────────────────────┘
                            │ executes
                            ▼
┌─────────────────────────────────────────────────────────┐
│                      wg show                             │
│                  WireGuard CLI Tool                      │
└───────────────────────────┬─────────────────────────────┘
                            │ interacts with
                            ▼
┌─────────────────────────────────────────────────────────┐
│                WireGuard Kernel Module                   │
│                  Encrypted Tunnels                       │
└─────────────────────────────────────────────────────────┘

Le backend utilise wg show pour lire les informations en temps réel :

• wg show interfaces : liste des interfaces
• wg show <iface> peers : liste des pairs
• wg show <iface> transfer : trafic par pair
• wg show <iface> latest-handshakes : dernier handshake

Design : Thème VPN Tunnel

Interface inspirée des outils de monitoring réseau professionnel :

Animations fluides pour les indicateurs de statut et le flux du tunnel.

Installation

Prérequis

1
2
3
4
5
6

# Installer WireGuard
opkg update
opkg install kmod-wireguard wireguard-tools

# Optionnel : support LuCI natif
opkg install luci-proto-wireguard

Installer le dashboard

1
2
3
4
5
6

# Depuis les sources OpenWrt
cd ~/openwrt/feeds/luci/applications/
git clone https://github.com/gkerma/luci-app-wireguard-dashboard.git

./scripts/feeds update -a && ./scripts/feeds install -a
make package/luci-app-wireguard-dashboard/compile V=s

Installation manuelle

1
2
3

scp luci-app-wireguard-dashboard_*.ipk root@router:/tmp/
ssh root@router "opkg install /tmp/luci-app-wireguard-dashboard_*.ipk"
/etc/init.d/rpcd restart

Accès

VPN → WireGuard Dashboard

Indicateurs de statut des peers

Un handshake WireGuard a lieu :

• À l’établissement de la connexion
• Toutes les 2 minutes en cas de trafic
• Lors d’un keepalive si configuré

Sécurité

Le dashboard respecte les bonnes pratiques de sécurité :

✅ Les clés privées ne sont JAMAIS exposées
✅ Lecture seule (pas de modification de config)
✅ Accès via ACL rpcd (utilisateurs authentifiés)
✅ Pas de stockage de données sensibles

Cas d’usage

🏠 Accès distant à la maison

Surveillez les connexions de vos appareils mobiles à votre routeur.

🏢 Site-to-site entreprise

Visualisez l’état des tunnels entre sites distants.

🔒 VPN client

Vérifiez la connexion à votre fournisseur VPN.

Démo interactive

Testez l’interface complète avec des données simulées :

👉 https://cybermind.fr/apps/wireguard-dashboard/

Roadmap

• Vue Status avec interfaces et peers
• Vue Peers avec détails complets
• Vue Traffic avec statistiques
• Vue Configuration avec syntaxe colorée
• Graphiques historiques (24h/7j)
• Alertes sur déconnexion de peers
• Génération de QR codes pour mobile
• Export de configuration
• Gestion des peers (ajout/suppression)

Contribuer

Projet open-source sous licence Apache-2.0 :

GitHub : github.com/gkerma/luci-app-wireguard-dashboard

Conclusion

Avec luci-app-wireguard-dashboard, vos tunnels VPN deviennent enfin visibles. Plus besoin de SSH et de commandes cryptiques — un simple coup d’œil dans LuCI suffit pour vérifier l’état de votre infrastructure VPN.

Vous utilisez WireGuard sur OpenWrt ? Partagez votre configuration dans les commentaires !