SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor

Gluetun سے host اور دوسرے containers تک رسائی

Gluetun کے network namespace میں container کا اپنا interface نہیں ہوتا۔ اس کی ports Gluetun پر publish کریں اور tunnel سے باہر صرف مطلوبہ subnets کھولیں۔

جب کوئی container gluetun کے network میں شامل ہوتا ہے تو کیا ہوتا ہے

network_mode: service:gluetun set کرنے والے container کا اپنا کوئی network interface نہیں ہوتا۔ یہ gluetun کے network namespace میں شامل ہو جاتا ہے، اس لیے port publishing اور firewall rules اس container کی خصوصیات نہیں رہتیں بلکہ gluetun service کی خصوصیات بن جاتی ہیں۔ ذیل کے تمام جوابات اسی ایک حقیقت سے اخذ ہوتے ہیں۔

Network namespace، kernel کی جانب سے فراہم کردہ network stack کی ایک نجی نقل ہوتا ہے: اس کے اپنے interfaces، اپنی routing table، اپنے firewall rules اور اپنے listening sockets ہوتے ہیں۔ Docker ہر container کو بطور default ایک namespace دیتا ہے۔ جب آپ network_mode: service:gluetun لکھتے ہیں تو Docker یہ مرحلہ چھوڑ کر نئے container کو اس namespace کے اندر رکھ دیتا ہے جس کی ملکیت پہلے ہی gluetun کے پاس ہے۔ Container اپنا filesystem برقرار رکھتا ہے، لیکن اپنا /etc/hosts یا /etc/resolv.conf نہیں رکھتا: Docker اسے وہی files دیتا ہے جو gluetun استعمال کرتا ہے، اور بعد میں یہ بات اہم ہو جاتی ہے۔

آپ اسے براہ راست دیکھ سکتے ہیں۔

docker inspect -f '{{.HostConfig.NetworkMode}}' qbittorrent

یہ gluetun container ID کے بعد container: دکھاتا ہے، جبکہ عام container کے لیے bridge دکھائی دیتا۔ یہ guide اسی مقام سے آگے بڑھتی ہے جہاں gluetun کے ذریعے Docker traffic کو VPN سے route کرنا ختم ہوتی ہے: tunnel کام کر رہا ہے، اور اب کوئی بھی container سے بات نہیں کر سکتا۔

Gluetun پر port publish کریں، application پر نہیں

سروس پر ایک ports: block موجود رہنے کی صورت میں، جو network_mode مقرر کرتا ہے، Docker container بنانے سے انکار کرتا ہے:

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

وجہ واضح ہے۔ کسی port کو publish کرنے کا مطلب NAT (network address translation) rule شامل کرنا ہے، جو host کے port سے traffic کو container کے اپنے network namespace میں forward کرتا ہے، لیکن اس container کا اپنا network namespace نہیں ہے۔ mapping کو gluetun service میں منتقل کریں۔ port number تبدیل نہیں ہوتا، کیونکہ application اب بھی shared namespace کے اندر اسی port پر listening کر رہی ہے۔

services:
  gluetun:
    ports:
      - "8080:8080/tcp"   # qBittorrent web UI

  qbittorrent:
    network_mode: "service:gluetun"
    # no ports: block here

dependent service میں expose: block اسی طرح ناکام ہوتا ہے۔ وہاں conflicting options: port exposing and the container type network mode بھی یہی نتیجہ دیتا ہے۔ وہاں networks: block بھی قطعی رکاوٹ بنتا ہے: Compose رپورٹ کرتا ہے کہ service نے باہم متضاد network_mode اور networks declare کیے ہیں، اور file کو مکمل طور پر load کرنے سے انکار کر دیتا ہے۔

ایک نتیجہ بعد میں مسئلہ پیدا کرتا ہے۔ namespace کے ہر container کے لیے ایک ہی port space مشترک ہوتی ہے، اس لیے وہ دو applications جو default طور پر 8080 استعمال کرتی ہیں، آپس میں ٹکرا جاتی ہیں، اور جو دوسری application start ہوتی ہے وہ address already in use error کے ساتھ fail ہو جاتی ہے۔ ان میں سے ایک کی اپنی configuration میں قدر تبدیل کریں، مثلاً LinuxServer qBittorrent image کا WEBUI_PORT variable، پھر نئی number کو gluetun پر publish کریں۔

