SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Diperbarui 2026-11-12

Cara Menghubungkan Docker Container ke VPN via Gluetun

Pelajari alasan port menghilang saat menggunakan network_mode service di Docker. Dapatkan konfigurasi Docker Compose yang tepat untuk menjalankan aplikasi di balik Gluetun.

Mengapa port menghilang saat Anda merutekan container Docker melalui VPN

Untuk merutekan container Docker melalui VPN, berikan tunnel kepada satu container, lalu hubungkan container lain ke network namespace-nya dengan network_mode: "service:gluetun". Bagian penghubungan ini sering membingungkan. Container yang terhubung tidak lagi memiliki network sendiri, sehingga port yang dipublikasikan dan nama service Docker-nya juga ikut hilang. Publikasikan port pada container VPN, lalu container lain dapat mengakses aplikasi melalui nama container VPN tersebut.

Jika Anda membiarkan blok ports: pada container yang terhubung, Docker menolak membuatnya:

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

Tool yang digunakan di sini adalah Gluetun, yaitu container yang terhubung ke provider VPN (virtual private network) komersial melalui WireGuard atau OpenVPN dan memiliki firewall sendiri. Release v3.41.3 adalah versi terbaru per Oktober 2026. Contoh ini menggunakan Mullvad dengan WireGuard, jadi Anda memerlukan akun dan key dari provider Anda. Jika Anda lebih memilih mengakhiri tunnel pada hardware milik sendiri, menjalankan server WireGuard sendiri pada VPS akan membangun sisi lainnya, sedangkan wg-easy dalam Docker menyediakan antarmuka web untuk konfigurasi tersebut.

Apa yang sebenarnya dilakukan network_mode: "service:gluetun"

Setiap container Docker biasanya mendapatkan network namespace sendiri: interface, tabel routing, aturan firewall, dan listening socket miliknya sendiri. Mode service: melewatkan langkah tersebut dan menjalankan container di dalam namespace milik gluetun. Satu namespace berarti satu alamat IP, dan hal ini mengubah enam aspek berikut.

  • Aplikasi tidak memiliki alamat sendiri. Alamatnya adalah alamat milik gluetun.
  • Aplikasi tidak terhubung ke jaringan Docker mana pun, sehingga nama servicenya tidak pernah terdaftar dan tidak pernah ter-resolve. Container lain harus menggunakan gluetun.
  • Container di dalam namespace yang sama saling terhubung melalui localhost.
  • Dua container dalam satu namespace tidak dapat melakukan listening pada port yang sama. Dokumentasi Gluetun menyatakan hal ini dengan tegas: tidak ada solusi untuk masalah ini.
  • Capabilities dimiliki oleh container, bukan oleh namespace. Gluetun memegang NET_ADMIN dan /dev/net/tun karena ia membuat interface tunnel. Container yang terpasang tidak mewarisi kemampuan tersebut.
  • Compose akan menolak file apa pun di mana satu service mengatur network_mode dan networks secara bersamaan. Pasang gluetun ke jaringan Anda, dan aplikasi akan ikut serta di dalamnya.

Melakukan restart pada gluetun akan memutuskan koneksi semua yang terpasang padanya. Hal ini merupakan perilaku yang terdokumentasi, dan itulah alasan mengapa gluetun melakukan restart pada proses VPN di dalam container alih-alih keluar saat koneksi gagal. Setelah Anda melakukan restart atau membuat ulang gluetun secara manual, lakukan restart pada container yang terpasang padanya.

File compose yang berfungsi

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

Tag :v3 adalah rilis stabil terbaru dalam seri v3. Tag :latest mengarah ke commit terakhir dari branch master, yang merupakan versi pengembangan terkini, jadi jangan gunakan :v3 pada mesin yang tidak ingin Anda debug pada hari Selasa.

