SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor · Aggiornato 2026-11-13

Docker e VPN: perché le porte dei container spariscono

Con Gluetun e network_mode: service, le porte pubblicate e i nomi Docker del container collegato spariscono. Ecco l'errore e il compose corretto.

Perché le porte scompaiono quando si instradano i container Docker tramite una VPN

Per instradare i container Docker tramite una VPN, si assegna il tunnel a un container e poi si collegano gli altri al suo namespace di rete con network_mode: "service:gluetun". È questo collegamento a creare spesso confusione. Il container collegato non dispone più di una propria rete, quindi perde le porte pubblicate e il proprio nome di servizio Docker. Pubblicare le porte sul container VPN consente agli altri container di raggiungere l'applicazione usando il nome del container VPN.

Se si lascia un blocco ports: sul container collegato, Docker ne rifiuta completamente la creazione:

Error response from daemon: conflicting options: port publishing and the container type network mode

Lo strumento utilizzato è Gluetun, un container che si connette a un provider VPN commerciale tramite WireGuard o OpenVPN e include un proprio firewall. La release v3.41.3 è quella corrente a ottobre 2026. Gli esempi usano Mullvad con WireGuard, quindi sono necessari un account e una chiave del provider. Se si preferisce terminare il tunnel su hardware di proprietà, eseguire il proprio server WireGuard su un VPS crea l'altra estremità, mentre wg-easy in Docker aggiunge un'interfaccia web alla configurazione.

Cosa fa realmente network_mode: "service:gluetun"

Ogni container Docker normalmente ottiene un proprio network namespace: interfacce, tabella di routing, regole del firewall e socket in ascolto propri. La modalità service: salta questo passaggio e avvia il container all'interno del namespace di gluetun. Un solo namespace corrisponde a un solo indirizzo IP e questo comporta sei conseguenze.

  • L'applicazione non ha un proprio indirizzo. Usa l'indirizzo di gluetun.
  • L'applicazione non è collegata ad alcuna rete Docker, quindi il suo nome di servizio non viene mai registrato e non può essere risolto. Gli altri container devono usare gluetun.
  • I container all'interno del namespace comunicano tra loro tramite localhost.
  • Due container nello stesso namespace non possono mettersi in ascolto sulla stessa porta. La documentazione di Gluetun è esplicita: non esiste una soluzione alternativa.
  • Le capability appartengono a un container, non a un namespace. Gluetun dispone di NET_ADMIN e /dev/net/tun perché crea l'interfaccia del tunnel. Il container collegato non le eredita.
  • Compose rifiuta qualsiasi file in cui un servizio imposta sia network_mode sia networks. Collega gluetun alle tue reti e l'applicazione utilizzerà la stessa configurazione di rete.

Il riavvio di gluetun disconnette tutto ciò che vi è collegato. Questo comportamento è documentato e spiega perché gluetun riavvia il processo VPN all'interno del container invece di terminare quando la connessione non riesce. Dopo aver riavviato o ricreato manualmente gluetun, riavvia i container collegati.

Il file compose funzionante

services:
  gluetun:
    image: qmcgaw/gluetun:v3
    container_name: gluetun
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun:/dev/net/tun
    environment:
      - VPN_SERVICE_PROVIDER=mullvad
      - VPN_TYPE=wireguard
      - SERVER_CITIES=Amsterdam
      - TZ=Europe/Amsterdam
    env_file:
      - ./gluetun.env
    volumes:
      - ./gluetun:/gluetun
    ports:
      - 127.0.0.1:8080:8080/tcp
    restart: unless-stopped

  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    network_mode: "service:gluetun"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Amsterdam
      - WEBUI_PORT=8080
    volumes:
      - ./qbittorrent:/config
      - ./downloads:/downloads
    depends_on:
      gluetun:
        condition: service_healthy
    restart: unless-stopped

Il tag :v3 è l'ultima release stabile della serie v3. Il tag :latest punta all'ultimo commit del branch master, cioè al ramo di sviluppo; quindi fissa :v3 su una macchina sulla quale non vuoi fare attività di debug di martedì.

WEBUI_PORT=8080 deve corrispondere alla porta pubblicata, perché qBittorrent si mette in ascolto nello spazio dei nomi di gluetun e la regola di pubblicazione inoltra il traffico dell'host alla porta 8080 in quello spazio dei nomi. Se modifichi un numero senza modificare anche l'altro, la porta non risponde. 127.0.0.1:8080:8080 mantiene l'interfaccia web sull'indirizzo di loopback dell'host. Un semplice 8080:8080 pubblica la porta su tutte le interfacce e crea una propria regola firewall: è così che le porte pubblicate da Docker aggirano direttamente ufw.