Gluetun کے پیچھے موجود containers ایک دوسرے تک کیسے پہنچتے ہیں؟

Namespace کے اندر وہ پہلے ہی ایک loopback interface share کرتے ہیں۔ Gluetun کے پیچھے موجود container اپنے sibling تک 127.0.0.1:<port> پر پہنچتا ہے، اور اس کے لیے Docker network درکار نہیں ہوتا۔

Namespace کے باہر اس container کا اپنا کوئی نام نہیں ہوتا۔ Docker کا embedded DNS کسی service name کو user-defined network پر موجود اس service کے address پر resolve کرتا ہے، جبکہ اس container کا کسی بھی network پر address نہیں ہوتا۔ اس لیے Sonarr جیسا عام container torrent client تک http://qbittorrent:8080 پر نہیں پہنچتا۔ یہ http://gluetun:8080 پر پہنچتا ہے، کیونکہ socket gluetun کے namespace میں gluetun کے address پر listening کر رہا ہوتا ہے۔ یہ بات ان لوگوں کو حیران کرتی ہے جو Docker Compose networks اور service names کے کام کرنے کا طریقہ جانتے ہیں اور توقع کرتے ہیں کہ معمول کے نام یہاں بھی لاگو ہوں گے۔ Host پر کچھ publish کیے بغیر بھی یہ کام کرتا ہے، کیونکہ دونوں containers ایک ہی Compose network پر ہوتے ہیں۔

کسی بھی دوسری debugging سے پہلے DNS چیک کریں۔ Gluetun namespace کے اندر اپنا DNS server چلاتا ہے، اور Docker gluetun کے پیچھے موجود ہر container کو gluetun جیسی ہی /etc/resolv.conf file دیتا ہے۔ اس لیے آپ کی application کے lookups host کے resolver کے بجائے gluetun کے resolver سے گزرتے ہیں۔ By default یہ resolver ان answers کو بھی مسترد کرتا ہے جو private addresses کی طرف اشارہ کرتے ہیں۔ اسی وجہ سے کوئی name host پر resolve ہو سکتا ہے لیکن container کے اندر fail ہو سکتا ہے۔ Gluetun documentation کے مطابق ایسے hostnames کو DNS_REBINDING_PROTECTION_EXEMPT_HOSTNAMES میں درج کرنا ضروری ہے۔

docker exec qbittorrent cat /etc/resolv.conf

Docker host پر چلنے والی service تک کیسے پہنچیں؟

host.docker.internal استعمال کریں۔ اس کے لیے دو settings درکار ہیں، اور دونوں gluetun service پر ہونی چاہییں، کیونکہ دو الگ مسائل حل کرنے ہیں۔

پہلے نام شامل کریں۔ gluetun کے پیچھے موجود container، gluetun کی /etc/hosts پڑھتا ہے، اور Docker ایسی service پر extra_hosts entry مسترد کرتا ہے جو network_mode کو conflicting options: custom host-to-IP mapping and the network mode کے ساتھ set کرتی ہو۔ اس لیے entry gluetun پر ہونی چاہیے، اور namespace کے ہر container کو یہ entry نظر آئے گی۔

  gluetun:
    extra_hosts:
      - "host.docker.internal:host-gateway"

host-gateway ایک special value ہے جسے Docker خود host کے internal address سے replace کرتا ہے۔ عام Linux Docker installation میں یہ docker0 bridge کا address ہوتا ہے، جو عموماً 172.17.0.1 ہوتا ہے۔ VPS پر ip -4 addr show docker0 چلا کر اپنا address confirm کریں۔ Docker Desktop اس نام کو خود resolve کرتا ہے۔ اسی لیے laptop پر لکھی گئی guides میں extra_hosts line نہیں ہوتی، اور وہی file server پر fail ہو جاتی ہے۔

