Soluzione della community

Instrada Deluge tramite Gluetun su ZimaOS senza perdere l’interfaccia web

A March 2026 ZimaOS user restored the Deluge Web UI by exporting Compose, removing Deluge's own ports, and sharing Gluetun's network namespace; another user later could not reproduce the result.

Un utente di ZimaOS aveva Gluetun connesso a NordVPN e voleva che Deluge condividesse il suo stack di rete VPN. Gluetun era in esecuzione, ma l'interfaccia Web di Deluge non si apriva. Alla fine, l'utente ha esportato la definizione Compose di Deluge, rimosso le proprie mappature delle porte, aggiunto la condivisione della rete del container e reimportato lo stack.

Questa era una configurazione confermata dalla community, non un modello dell'App Store di IceWhale. Un utente successivo non è riuscito a riprodurla con Deluge e ha usato invece Transmission.

Come funziona il percorso di rete tra Gluetun e Deluge

Browser → porta pubblicata da Gluetun → interfaccia Web di Deluge
Traffico di Deluge → namespace di rete di Gluetun → tunnel VPN → Internet

Quando Deluge usa il namespace di rete di Gluetun, non dispone più di uno stack di rete indipendente. Le porte dell'interfaccia Web e dei peer devono essere pubblicate da Gluetun, non duplicate su Deluge.

Impostazioni dell'applicazione Deluge in ZimaOS prima dell'instradamento della rete tramite Gluetun
L'installazione originale di Deluge utilizzava ancora una propria configurazione di rete e non esponeva un'interfaccia Web funzionante tramite Gluetun.
Impostazioni dell'applicazione Gluetun in ZimaOS con credenziali VPN e porte di Deluge
Gluetun era già connesso; il problema rimanente consisteva nel collegare correttamente Deluge al suo stack di rete.

La procedura funzionante della community

  1. Rimuovere l'app Deluge iniziale dopo aver salvaguardato la configurazione e i download.
  2. Usare l'installazione personalizzata per rimuovere le porte pubblicate direttamente da Deluge.
  3. Esportare la definizione Compose risultante.
  4. Aggiungere network_mode: container:gluetun a Deluge.
  5. Assicurarsi che l'interfaccia Web di Deluge e le porte dei peer necessarie siano pubblicate su Gluetun.
  6. Importare lo stack Compose modificato e aprire Deluge tramite la porta host pubblicata da Gluetun.

Il progetto ufficiale Gluetun documenta network_mode: "container:gluetun" per un container in un altro progetto Compose e network_mode: "service:gluetun" per i servizi nello stesso progetto. Consulta la guida di Gluetun per la connessione dei container prima di scegliere una delle due opzioni.

Verifica sia la raggiungibilità sia l'uscita tramite VPN

L'utente della fonte ha eseguito un controllo dell'IP esterno dall'ambiente di Deluge e ha visualizzato l'indirizzo VPN invece di quello del provider Internet. Verifica inoltre che l'interfaccia Web rimanga raggiungibile dalla LAN, che i download utilizzino i percorsi previsti e che il traffico si interrompa se Gluetun diventa non operativo.

Proteggi le credenziali VPN e le esportazioni Compose

Gli screenshot e i file YAML esportati possono includere nomi utente del provider, password, chiavi private, posizioni dei server e percorsi locali. Oscurali prima di condividerli. Quando supportato, preferisci file di ambiente o secret e sostituisci qualsiasi credenziale esposta pubblicamente.

Comprendi i limiti dell'App Store

L'esportazione e la reimportazione di Compose possono scollegare il nuovo stack dal ciclo di vita originale dell'App Store. Registra i tag delle immagini e la configurazione, quindi testa manualmente gli aggiornamenti. Non eseguire comandi generici di “pulizia della cache Docker” solo perché una reinstallazione ha mantenuto le impostazioni; i dati persistenti di AppData sono progettati per sopravvivere alla sostituzione dei container.

Domande frequenti su Gluetun e Deluge

Perché l'interfaccia Web di Deluge è scomparsa?

Quando Deluge condivide il namespace di rete di Gluetun, la sua porta di accesso deve essere pubblicata da Gluetun.

Deluge deve mantenere le proprie mappature delle porte?

Non in questa configurazione con rete condivisa; pubblica le porte necessarie su Gluetun.

Il risultato era universale?

No. L'autore del post originale lo ha confermato, mentre un partecipante successivo ha usato Transmission dopo non essere riuscito a riprodurre la configurazione di Deluge.