WEBUI_PORT=8080 harus sesuai dengan port yang dipublikasikan, karena qBittorrent melakukan binding di dalam namespace gluetun dan aturan publikasi mengirim trafik host ke port 8080 di sana. Mengubah satu angka tanpa mengubah angka lainnya akan menyebabkan port tidak merespons. 127.0.0.1:8080:8080 menjaga antarmuka web tetap berada pada alamat loopback host. Penggunaan 8080:8080 secara langsung akan memublikasikan pada setiap antarmuka dan menulis aturan firewall-nya sendiri, yang merupakan penyebab port Docker yang dipublikasikan langsung melewati ufw.

Jalankan service, lalu periksa dengan urutan berikut:

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

docker compose ps seharusnya menampilkan gluetun sebagai healthy dan qbittorrent sebagai running. Kemudian konfirmasikan alamat keluar dari dalam namespace, yang merupakan pemeriksaan penentu untuk segalanya:

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

Field ip dalam JSON tersebut seharusnya adalah alamat penyedia VPN Anda. Jika yang muncul adalah alamat server Anda sendiri, aplikasi tersebut tidak berada di dalam tunnel, dan tidak ada hal di bawah ini yang akan berperilaku sesuai deskripsi.

Simpan kunci di luar file compose

gluetun.env menyimpan kredensial, dan file ini tidak disertakan dalam git:

WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
WIREGUARD_ADDRESSES=10.64.222.21/32

Kedua nilai tersebut berasal dari file konfigurasi WireGuard yang Anda buat di area akun penyedia layanan Anda. Atur file tersebut ke mode 600. Pahami konsekuensinya: kunci memang tidak masuk ke dalam repositori Anda, namun docker inspect gluetun tetap akan menampilkan setiap variabel lingkungan kepada siapa pun yang dapat mengakses Docker socket. File lingkungan dan rahasia di Docker Compose membahas opsi yang lebih aman.

Cara container di luar tunnel berkomunikasi dengan container di dalamnya

Kedua arah komunikasi berfungsi, dan masing-masing menggunakan nama yang berbeda. Kedua container memerlukan jaringan Docker bersama, yaitu jaringan gluetun, karena container yang terhubung tidak memiliki jaringan sendiri. Cara jaringan Docker Compose terhubung menjelaskan konfigurasi defaultnya.

Untuk komunikasi dari luar ke dalam, gunakan nama gluetun dan port yang digunakan aplikasi untuk menerima koneksi. Container reverse proxy dapat mengakses antarmuka web qBittorrent di gluetun:8080. Entri ports: tidak diperlukan karena trafik antar-container tetap berada di jaringan Docker dan tidak melewati port host.

Untuk komunikasi dari dalam ke luar, gunakan nama service container lain, misalnya postgres:5432. Sejak v3.41, Gluetun dapat me-resolve nama container lain dari dalam namespace-nya. Gunakan versi tersebut atau yang lebih baru jika nama tidak dapat di-resolve.

Firewall Gluetun menentukan siapa yang boleh membuka koneksi ke Gluetun. Trafik dari jaringan Docker milik Gluetun sendiri diizinkan. Klien dari subnet lain, laptop di LAN, atau container pada jaringan bridge terpisah memerlukan jalur balik yang diizinkan oleh firewall dan routing Gluetun:

FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24

Maknanya sesuai dokumentasi: subnet yang dipisahkan dengan koma dan diizinkan untuk diakses oleh Gluetun serta container yang berbagi network stack-nya.

Koneksi masuk dari Internet merupakan masalah yang berbeda. Peer torrent client masuk melalui sisi VPN, sehingga memublikasikan port 6881 pada host tidak berpengaruh. Anda memerlukan port yang diteruskan oleh provider, lalu mencantumkan port tersebut dalam FIREWALL_VPN_INPUT_PORTS, yang mengizinkan port dari sisi server VPN. Mullvad, yang digunakan dalam contoh ini, tidak mendukung port forwarding. Karena itu, Anda memerlukan provider yang mendukung fitur tersebut. Bagian inilah yang sering dibiarkan tidak berfungsi oleh sebagian besar media stack yang dibuat dengan Docker Compose.