اب route شامل کریں۔ صرف نام شامل کرنے سے container کو استعمال کرنے والا address معلوم ہوتا ہے۔ Packet پھر بھی gluetun کے default route سے نکلتا ہے، جو tunnel ہوتا ہے، اور gluetun کا firewall اسے drop کر دیتا ہے۔ اس صورت میں connection پہلے hang ہوتا ہے اور پھر timeout ہو جاتا ہے، connection refused نہیں ہوتی۔ Refusal کا مطلب ہے کہ packet پہنچا اور کسی چیز نے جواب دیا کہ connection قبول نہیں ہے۔ Timeout کا مطلب ہے کہ packet پہنچا ہی نہیں۔

  gluetun:
    environment:
      - FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32

اس کے بعد چیک کریں کہ host service واقعی اس address پر listen کر رہی ہے۔ صرف 127.0.0.1 پر bound PostgreSQL server ایسے کسی بھی container سے reachable نہیں ہوتا جس کا اپنا network namespace ہو۔ اس میں gluetun کے پیچھے موجود ہر container شامل ہے، چاہے tunnel استعمال ہو یا نہ ہو، کیونکہ namespace کے اندر 127.0.0.1 اسی namespace کا اپنا loopback ہوتا ہے۔ صرف host networking والا container host کا loopback share کرتا ہے، جبکہ gluetun کے پیچھے موجود container اپنا network_mode پہلے ہی gluetun کو دے چکا ہوتا ہے۔ PostgreSQL کو اس کے بجائے 172.17.0.1 پر bind کریں۔ اس سے یہ containers سے connections قبول کرے گا، جبکہ public interface سے الگ رہے گا۔ Host پر ss -lntp | grep 5432 چلا کر تصدیق کریں۔

FIREWALL_OUTBOUND_SUBNETS اصل میں کیا تبدیل کرتا ہے

gluetun کی دستاویزات کے مطابق یہ ان subnets کی comma-separated فہرست ہے جن تک gluetun اور اس کے network stack کو share کرنے والے containers کو رسائی کی اجازت ہوتی ہے۔ اس میں firewall اور routing دونوں کی تبدیلیاں شامل ہوتی ہیں۔ دونوں پہلو اہم ہیں۔ gluetun ہر درج شدہ subnet کے لیے Docker bridge gateway کے ذریعے ایک route شامل کرتا ہے، اس لیے ان addresses کے packets tunnel کے بجائے eth0 سے باہر جاتے ہیں۔ یہ ان کے لیے firewall بھی کھولتا ہے، کیونکہ gluetun بصورت دیگر اس outbound traffic کو drop کر دیتا ہے جو VPN server کی طرف نہ جا رہی ہو۔

Value میں commas کے بعد spaces نہ لکھیں۔

      - FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32,192.168.1.0/24,100.64.7.9/32

دو خصوصیات آسانی سے نظر انداز ہو جاتی ہیں۔ یہ namespace-level setting ہے، اس لیے اس کا اطلاق gluetun کے پیچھے موجود ہر container پر ہوتا ہے، صرف اس container پر نہیں جسے آپ کے ذہن میں رکھا گیا تھا۔ دوسری خصوصیت یہ ہے کہ یہ صرف outbound traffic کے لیے ہے: یہ ان connections کو control کرتی ہے جو کوئی container خود شروع کرتا ہے۔ Published port پر آنے والے connections مختلف path سے گزرتے ہیں، اس لیے ان کے لیے یہاں کوئی entry درکار نہیں۔

Tailscale peer سے web UI تک رسائی

