Gluetun (VPN)
Afficher un tunnel VPN Gluetun, par où sort le trafic, son port redirigé et les conteneurs qui passent par lui.
Le widget VPN indique si le tunnel tient, la ville et le pays par où sort le trafic, l’adresse publique, le réseau de sortie et le port que le fournisseur VPN redirige. Il liste les conteneurs qui passent par Gluetun et prévient quand certains ont perdu leur réseau. Un administrateur peut redémarrer le tunnel après confirmation.
Ouvrir le serveur de contrôle de Gluetun
Gluetun répond sur son serveur de contrôle, port 8000 dans le conteneur. Publiez-le et donnez à NasDash une clé d’API dont le rôle ne lit que ce dont le widget a besoin :
[[roles]]
name = "nasdash"
routes = ["GET /v1/vpn/status", "GET /v1/publicip/ip", "GET /v1/portforward"]
auth = "apikey"
apikey = "REPLACE_WITH_A_LONG_RANDOM_KEY"services:
gluetun:
image: qmcgaw/gluetun
ports:
- 8000:8000
volumes:
- ./gluetun-auth.toml:/gluetun/auth/config.toml:roLe rôle en lecture seule exclut GET /v1/vpn/settings, qui renvoie des clés privées et mots de passe et que NasDash ne demande jamais. Pour autoriser les administrateurs à redémarrer le tunnel, ajoutez facultativement PUT /v1/vpn/status au rôle. Sans cette permission, les relevés fonctionnent.
Le connecter
- Ouvrez Réglages → Intégrations → Tunnel VPN → Gluetun.
- Saisissez l’adresse du serveur de contrôle, par exemple
http://nas.example.com:8000. - Choisissez Clé d’API et collez la clé (ou Utilisateur et mot de passe, ou Aucune si votre serveur de contrôle n’a pas d’authentification).
- Enregistrez et testez la connexion.
NasDash 0.3.6 permet d’enregistrer plusieurs connexions Gluetun. Donnez à chacune un nom distinct dans Paramètres → Intégrations, puis choisissez la connexion dans les réglages de chaque widget VPN. Ajouter une connexion crée une entrée séparée ; modifier une entrée existante met à jour cette connexion.
Services derrière le tunnel
Quand NasDash a un hôte Docker (Réglages → Intégrations → Docker), le widget liste les conteneurs qui partagent le réseau de Gluetun (network_mode: service:gluetun), barrés s’ils sont arrêtés. Seuls les visiteurs autorisés à lire les conteneurs voient la liste.
Recréer le conteneur Gluetun laisse ces conteneurs sans réseau tant qu’ils ne sont pas recréés eux aussi. Le widget les nomme dans un avertissement. Recréez-les avec Gluetun :
docker compose up -d --force-recreate gluetun qbittorrentRedémarrer
Le bouton de redémarrage arrête puis relance la connexion VPN, qui peut alors utiliser un autre serveur. Gluetun oublie l’adresse de sortie à l’arrêt du tunnel et la redemande une fois quand il est de nouveau monté ; si cette demande échoue, le widget montre le tunnel connecté avec l’adresse encore inconnue. Gluetun se reconnecte déjà seul quand son contrôle de santé échoue : le bouton sert surtout au dépannage.
Affichage et accès
L’adresse publique, le port redirigé et la liste des services peuvent chacun être masqués dans les réglages du widget. Les visiteurs ont besoin de la permission VPN (Réglages → Utilisateurs et accès). L’adresse et la clé ne quittent jamais le serveur NasDash. La démo publique montre un tunnel fictif.