Pemutus darurat: apa yang terjadi saat tunnel terputus

Pola ini menunjukkan manfaat kompleksitasnya saat terjadi kegagalan. Container yang terpasang menggunakan interface dan tabel routing milik Gluetun. Firewall Gluetun memblokir trafik Internet biasa di luar tunnel, tetapi tetap mengizinkan endpoint server VPN, trafik Docker lokal, dan pengecualian yang dikonfigurasi. Firewall tersebut mencegah fallback ke interface biasa saat tunnel terputus. Tidak ada jeda ketika paket dapat keluar melalui interface biasa saat client mencoba tersambung kembali.

Gluetun memantau koneksinya sendiri. Setiap menit, Gluetun mengirim ICMP echo (ping) ke alamat dalam HEALTH_ICMP_TARGET_IPS, yang secara default adalah 1.1.1.1,8.8.8.8. Jika ICMP tidak diizinkan, pemeriksaan singkat tersebut menggunakan query DNS UDP plaintext sebagai fallback. Setiap lima menit, Gluetun membuat koneksi TCP dan TLS (transport layer security) penuh ke HEALTH_TARGET_ADDRESSES, dengan nilai default cloudflare.com:443,github.com:443. Jika koneksi tersebut gagal, Gluetun memulai ulang VPN di dalam container dan mencatatnya:

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

Baca log container yang terpasang dengan mempertimbangkan urutan tersebut. Baris seperti connection refused, operation not permitted, dan i/o timeout di dalam aplikasi merupakan akibat tunnel yang terputus, bukan penyebabnya. Dokumentasi Gluetun menyatakan hal ini secara langsung karena orang sering melaporkan akibatnya lalu menghabiskan waktu berjam-jam untuk menelusurinya.

HEALTH_RESTART_VPN=on adalah nilai default dan sebaiknya tetap diaktifkan. Nonaktifkan hanya saat men-debug satu kegagalan tertentu, karena jika dinonaktifkan, tunnel yang terputus akan tetap terputus.

Urutan: cegah stack dimulai sebelum tunnel aktif

Image tersebut menyediakan healthcheck Docker:

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

Perintah itu menjalankan salinan gluetun kedua yang berumur singkat. Salinan ini meminta status health dari instance yang sedang berjalan pada http://127.0.0.1:9999/. Tunnel yang berfungsi mengembalikan 200 OK. Tunnel yang bermasalah mengembalikan 500 Internal server error beserta string error, lalu Docker menandai container sebagai tidak sehat setelah tiga pemeriksaan berturut-turut gagal.

condition: service_healthy yang menunggu kondisi tersebut. depends_on: [gluetun] biasa hanya menunggu container dimulai. Proses ini terjadi beberapa detik sebelum handshake selesai. Akibatnya, aplikasi dimulai ketika jaringan belum tersedia dan sering menyerah pada upaya koneksi pertamanya. Healthcheck di Docker Compose menjelaskan sintaks dan kolom waktu tersebut.

Ada satu batasan yang sering terlewat. Compose mengevaluasi kondisi itu saat memulai stack. Compose tidak menghentikan atau memulai ulang aplikasi jika gluetun kemudian menjadi tidak sehat. Pemulihan otomatis internal gluetun menangani kondisi tersebut. Karena itu, gluetun memulai ulang proses VPN, bukan container.

Periksa kebocoran DNS sebelum memercayai setup

DNS (domain name system) adalah kebocoran yang tetap terjadi meskipun tunnel sudah dikonfigurasi dengan benar. Gluetun menjalankan resolver sendiri di dalam namespace dan meneruskan query melalui DoT (DNS over TLS) ke Cloudflare secara default: DNS_UPSTREAM_RESOLVER_TYPE=dot dan DNS_UPSTREAM_RESOLVERS=cloudflare. Biarkan keduanya tanpa perubahan agar lookup terenkripsi dan melewati tunnel.