Avvia lo stack, quindi controllalo in questo ordine:

docker compose up -d
docker compose ps
docker compose logs gluetun | tail -30

docker compose ps dovrebbe mostrare gluetun come healthy e qbittorrent come running. Verifica quindi l'indirizzo di uscita dall'interno dello spazio dei nomi. Questo controllo determina l'esito di tutte le verifiche successive:

docker run --rm --network=container:gluetun alpine:3.22 sh -c "apk add wget && wget -qO- https://ipinfo.io"

Il campo ip di quel JSON dovrebbe contenere l'indirizzo del provider VPN. Se contiene l'indirizzo del server, l'applicazione non sta usando il tunnel e tutto ciò che segue non funzionerà come descritto.

Tieni le chiavi fuori dal file compose

gluetun.env contiene le credenziali e non viene incluso in git:

WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
WIREGUARD_ADDRESSES=10.64.222.21/32

Entrambi i valori provengono da un file di configurazione WireGuard generato nell'area account del provider. Imposta il file con la modalità 600. È importante essere chiari sul vantaggio effettivo: la chiave resta fuori dal repository, ma docker inspect gluetun stampa comunque tutte le variabili d'ambiente a chiunque possa raggiungere il socket Docker. File d'ambiente e secret in Docker Compose illustra opzioni più sicure.

Come comunica un container esterno al tunnel con uno interno

Il traffico funziona in entrambe le direzioni e per ciascuna si usa un nome diverso. I due container devono condividere una rete Docker, che in questo caso è la rete di gluetun, perché il container collegato non dispone di una rete propria. Come sono collegate le reti Docker Compose descrive i valori predefiniti.

Per comunicare dall'esterno verso l'interno, usa il nome di gluetun e la porta sulla quale è in ascolto l'applicazione. Un container reverse proxy raggiunge l'interfaccia web di qBittorrent tramite gluetun:8080. Non è necessaria alcuna voce ports:, perché il traffico tra container rimane sulla rete Docker e non passa mai da una porta dell'host.

Per comunicare dall'interno verso l'esterno, usa il nome del servizio dell'altro container, ad esempio postgres:5432. Dalla versione v3.41, Gluetun risolve i nomi degli altri container dal proprio namespace. Se un nome non viene risolto, usa quindi quella versione o una successiva.

Il firewall di Gluetun decide chi può aprire una connessione verso di esso. Il traffico proveniente dalla rete Docker di gluetun è consentito. Un client su una subnet diversa, un laptop nella LAN o un container su una rete bridge separata, richiede un percorso di ritorno consentito dal firewall e dal routing di gluetun:

FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24

Il significato documentato è preciso: subnet separate da virgole alle quali Gluetun e i container che condividono il suo network stack possono accedere.

Le connessioni in ingresso da Internet sono un problema distinto. I peer di un client torrent arrivano dal lato VPN, quindi pubblicare la porta 6881 sull'host non produce alcun effetto. È necessaria una porta inoltrata dal provider, che deve essere indicata in FIREWALL_VPN_INPUT_PORTS; questa impostazione consente le porte dal lato del server VPN. In questo esempio viene usato Mullvad, che non supporta il port forwarding. È quindi necessario un provider che offra questa funzione. Questo è l'aspetto che la maggior parte degli stack multimediali realizzati con Docker Compose lascia non funzionante.

Il kill switch: cosa succede quando il tunnel cade

Questo schema giustifica la sua complessità soprattutto nella gestione dei guasti. Il container collegato condivide le interfacce e la tabella di routing di Gluetun. Il firewall di Gluetun blocca il normale traffico Internet al di fuori del tunnel, consentendo invece di raggiungere l’endpoint del server VPN, il traffico Docker locale e le eccezioni configurate. È questo firewall a impedire il fallback all’interfaccia normale quando il tunnel cade. Non esiste una finestra in cui i pacchetti possano uscire dall’interfaccia normale mentre il client tenta di riconnettersi.

Gluetun monitora la propria connessione. Ogni minuto invia un echo ICMP (un ping) agli indirizzi indicati in HEALTH_ICMP_TARGET_IPS, che per impostazione predefinita è 1.1.1.1,8.8.8.8. Se ICMP non è consentito, questo controllo viene eseguito tramite una query DNS UDP in chiaro. Ogni cinque minuti apre una connessione TCP e TLS (transport layer security) completa verso HEALTH_TARGET_ADDRESSES, il cui valore predefinito è cloudflare.com:443,github.com:443. Quando questi controlli falliscono, riavvia la VPN all’interno del container e lo registra nei log:

