Integrazioni

Gluetun (VPN)

Mostrare un tunnel VPN Gluetun, da dove esce il traffico, la sua porta inoltrata e i contenitori che ci passano.

Il widget VPN mostra se il tunnel è attivo, la città e il paese da cui esce il traffico, l’indirizzo pubblico, la rete di uscita e la porta inoltrata dal provider VPN. Elenca i contenitori che passano da Gluetun e avvisa quando alcuni hanno perso la rete. Un amministratore può riavviare il tunnel dopo una conferma.

Aprire il server di controllo di Gluetun

Gluetun risponde sul suo server di controllo, porta 8000 nel contenitore. Pubblicala e dai a NasDash una chiave API il cui ruolo legga solo ciò che serve al widget:

gluetun-auth.toml
[[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:ro

Il ruolo di sola lettura esclude GET /v1/vpn/settings, che restituisce chiavi private e password e che NasDash non richiede mai. Per consentire agli amministratori di riavviare il tunnel, aggiungi facoltativamente PUT /v1/vpn/status al ruolo. Senza questo permesso, le letture funzionano comunque.

Collegarlo

  1. Apri Impostazioni → Integrazioni → Tunnel VPN → Gluetun.
  2. Inserisci l’indirizzo del server di controllo, per esempio http://nas.example.com:8000.
  3. Scegli Chiave API e incolla la chiave (oppure Utente e password, o Nessuna se il server di controllo non ha autenticazione).
  4. Salva e prova la connessione.

NasDash 0.3.6 supporta più connessioni Gluetun salvate. Assegnate a ciascuna un nome distinto in Impostazioni → Integrazioni e scegliete la connessione nelle impostazioni di ogni widget VPN. Aggiungere una connessione crea una voce separata; modificare una voce esistente aggiorna quella connessione.

Servizi dietro il tunnel

Quando NasDash ha un host Docker (Impostazioni → Integrazioni → Docker), il widget elenca i contenitori che condividono la rete di Gluetun (network_mode: service:gluetun), barrati se fermati. Solo i visitatori che possono leggere i contenitori vedono l’elenco.

Ricreare il contenitore Gluetun lascia quei contenitori senza rete finché non vengono ricreati anche loro. Il widget li nomina in un avviso. Ricreali insieme a Gluetun:

docker compose up -d --force-recreate gluetun qbittorrent

Riavviare

Il pulsante di riavvio ferma e riavvia la connessione VPN, che può allora usare un altro server. Gluetun dimentica l’indirizzo di uscita quando il tunnel si ferma e lo richiede una volta quando è di nuovo attivo; se la richiesta fallisce, il widget mostra il tunnel connesso con l’indirizzo ancora sconosciuto. Gluetun si riconnette già da solo quando il controllo di salute fallisce: il pulsante serve soprattutto per la diagnosi.

Visualizzazione e accesso

L’indirizzo pubblico, la porta inoltrata e l’elenco dei servizi si possono nascondere singolarmente nelle impostazioni del widget. I visitatori hanno bisogno del permesso VPN (Impostazioni → Utenti e accesso). Indirizzo e chiave non lasciano mai il server NasDash. La demo pubblica mostra un tunnel fittizio.