Pengaturan yang menyebabkan masalah ini jika diarahkan ke resolver lokal adalah DNS_UPSTREAM_PLAIN_ADDRESSES. Pengaturan ini sering digunakan ketika sebuah nama gagal di-resolve dan pengguna ingin router atau resolver milik provider yang menjawabnya. Dokumentasi Gluetun memperingatkan bahwa query yang dikirim ke resolver pada Docker bridge atau LAN bocor ke luar tunnel VPN. Resolver publik tanpa enkripsi tetap menerima query melalui tunnel, tetapi provider VPN dapat membaca dan mengubahnya. Kesalahan yang sama pada versi WireGuard dibahas dalam DNS yang berhenti me-resolve melalui tunnel WireGuard.

Untuk mengujinya, tetapkan SHADOWSOCKS=on dan SHADOWSOCKS_PASSWORD pada gluetun, publish 8388:8388/tcp dan 8388:8388/udp, lalu hubungkan dengan klien Shadowsocks yang dikonfigurasi untuk meneruskan DNS UDP melalui tunnel dan buka pengujian kebocoran DNS. Hasilnya harus menampilkan provider Anda atau Cloudflare, bukan router rumah Anda. Dokumentasi Gluetun juga memperingatkan bahwa beberapa pengujian kebocoran menampilkan hasil yang tidak biasa karena resolver di dalam namespace adalah perantara caching lokal, bukan server yang akhirnya memberikan jawaban. Anggap negara yang salah atau resolver ISP Anda sendiri sebagai indikasi kebocoran yang sebenarnya.

Menambahkan Tailscale di samping VPN sidecar, dan menentukan mana yang digunakan

Tailscale adalah jaringan overlay yang dibangun di atas WireGuard untuk mengakses mesin milik Anda sendiri. Banyak pengguna menjalankannya di samping VPN provider agar tetap memiliki jalur administrasi ke dalam stack. Berbagi namespace juga berarti berbagi aturan firewall. Karena itu, pengaturan firewall dan routing keduanya harus kompatibel. Dokumentasi Tailscale menyatakan perilaku default: Tailscale berfungsi sebagai jaringan overlay, hanya merutekan trafik antara perangkat yang menjalankan Tailscale, dan tidak menyentuh trafik Internet publik Anda.

Jadi, jawabannya bergantung pada satu pengaturan.

  • Tailscale dalam container sendiri, dengan konfigurasi default: Tailscale tidak pernah melihat trafik outbound aplikasi. Gluetun membawa seluruh trafik tersebut. Proses dalam container Tailscale dapat mengakses aplikasi pada gluetun:8080 melalui shared Docker network. Agar koneksi itu dapat diakses oleh klien tailnet, diperlukan forwarding atau proxy.
  • Tailscale terpasang pada namespace gluetun dengan network_mode: "service:gluetun": dalam mode userspace networking default, TS_USERSPACE aktif. tailscaled tidak membuat interface sama sekali dan berfungsi sebagai proxy SOCKS5 atau HTTP, sehingga tidak dapat mengubah routing. Gluetun tetap membawa trafik outbound biasa, kecuali aplikasi secara eksplisit menggunakan proxy tersebut.
  • Konfigurasi yang sama, dengan TS_USERSPACE=false: Tailscale memerlukan device /dev/net/tun dan capability-nya sendiri karena keduanya tidak ikut tersedia dari namespace tersebut. Tailscaled membuat tunnel device dan, di Linux, biasanya memasang route /32 IPv4 individual untuk setiap peer, bukan satu route untuk 100.64.0.0/10. Menetapkan TS_USERSPACE=false saja tidak mengaktifkan aggregate route. Tailscale hanya memasang route subnet milik node lain jika Anda meneruskan --accept-routes melalui TS_EXTRA_ARGS. TS_ROUTES bekerja ke arah sebaliknya: opsi ini mengiklankan subnet yang dapat dijangkau container ini kepada seluruh tailnet Anda, setara dengan tailscale set --advertise-routes=, dan tidak menambahkan route apa pun di sini. Trafik publik tetap keluar melalui gluetun.
  • Kernel networking dalam namespace gluetun dengan exit node yang dipilih, sudo tailscale set --exit-node=<exit-node-ip>: Tailscale memasang default route dalam namespace tersebut, tetapi firewall Gluetun dapat memblokir jalur itu. Memilih exit node dalam container terpisah tidak mengubah route aplikasi, sedangkan mode userspace hanya membawa trafik yang secara eksplisit dikirim melalui proxy-nya. Jangan menggabungkan default route yang saling bersaing dalam namespace gluetun. Satu default route, satu pemilik.