WARN [vpn] restarting VPN because it failed to pass the healthcheck: periodic check: dialing: dial tcp4: lookup cloudflare.com: i/o timeout

Leggi i log del container collegato tenendo presente questa sequenza. Righe come connection refused, operation not permitted e i/o timeout all’interno dell’applicazione sono conseguenze di un tunnel non operativo, non le cause. La documentazione di Gluetun lo specifica chiaramente, perché spesso si segnala la conseguenza e la si analizza per ore.

HEALTH_RESTART_VPN=on è l’impostazione predefinita e deve rimanere attiva. Disattivala solo durante il debug di un problema specifico, perché quando è disattivata un tunnel non operativo rimane tale.

Ordinamento: impedire l'avvio dello stack prima che il tunnel sia attivo

L'immagine include un healthcheck Docker:

HEALTHCHECK --interval=5s --timeout=5s --start-period=10s --retries=3 CMD /gluetun-entrypoint healthcheck

Questo comando avvia una seconda istanza temporanea di gluetun, che interroga il server di healthcheck dell'istanza in esecuzione su http://127.0.0.1:9999/. Un tunnel funzionante risponde con 200 OK. Un tunnel non funzionante risponde con 500 Internal server error e una stringa di errore; dopo tre controlli consecutivi non riusciti, Docker contrassegna il container come non integro.

condition: service_healthy è l'impostazione che attende questo risultato. Il semplice depends_on: [gluetun] attende soltanto l'avvio del container, che avviene diversi secondi prima del completamento dell'handshake. Di conseguenza, l'applicazione si avvia senza una rete funzionante e spesso abbandona il primo tentativo di connessione. Healthcheck in Docker Compose illustra la sintassi e i campi relativi alle tempistiche.

C'è un limite importante. Compose valuta questa condizione quando avvia lo stack. In seguito non arresta né riavvia l'applicazione se gluetun diventa non integro. In questo caso interviene invece il meccanismo interno di auto-ripristino di gluetun, che riavvia il processo VPN anziché il container.

Verifica la presenza di perdite DNS prima di considerare corretta la configurazione

Il DNS (domain name system) è la perdita che può verificarsi anche quando il tunnel funziona correttamente. Gluetun esegue il proprio resolver all'interno del namespace e, per impostazione predefinita, inoltra le query tramite DoT (DNS over TLS) a Cloudflare: DNS_UPSTREAM_RESOLVER_TYPE=dot e DNS_UPSTREAM_RESOLVERS=cloudflare. Lascia invariati entrambi i valori: le query vengono cifrate e passano attraverso il tunnel.

L'impostazione che interrompe questo comportamento quando viene configurata con un resolver locale è DNS_UPSTREAM_PLAIN_ADDRESSES. Si tende a usarla quando un nome non viene risolto e si vuole che risponda il router o il resolver del provider. La documentazione di Gluetun avverte che le query inviate a un resolver sulla rete bridge di Docker o sulla LAN escono dal tunnel VPN. Un resolver pubblico in chiaro riceve comunque le query attraverso il tunnel, ma il provider VPN può leggerle e modificarle. La stessa configurazione errata in WireGuard è descritta in DNS che smette di risolvere attraverso un tunnel WireGuard.

Per eseguire il test, imposta SHADOWSOCKS=on e SHADOWSOCKS_PASSWORD su gluetun, pubblica 8388:8388/tcp e 8388:8388/udp, quindi connettiti con un client Shadowsocks configurato per inoltrare il DNS UDP attraverso il tunnel e apri un test per le perdite DNS. Il risultato dovrebbe indicare il tuo provider o Cloudflare, mai il router di casa. La documentazione di Gluetun avverte che alcuni test per le perdite possono restituire risultati insoliti, perché il resolver all'interno del namespace è un intermediario locale con caching, non il server che fornisce la risposta finale. Considera come segnali effettivi un paese errato o il resolver del tuo ISP.

Aggiungere Tailscale accanto al sidecar VPN e stabilire quale instradamento prevale

Tailscale è una rete overlay basata su WireGuard che consente di raggiungere i propri computer. Viene spesso eseguito accanto a una VPN di un provider per mantenere un percorso di amministrazione verso lo stack. Condividere lo stesso namespace significa condividere anche le regole del firewall. Le impostazioni del firewall e dell'instradamento devono quindi essere compatibili. La documentazione di Tailscale definisce il comportamento predefinito: Tailscale agisce come rete overlay, instrada il traffico soltanto tra i dispositivi che eseguono Tailscale e non modifica il traffico Internet pubblico.