Tailscale ہر machine کو 100.64.0.0/10 میں ایک address دیتا ہے۔ یہ range carrier grade NAT کے لیے reserved ہے۔ ذاتی tailnet پر اس میں سے کسی چیز کی کوئی لاگت نہیں آتی، تاہم free plan میں چھ users کی حد یہ طے کرتی ہے کہ جب دوسرے لوگوں کو انہی UIs تک رسائی درکار ہو تو یہ صورت حال برقرار رہے گی یا نہیں۔ ہر plan میں user devices کی تعداد unlimited ہے۔ Servers اور دیگر tagged devices الگ شمار ہوتے ہیں: Tailscale کے pricing page کے مطابق 50 tagged resources شامل ہیں، جبکہ اضافی resources کی قیمت $1 ماہانہ فی resource ہے۔ چونکہ billing میں عموماً machines کے بجائے users شمار ہوتے ہیں، اس لیے paid tailnet کی اصل لاگت کیا ہوتی ہے زیادہ تر اس بات پر منحصر ہے کہ آپ کتنے لوگوں کو invite کرتے ہیں، نہ کہ کتنے containers ان کے لیے expose کرتے ہیں۔

Inbound سمت آسان ہے۔ gluetun پر 8080:8080 publish کرنے سے وہ port host کے تمام addresses پر bind ہو جاتا ہے، اور host کا tailscale0 interface بھی انہی میں شامل ہے، اس لیے کوئی peer http://<machine-name>:8080 کھول کر container تک پہنچ جاتا ہے۔ Docker host پر NAT apply کرتا ہے، اور gluetun کا firewall Docker subnet کے لیے آنے والی traffic کی اجازت دیتا ہے۔

UI کو صرف tailnet کے ذریعے reachable بنانے کے لیے published port کو ہر address کے بجائے host کے Tailscale address کے ساتھ bind کریں۔

    ports:
      - "100.101.102.103:8080:8080/tcp"

Host پر tailscale ip -4 کے ذریعے یہ address معلوم کریں۔ یہاں binding، firewall rule سے زیادہ مضبوط control ہے، کیونکہ port public interface پر بالکل open نہیں ہوتا۔ اگر آپ UI تک host اور port کے بجائے HTTPS name کے ذریعے پہنچنا چاہتے ہیں تو tailscale serve اس published port کے سامنے کام کر سکتا ہے، تاہم serve اور funnel اس لحاظ سے مختلف ہیں کہ آخرکار کون اس تک پہنچ سکتا ہے اور ان دونوں میں سے صرف ایک UI کو tailnet پر رکھتا ہے۔ یہ Docker کے ذریعے ports کو براہ راست ufw سے آگے publish کرنے کا مسئلہ بھی ختم کر دیتا ہے۔ Compose کے لیے Tailscale sidecar pattern اس سے بھی آگے جاتا ہے اور host port کو مکمل طور پر ختم کر دیتا ہے، لیکن یہ app کو sidecar کے network namespace میں رکھ کر کام کرتا ہے، اور gluetun کے پیچھے موجود container اپنا واحد network_mode پہلے ہی gluetun پر خرچ کر چکا ہوتا ہے۔

Outbound سمت میں FIREWALL_OUTBOUND_SUBNETS دوبارہ اہم ہو جاتا ہے۔ اگر کسی container کو کسی peer کو call کرنا ہو تو اس peer کا address شامل کریں، اور پورے /10 کے بجائے ہر peer کے لیے ایک /32 کو ترجیح دیں۔ اگر جس machine کو آپ call کر رہے ہیں وہ ایک private network پر موجود ہے اور یہ network ایک ایسے VPS کے ذریعے آپ کے tailnet میں advertise کیا گیا ہے جو اس subnet کو advertise کرتا ہے، تو router کے اپنے 100.x address کے بجائے advertised range درج کریں، اور تصدیق کریں کہ host نے خود بھی وہ routes قبول کیے ہیں۔ MagicDNS names container کے اندر default طور پر resolve نہیں ہوتے، کیونکہ container host کے resolver کے بجائے gluetun کا DNS server استعمال کرتا ہے، اس لیے numeric 100.x address استعمال کریں یا gluetun service پر extra_hosts line کے ذریعے name کو pin کریں۔ Gluetun کا DNS_UPSTREAM_PLAIN_ADDRESSES option queries کو کسی دوسرے resolver کو forward کر سکتا ہے، لیکن یہ ہر query کو plaintext میں بھیجتا ہے، اور gluetun کی documentation اس کے استعمال کے خلاف مشورہ دیتی ہے کیونکہ private address کو بھیجی جانے والی queries VPN tunnel سے باہر leak ہو جاتی ہیں۔ یہی بات اس وقت بھی لاگو ہوتی ہے جب آپ Headscale کے ساتھ اپنا Tailscale control server چلاتے ہیں۔