Jika route yang diiklankan itu adalah tujuan Anda, dan Anda ingin seluruh private network di belakang server dapat dijangkau, bukan hanya servernya, menjalankan Tailscale subnet router pada VPS mencakup persetujuan route, IP forwarding, serta flag sisi klien yang tidak diselesaikan oleh TS_ROUTES saja.

Jika Tailscale digunakan untuk menyediakan URL administrasi, bukan route, tailscale serve dan tailscale funnel menempatkan HTTPS di depan service HTTP lokal. Hanya funnel yang membukanya ke Internet publik. Dokumentasi Tailscale Serve hanya mendukung http://127.0.0.1 sebagai target proxy HTTP. Shared Docker network tidak menjadikan http://gluetun:8080 sebagai target yang didukung. Bagikan network namespace gluetun dengan network_mode: "service:gluetun" dan gunakan http://127.0.0.1:8080 sebagai target.

Salah satu efek samping terlihat ketika Tailscale berjalan di dalam tunnel. Peer-nya melihat alamat dari VPN provider. Karena itu, Tailscale lebih sering beralih ke relay. tailscale status menampilkan relay "..." di samping peer, bukan direct, ketika hal itu terjadi. Koneksi tetap berfungsi, tetapi lebih lambat. Jika yang benar-benar Anda perlukan hanya jaringan overlay, perbedaan antara WireGuard biasa dan Tailscale adalah titik awal yang lebih tepat.

Gangguan yang Terjadi dan Pesan yang Akan Ditampilkan

Docker menolak membuat container aplikasi. Error response from daemon: conflicting options: port publishing and the container type network mode berarti blok ports: masih terpasang pada service yang terhubung. Pindahkan blok tersebut ke gluetun.

Compose menolak seluruh file. Sebuah service tidak boleh menetapkan network_mode dan networks sekaligus. Tetapkan network pada gluetun.

Container lain tidak dapat menemukan aplikasi. curl: (6) Could not resolve host: qbittorrent adalah perilaku yang benar karena container yang terhubung tidak bergabung ke network mana pun dan tidak mendaftarkan nama apa pun. Gunakan gluetun dan port tersebut.

Container kedua yang terhubung tidak dapat dijalankan. Dua proses dalam satu namespace tidak dapat mengikat port yang sama. Proses yang kalah akan melaporkan bahwa alamat tersebut sudah digunakan. Ubah port internal aplikasi atau jalankan gluetun kedua.

Aplikasi tidak memiliki network setelah gluetun diubah. Restart atau pembuatan ulang gluetun memutus konektivitas semua container yang terhubung ke gluetun. Restart container-container tersebut.

Halaman kecil dapat dimuat, tetapi halaman besar macet. Masalahnya adalah MTU (maximum transmission unit). Tunnel menambahkan overhead, dan suatu perangkat dalam jalur membuang paket yang terlalu besar tanpa mengirimkan error. Periksa WIREGUARD_MTU, yang nilai default-nya pada v3.41.3 adalah 1320, lalu turunkan nilainya jika jalur tersebut memerlukan paket yang lebih kecil. Image development menggunakan path MTU discovery jika pengaturan ini tidak ditetapkan.