La risposta dipende quindi da una sola impostazione.

  • Tailscale nel proprio container, con la configurazione predefinita: non vede mai il traffico in uscita dell'applicazione. Gluetun lo trasporta interamente. Un processo nel container Tailscale raggiunge l'applicazione all'indirizzo gluetun:8080 tramite una rete Docker condivisa. Per rendere raggiungibile questa connessione dai client della tailnet servono il forwarding o un proxy.
  • Tailscale collegato al namespace di gluetun con network_mode: "service:gluetun": nella modalità predefinita di rete userspace, TS_USERSPACE è attivo, tailscaled non crea alcuna interfaccia e funziona come proxy SOCKS5 o HTTP. Non può quindi modificare l'instradamento. Gluetun continua a trasportare il normale traffico in uscita, a meno che un'applicazione non utilizzi esplicitamente quel proxy.
  • Stessa configurazione, con TS_USERSPACE=false: Tailscale ha bisogno del proprio dispositivo /dev/net/tun e delle relative capability, perché questi elementi non vengono ereditati dal namespace. Tailscaled crea un dispositivo tunnel e, su Linux, installa normalmente singole route peer IPv4 /32 invece di una route unica per 100.64.0.0/10. Impostare solo TS_USERSPACE=false non abilita la route aggregata. Tailscale installa le route verso le subnet degli altri nodi soltanto se si passa --accept-routes tramite TS_EXTRA_ARGS. TS_ROUTES funziona nella direzione opposta: pubblicizza al resto della tailnet le subnet raggiungibili da questo container, equivalente a tailscale set --advertise-routes=, e non aggiunge route in questo namespace. Il traffico pubblico continua a uscire tramite gluetun.
  • Networking del kernel nel namespace di gluetun con un exit node selezionato, sudo tailscale set --exit-node=<exit-node-ip>: Tailscale installa route predefinite in quel namespace, ma il firewall di Gluetun può bloccare il percorso. Selezionare un exit node in un container separato non modifica le route dell'applicazione. La modalità userspace trasporta soltanto il traffico inviato esplicitamente tramite il relativo proxy. Non combinare route predefinite concorrenti nel namespace di gluetun. Una sola route predefinita, un solo componente responsabile.

Se il punto sono le route pubblicizzate e vuoi rendere raggiungibile l'intera rete privata dietro il server, non soltanto il server stesso, eseguire un router subnet Tailscale su un VPS illustra l'approvazione della route, l'IP forwarding e il flag lato client che TS_ROUTES, da solo, non configura.

Se Tailscale serve per fornirti un URL di amministrazione e non una route, tailscale serve e tailscale funnel mettono HTTPS davanti a un servizio HTTP locale. Solo funnel lo espone a Internet. La documentazione di Tailscale Serve supporta http://127.0.0.1 soltanto come destinazione del proxy HTTP. Una rete Docker condivisa non rende http://gluetun:8080 una destinazione supportata. Condividi il namespace di rete di gluetun con network_mode: "service:gluetun" e usa http://127.0.0.1:8080 come destinazione.

Un effetto collaterale è visibile quando Tailscale viene eseguito all'interno del tunnel. I peer vedono l'indirizzo del provider VPN. È quindi più probabile che Tailscale ricorra ai relay. tailscale status mostra relay "..." accanto a un peer invece di direct quando questo accade. La connessione funziona, ma è più lenta. Se ti serve soltanto la rete overlay, la differenza tra WireGuard semplice e Tailscale è il punto di partenza più adatto.

Cosa può non funzionare e quale messaggio verrà visualizzato

Docker rifiuta di creare il container dell'applicazione. Error response from daemon: conflicting options: port publishing and the container type network mode indica che un blocco ports: è ancora associato al servizio collegato. Spostatelo su gluetun.

Compose rifiuta l'intero file. Un servizio non può impostare contemporaneamente network_mode e networks. Inserite le reti in gluetun.

Un altro container non riesce a risolvere il nome dell'applicazione. curl: (6) Could not resolve host: qbittorrent è il comportamento previsto, perché il container collegato non ha effettuato il join di alcuna rete e non ha registrato alcun nome. Usate gluetun e la porta.

Il secondo container collegato non si avvia. Due processi nello stesso namespace non possono associare la stessa porta. Il processo che perde segnala che l'indirizzo è già in uso. Modificate la porta interna dell'applicazione oppure avviate un secondo gluetun.