عام ساخت کے لیے مکمل compose فائل

VPN کے پیچھے ایک download client، دو web UIs جو صرف tailnet پر جواب دیتی ہیں، اور ایک container جو host پر چلنے والے PostgreSQL database سے data پڑھتا ہے۔

services:
  gluetun:
    image: qmcgaw/gluetun:latest
    container_name: gluetun
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun:/dev/net/tun
    ports:
      - "127.0.0.1:8000:8000/tcp"        # gluetun control server, host only
      - "100.101.102.103:8080:8080/tcp"  # qBittorrent UI, tailnet only
      - "100.101.102.103:9696:9696/tcp"  # Prowlarr UI, tailnet only
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - ./gluetun:/gluetun
    environment:
      - VPN_SERVICE_PROVIDER=mullvad
      - VPN_TYPE=wireguard
      - WIREGUARD_PRIVATE_KEY=${WIREGUARD_PRIVATE_KEY}
      - WIREGUARD_ADDRESSES=${WIREGUARD_ADDRESSES}
      - SERVER_CITIES=Amsterdam
      - FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32,100.64.7.9/32
      - TZ=Europe/Amsterdam
    restart: unless-stopped

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

  prowlarr:
    image: lscr.io/linuxserver/prowlarr:latest
    network_mode: "service:gluetun"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Amsterdam
      - PROWLARR__POSTGRES__HOST=host.docker.internal
      - PROWLARR__POSTGRES__PORT=5432
      - PROWLARR__POSTGRES__USER=prowlarr
      - PROWLARR__POSTGRES__PASSWORD=${PROWLARR_DB_PASSWORD}
      - PROWLARR__POSTGRES__MAINDB=prowlarr-main
      - PROWLARR__POSTGRES__LOGDB=prowlarr-log
    volumes:
      - ./prowlarr:/config
    depends_on:
      gluetun:
        condition: service_healthy
    restart: unless-stopped

product names کے بجائے file میں موجود pattern کو سمجھیں۔ دونوں UIs کو gluetun پر publish کیا گیا ہے اور host کے tailnet address سے bind کیا گیا ہے، اس لیے وہ Tailscale پر جواب دیتی ہیں اور کسی دوسری جگہ پر نہیں۔ extra_hosts لائن بھی gluetun پر موجود ہے، کیونکہ Prowlarr جب host.docker.internal resolve کرتا ہے تو gluetun کی /etc/hosts پڑھتا ہے، اور Docker اس لائن کو خود Prowlarr پر قبول نہیں کرے گا۔ FIREWALL_OUTBOUND_SUBNETS دو single addresses کی نشاندہی کرتا ہے: host کا Docker bridge address، تاکہ Prowlarr database connection کھول سکے، اور ایک tailnet peer۔

PostgreSQL server اس file میں جان بوجھ کر شامل نہیں ہے۔ یہ VPS پر عام system service کے طور پر چلتا ہے اور 172.17.0.1:5432 پر listening کرتا ہے۔ یہ وہی layering ہے جو Docker Compose پر arr stack میں ہوتی ہے، لیکن database کو Docker سے باہر منتقل کیا گیا ہے۔

WireGuard private key کو compose file میں نہ رکھیں۔ ${WIREGUARD_PRIVATE_KEY} اپنے ساتھ موجود .env file سے data پڑھتا ہے؛ یہی pattern Docker Compose کے لیے env files اور secrets میں بیان کیا گیا ہے۔ condition: service_healthy clause اس healthcheck کو استعمال کرتا ہے جو gluetun image میں پہلے سے شامل ہے، اس لیے tunnel کے up ہونے کی اطلاع دینے تک کوئی چیز start نہیں ہوتی۔ Compose healthchecks عمومی طریقہ بیان کرتے ہیں۔