Gluetun tidak pernah menjadi healthy. Pemeriksaan saat startup menyebutkan dugaan pertama: WARN [vpn] restarting VPN because it failed to pass the healthcheck: startup check: dialing: dial tcp4: lookup cloudflare.com: i/o timeout. Periksa apakah key sudah kedaluwarsa, kemudian apakah daftar server sudah usang, lalu apakah firewall host memblokir UDP keluar.

FAQ

Mengapa port yang dipublikasikan oleh container saya berhenti berfungsi di belakang Gluetun?

Karena network_mode: "service:gluetun" menempatkan container ke dalam network namespace milik gluetun. Setiap namespace memiliki satu alamat IP dan satu kumpulan port listening. Aplikasi tetap melakukan listening, tetapi aturan publish harus berada pada container yang memiliki namespace tersebut. Pindahkan daftar ports: ke service gluetun. Jika daftar itu tetap berada pada service yang terhubung, Docker bahkan tidak akan membuatnya: Error response from daemon: conflicting options: port publishing and the container type network mode.

Bagaimana cara mengakses container di dalam tunnel VPN dari container di luarnya?

Gunakan nama service gluetun dan port tempat aplikasi melakukan listening, misalnya gluetun:8080. Container yang terhubung tidak memiliki Docker network sendiri, sehingga namanya tidak pernah dapat di-resolve. Tidak ada port yang perlu dipublikasikan untuk trafik antarkontainer. Sebaliknya, container di dalam namespace dapat mengakses container di luar namespace menggunakan nama servicenya, misalnya postgres:5432, pada Gluetun v3.41 dan yang lebih baru. Client pada subnet berbeda, seperti laptop di LAN Anda, memerlukan rute balik yang diizinkan oleh firewall dan routing gluetun; tambahkan subnet tersebut ke FIREWALL_OUTBOUND_SUBNETS.

Apakah Gluetun berfungsi sebagai kill switch ketika VPN terputus?

Ya, jika firewall-nya diaktifkan. Container yang terhubung berbagi interface dan rute Gluetun. Firewall memblokir trafik Internet biasa di luar tunnel, tetapi tetap mengizinkan endpoint server VPN, trafik Docker lokal, dan pengecualian yang dikonfigurasi. Gluetun kemudian me-restart VPN secara internal dan mencatat WARN [vpn] restarting VPN because it failed to pass the healthcheck, bukan keluar, karena setiap container yang terhubung akan kehilangan jaringan jika gluetun sendiri di-restart.

Tailscale dan Gluetun dalam stack yang sama: mana yang membawa trafik keluar?

Gluetun membawa trafik keluar biasa, kecuali Anda secara eksplisit mengirimkannya melalui Tailscale. Secara default, Tailscale hanya merutekan trafik antarperangkat dalam tailnet Anda dan membiarkan trafik publik tetap berjalan seperti biasa. Dalam mode userspace default pada image container, Tailscale sama sekali tidak membuat interface, sehingga tidak dapat memengaruhi routing. Dengan TS_USERSPACE=false, Linux biasanya mendapatkan rute peer IPv4 individual /32, bukan rute agregat 100.64.0.0/10, serta rute subnet node lain hanya jika Anda menambahkan --accept-routes melalui TS_EXTRA_ARGS. TS_ROUTES mengiklankan subnet container ini ke tailnet Anda dan tidak menambahkan rute lokal. Memilih exit node dengan sudo tailscale set --exit-node=<exit-node-ip> hanya memasang rute default pada namespace yang menggunakan networking kernel Tailscale. Container terpisah tidak mengubah rute aplikasi, sedangkan mode userspace hanya membawa trafik yang dikirim melalui proxy-nya. Pilih satu produk untuk mengelola rute default, bukan menggunakan keduanya secara bertumpuk.

Apakah artikel ini bermanfaat?