L'applicazione non ha più accesso alla rete dopo una modifica a gluetun. Il riavvio o la ricreazione di gluetun interrompe la connettività di tutti i container collegati. Riavviate questi container.

Le pagine piccole vengono caricate, ma quelle grandi si bloccano. Il problema riguarda l'MTU (maximum transmission unit). Il tunnel aggiunge overhead e un elemento del percorso scarta i pacchetti troppo grandi senza restituire un errore. Controllate WIREGUARD_MTU, il cui valore predefinito in v3.41.3 è 1320, e riducetelo se il percorso richiede pacchetti più piccoli. Quando questa impostazione non è definita, l'immagine di sviluppo usa il rilevamento dell'MTU del percorso.

Gluetun non raggiunge mai lo stato healthy. Il controllo di avvio indica i primi elementi da verificare: WARN [vpn] restarting VPN because it failed to pass the healthcheck: startup check: dialing: dial tcp4: lookup cloudflare.com: i/o timeout. Controllate se la key è scaduta, quindi verificate se l'elenco dei server non è aggiornato e, infine, se il firewall dell'host blocca il traffico UDP in uscita.

FAQ

Perché le porte pubblicate del mio container hanno smesso di funzionare dietro Gluetun?

Perché network_mode: "service:gluetun" inserisce il container nel namespace di rete di Gluetun, e un namespace dispone di un solo indirizzo IP e di un solo insieme di porte in ascolto. L'applicazione continua a essere in ascolto, ma la regola di pubblicazione deve trovarsi nel container che possiede il namespace. Sposta l'elenco ports: nel servizio Gluetun. Se lo hai lasciato nel servizio collegato, Docker non lo creerà nemmeno: Error response from daemon: conflicting options: port publishing and the container type network mode.

Come posso raggiungere, da un container esterno alla VPN, un container che si trova nel tunnel VPN?

Usa il nome del servizio Gluetun e la porta su cui l'applicazione è in ascolto, ad esempio gluetun:8080. Il container collegato non appartiene a nessuna rete Docker propria, quindi il suo nome non viene mai risolto. Per il traffico tra container non è necessario pubblicare alcuna porta. Nella direzione opposta, un container all'interno del namespace raggiunge un container esterno tramite il nome del relativo servizio, ad esempio postgres:5432, con Gluetun v3.41 e versioni successive. Un client appartenente a una subnet diversa, ad esempio un laptop sulla LAN, ha bisogno di un percorso di ritorno consentito dal firewall e dal routing di Gluetun; aggiungi quella subnet a FIREWALL_OUTBOUND_SUBNETS.

Gluetun funziona come kill switch quando la VPN si disconnette?

Sì, se il firewall è abilitato. Il container collegato condivide le interfacce e le route di Gluetun, e il firewall blocca il normale traffico Internet al di fuori del tunnel, consentendo l'endpoint del server VPN, il traffico Docker locale e le eccezioni configurate. Gluetun riavvia quindi internamente la VPN e registra WARN [vpn] restarting VPN because it failed to pass the healthcheck, invece di terminare il processo, perché ogni container collegato perderebbe la rete se Gluetun stesso venisse riavviato.

Tailscale e Gluetun nello stesso stack: quale dei due gestisce il traffico in uscita?

Gluetun gestisce il normale traffico in uscita, a meno che tu non lo invii esplicitamente tramite Tailscale. Per impostazione predefinita, Tailscale instrada soltanto il traffico tra i dispositivi della tailnet e lascia invariato il traffico pubblico. Nella modalità userspace predefinita dell'immagine del container non crea alcuna interfaccia, quindi non può modificare il routing. Con TS_USERSPACE=false, Linux riceve normalmente route /32 IPv4 individuali per i peer, invece di una route aggregata 100.64.0.0/10, oltre alle route verso le subnet degli altri nodi solo se aggiungi --accept-routes tramite TS_EXTRA_ARGS. TS_ROUTES annuncia le subnet di questo container alla tailnet e non aggiunge route locali. La selezione di un exit node con sudo tailscale set --exit-node=<exit-node-ip> installa le route predefinite soltanto nel namespace che usa il networking kernel di Tailscale; un container separato non modifica le route dell'applicazione, mentre la modalità userspace trasporta soltanto il traffico inviato tramite il relativo proxy. Scegli un solo prodotto per gestire la route predefinita, invece di sovrapporli entrambi.

Questo articolo ti è stato utile?