ہر address پر publish کرنا، صرف tailnet پر نہیں

address prefix ہٹا دیں اور 0.0.0.0 پر port binds استعمال کریں، جس میں VPS کا public IP بھی شامل ہے۔ یہ صرف اس firewall کے پیچھے کریں جسے آپ control کرتے ہوں، اور پہلے اوپر موجود ufw نوٹ پڑھیں۔

    ports:
      - "8080:8080/tcp"

تصدیق کریں کہ tunnel اب بھی traffic منتقل کر رہا ہے

اسی request کو دو مرتبہ چلائیں: ایک مرتبہ namespace کے اندر سے اور ایک مرتبہ host سے۔ پھر دونوں نتائج کا موازنہ کریں۔

docker run --rm --network=container:gluetun curlimages/curl:latest -s https://api.ipify.org
curl -s https://api.ipify.org

پہلے نتیجے میں آپ کے VPN provider کا exit address آنا چاہیے۔ دوسرے نتیجے میں VPS address آنا چاہیے۔ اگر دونوں ایک جیسے ہوں تو container کا traffic tunnel سے نہیں گزر رہا۔ اس صورت میں جب تک یہ مسئلہ درست نہ ہو، اس guide کی باقی تمام اصلاحات بے اثر رہیں گی۔

Routing rules اور tables سے معلوم ہوتا ہے کہ کون سا traffic tunnel سے باہر جا رہا ہے اور کون سا نہیں۔

docker run --rm --network=container:gluetun alpine:3.22 sh -c 'ip rule show; ip route show table 51820; ip route show table 199'

اس guide کے WireGuard setup میں gluetun tunnel interface کو wg0 کا نام دیتا ہے۔ tun0 صرف اس کا OpenVPN default ہے۔ gluetun tunnel کی default route کو main routing table سے باہر بھی رکھتا ہے۔ ip rule show میں ایسی rule شامل ہونی چاہیے جو WireGuard کی طرف سے خود mark نہ کیے گئے تمام traffic کو table 51820 میں بھیجے، اور اس table میں wg0 پر default route ہونی چاہیے۔ Table 199 میں FIREWALL_OUTBOUND_SUBNETS کی ہر entry کے لیے ایک route ہوتی ہے، اور ہر route Docker bridge gateway eth0 کی طرف جاتی ہے۔ اس table کی rule کو tunnel والی rule سے فوراً پہلے چیک کیا جاتا ہے۔ عام ip route show اب بھی Docker کی اپنی default route eth0 پر دکھاتا ہے۔ یہ متوقع ہے اور leak نہیں ہے، کیونکہ gluetun کی دونوں rules main table سے پہلے چیک ہوتی ہیں۔ Table 199 میں موجود ایسی کوئی route جسے آپ نے درج نہیں کیا، وہ ایسا traffic ہے جو VPN کو bypass کر رہا ہے۔

gluetun کا control server port 8000 پر، /v1/publicip/ip پر، وہی public IP دکھا سکتا ہے، لیکن default طور پر یہ صرف authentication configure کرنے کے بعد ممکن ہے۔ gluetun documentation کے مطابق control server کے تمام routes اب default طور پر private ہیں، اس لیے اس path کو کی جانے والی عام request ناکام ہو جاتی ہے۔ /gluetun/auth/config.toml پر bind mounted auth file کے ذریعے basic یا apikey method استعمال کرتے ہوئے اسے configure کریں، پھر gluetun restart کریں۔ اوپر دی گئی compose file پہلے ہی ./gluetun کو /gluetun پر mount کرتی ہے، اس لیے host پر file کو ./gluetun/auth/config.toml پر رکھیں۔ HTTP_CONTROL_SERVER_AUTH_DEFAULT_ROLE variable زیادہ تیز طریقہ ہے۔ اسے {"auth":"none"} پر set کرنے سے authentication مکمل طور پر بند ہو جاتی ہے، جس کی docs میں سختی سے حوصلہ شکنی کی گئی ہے۔ v3.39.1 سے پہلے کی release میں server اس طرح locked down نہیں ہوتا تھا، اور docs خبردار کرتی ہیں کہ جو بھی اس تک پہنچ سکے، اس پر اعتماد کرنا پڑتا ہے۔

ایک غلط subnet سے پیدا ہونے والا leak

FIREWALL_OUTBOUND_SUBNETS ایسا hole ہے جو آپ firewall میں جان بوجھ کر بناتے ہیں، اس لیے hole کا حجم risk کے حجم کے برابر ہوتا ہے۔ چار غلطیوں سے بچیں:

  • 0.0.0.0/0 کی configuration validation outbound subnet has an unspecified address: 0.0.0.0/0 کے ساتھ fail ہو جاتی ہے۔ Gluetun اسے accept کرنے کے بجائے reject کر دیتا ہے، تاکہ تمام traffic tunnel سے باہر route نہ ہو۔
  • Target سے زیادہ وسیع range۔ ایک machine کو 10.0.1.7 پر reach کرنے کے لیے 10.0.0.0/8 کھولنے سے اس range میں torrent peer کے advertise کیے گئے تمام addresses بھی open ہو جاتے ہیں۔ 10.0.1.7/32 لکھیں۔
  • ایسی range جو tunnel کے اپنے addresses سے overlap کرتی ہو۔ gluetun documentation کے مطابق اس صورت میں gluetun VPN traffic کو bridge کے ذریعے باہر بھیج دیتا ہے، جس سے port forwarding کام نہیں کرتی۔ کوئی private range کھولنے سے پہلے اپنی WIREGUARD_ADDRESSES value check کریں۔
  • Tailscale کے لیے 100.64.0.0/10۔ اس سے تقریباً چار million addresses open ہو جاتے ہیں تاکہ ایک peer تک رسائی حاصل کی جا سکے۔ مطلوبہ peers کو /32 entries کے طور پر درج کریں۔

یاد رکھیں کہ یہ setting پورے namespace پر لاگو ہوتی ہے۔ کسی indexer کو host service تک پہنچانے کے لیے subnet کھولنے سے اسی namespace کو share کرنے والے torrent client کے لیے بھی وہی subnet open ہو جاتا ہے۔ اس variable میں ہر تبدیلی کے بعد public IP check دوبارہ چلائیں، کیونکہ صرف یہی test دکھاتا ہے کہ تبدیلی نے وہی نتیجہ دیا ہے جو آپ چاہتے تھے۔

gluetun کو restart کرنے پر کیا خراب ہوتا ہے

gluetun namespace کا مالک ہوتا ہے، اس لیے gluetun کی lifecycle ہی namespace کی lifecycle ہوتی ہے۔ gluetun کے بند ہونے کے دوران dependent container شروع کرنے کی کوشش فوراً ناکام ہو جاتی ہے:

Error response from daemon: cannot join network namespace of a non running container: container <id> is exited

gluetun کو اسی جگہ restart کرنا زیادہ خاموش failure ہے۔ dependent containers چلتے رہتے ہیں، جبکہ وہ namespace جس سے وہ منسلک تھے، ان کے نیچے دوبارہ بنایا جا رہا ہوتا ہے۔ نتیجتاً docker ps ہر چیز کو healthy بتاتا ہے، لیکن کوئی چیز جواب نہیں دیتی۔ gluetun service میں کسی بھی تبدیلی کے بعد صرف ایک حصے کو restart کرنے کے بجائے پورے group کو دوبارہ بنائیں۔

docker compose up -d --force-recreate

یہی اصول image updates پر بھی لاگو ہوتا ہے۔ نئی gluetun image pull کرکے صرف اسی service کو دوبارہ بنانے سے باقی containers ایسے namespace کی طرف اشارہ کرتے رہتے ہیں جو اب موجود نہیں ہے۔

FAQ

Docker یہ کیوں کہتا ہے کہ "port publishing and the container type network mode"؟

کیونکہ ports: block اب بھی اس service پر موجود ہے جو network_mode: service:gluetun بھی set کرتی ہے۔ Port publish کرنے سے ایک NAT rule شامل ہوتا ہے جو host port سے container کے اپنے network namespace تک traffic forward کرتا ہے، لیکن اس mode میں container کا اپنا network namespace نہیں ہوتا۔ اس service سے ports: block حذف کریں اور وہی mapping gluetun service میں شامل کریں۔ Port number وہی رہے گا، کیونکہ application shared namespace کے اندر اسی port پر listening کر رہی ہے۔

gluetun کے پیچھے موجود service تک دوسرے containers کیسے پہنچتے ہیں؟

اسی namespace کے containers ایک دوسرے تک 127.0.0.1 کے ذریعے پہنچتے ہیں۔ اس namespace سے باہر موجود containers gluetun service name استعمال کرتے ہیں، اس لیے http://gluetun:8080 کام کرتا ہے جبکہ http://qbittorrent:8080 کام نہیں کرتا۔ Application container کا کسی Docker network پر اپنا address نہیں ہوتا، اس لیے embedded DNS server کے پاس اس کے name کو resolve کرنے کے لیے کچھ نہیں ہوتا۔ اس مقصد کے لیے port publishing ضروری نہیں، بشرطیکہ دونوں containers ایک ہی Compose network share کرتے ہوں۔

FIREWALL_OUTBOUND_SUBNETS میں کیا شامل کرنا چاہیے؟

صرف وہ addresses شامل کریں جن سے gluetun کے پیچھے موجود container کو connection شروع کرنا ضروری ہو، اور انہیں ممکنہ حد تک محدود network ranges میں لکھیں۔ ایک single machine کے لیے /32 استعمال ہوتا ہے۔ دو عام entries Docker host کے لیے 172.17.0.1/32 اور ہر Tailscale peer کے لیے ایک /32 ہیں جس سے آپ connection کرتے ہیں۔ 0.0.0.0/0 کبھی شامل نہ کریں، اور ایسی range بھی شامل نہ کریں جو آپ کے VPN کے اپنے tunnel addresses سے overlap کرتی ہو۔ Published port پر آنے والی inbound connections کے لیے یہاں کسی entry کی ضرورت نہیں ہے۔

Container میرے Tailscale MagicDNS names کو resolve کیوں نہیں کر سکتا؟

MagicDNS اس طرح کام کرتا ہے کہ host کے resolver کو Tailscale کے DNS server کی طرف point کیا جاتا ہے، لیکن container host کا resolver استعمال نہیں کرتا۔ یہ وہ /etc/resolv.conf استعمال کرتا ہے جسے gluetun کے ساتھ share کرتا ہے، اور جو gluetun کے اپنے DNS server کی طرف point کرتا ہے۔ docker exec <container> cat /etc/resolv.conf سے تصدیق کریں۔ Peer کا numeric 100.x address استعمال کریں، یا gluetun service پر extra_hosts entry کے ذریعے name کو pin کریں۔ Gluetun DNS_UPSTREAM_PLAIN_ADDRESSES کے ذریعے queries کسی دوسرے resolver کو forward کر سکتا ہے، لیکن اس سے queries plaintext میں بھیجی جاتی ہیں اور اس کی documentation اس کے خلاف مشورہ دیتی ہے۔

میں کیسے تصدیق کروں کہ traffic اب بھی VPN کے ذریعے جا رہا ہے؟

Namespace کے اندر سے ایک request چلائیں اور host سے وہی request چلائیں، پھر دونوں answers کا موازنہ کریں۔ docker run --rm --network=container:gluetun curlimages/curl:latest -s https://api.ipify.org کو آپ کے VPN provider کا exit address واپس کرنا چاہیے، جبکہ VPS پر curl -s https://api.ipify.org کو VPS address واپس کرنا چاہیے۔ اگر دونوں answers ایک جیسے ہوں تو tunnel container کا traffic منتقل نہیں کر رہا۔ FIREWALL_OUTBOUND_SUBNETS میں ہر تبدیلی کے بعد یہ check دوبارہ چلائیں۔

کیا یہ مضمون مفید تھا؟