SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

آموزش اتصال کانتینر Docker به VPN با Gluetun

هنگام استفاده از network_mode: service:gluetun پورت‌ها در Docker ناپدید می‌شوند. در این راهنما علت این مشکل و نحوه تنظیم صحیح فایل docker-compose برای رفع آن را بررسی می‌کنیم.

چرا هنگام هدایت کانتینرهای Docker از طریق VPN، پورت‌ها ناپدید می‌شوند

برای هدایت کانتینرهای Docker از طریق VPN، شما تونل را به یک کانتینر اختصاص می‌دهید و سپس بقیه کانتینرها را با استفاده از network_mode: "service:gluetun" به فضای نام شبکه (network namespace) آن متصل می‌کنید. این اتصال همان بخشی است که باعث تعجب کاربران می‌شود. کانتینر متصل‌شده دیگر شبکه اختصاصی خود را ندارد، بنابراین پورت‌های منتشرشده (published ports) و نام سرویس Docker آن نیز همراه با شبکه اختصاصی حذف می‌شوند. پورت‌ها را روی کانتینر VPN منتشر کنید تا سایر کانتینرها بتوانند از طریق نام کانتینر VPN به برنامه دسترسی پیدا کنند.

اگر یک بلوک ports: روی کانتینر متصل‌شده باقی بگذارید، Docker از ایجاد آن کانتینر خودداری می‌کند:

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

ابزار مورد استفاده در اینجا Gluetun است؛ کانتینری که از طریق WireGuard یا OpenVPN به یک ارائه‌دهنده VPN تجاری متصل می‌شود و فایروال اختصاصی خود را دارد. نسخه v3.41.3 تا اکتبر 2026 نسخه جاری است. مثال‌ها از Mullvad با WireGuard استفاده می‌کنند، بنابراین شما به یک حساب کاربری و یک کلید از ارائه‌دهنده خود نیاز دارید. اگر ترجیح می‌دهید تونل را روی سخت‌افزاری که مالک آن هستید خاتمه دهید، راه‌اندازی سرور WireGuard شخصی روی یک VPS سمت دیگر اتصال را می‌سازد و wg-easy در Docker آن را در یک رابط کاربری وب بسته‌بندی می‌کند.

عملکرد واقعی network_mode: "service:gluetun"

هر container در Docker به‌طور معمول فضای نام شبکه (network namespace) اختصاصی خود را دارد: رابط‌ها، جدول مسیریابی، قوانین فایروال و سوکت‌های در حال گوش دادن (listening sockets) مختص به خود. حالت service: از این مرحله صرف‌نظر کرده و container را درون فضای نام gluetun اجرا می‌کند. یک فضای نام به معنای یک آدرس IP واحد است و این موضوع 6 مورد را تغییر می‌دهد:

  • برنامه هیچ آدرس مستقلی ندارد. آدرس آن همان آدرس gluetun است.
  • برنامه به هیچ شبکه Docker متصل نیست، بنابراین نام سرویس آن هرگز ثبت نمی‌شود و قابل resolve نیست. سایر containerها باید از gluetun استفاده کنند.
  • containerهای درون این فضای نام از طریق localhost به یکدیگر دسترسی پیدا می‌کنند.
  • دو container در یک فضای نام نمی‌توانند روی یک پورت مشابه گوش دهند. مستندات Gluetun در این مورد صریح است: هیچ راه حلی برای آن وجود ندارد.
  • قابلیت‌ها (Capabilities) متعلق به یک container هستند، نه یک فضای نام. Gluetun دارای NET_ADMIN و /dev/net/tun است زیرا رابط تونل را ایجاد می‌کند. container متصل‌شده این قابلیت‌ها را به ارث نمی‌برد.
  • ابزار Compose هر فایلی را که در آن یک سرویس همزمان network_mode و networks را تنظیم کرده باشد، رد می‌کند. gluetun را به شبکه‌های خود متصل کنید تا برنامه همراه آن عمل کند.

راه‌اندازی مجدد (Restart) gluetun باعث قطع اتصال تمام مواردی می‌شود که به آن متصل هستند. این یک رفتار مستندشده است و به همین دلیل است که gluetun به‌جای خروج در هنگام شکست اتصال، فرآیند VPN را درون container مجدداً راه‌اندازی می‌کند. پس از اینکه خودتان gluetun را restart یا recreate کردید، containerهای متصل به آن را نیز restart کنید.

فایل compose که کار می‌کند

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

تگ :v3 جدیدترین release پایدار در سری v3 است. تگ :latest به آخرین commit از شاخه master اشاره دارد که لبه توسعه است؛ بنابراین روی ماشینی که نمی‌خواهید روز سه‌شنبه آن را عیب‌یابی کنید، :v3 را ثابت کنید.

WEBUI_PORT=8080 باید با پورت منتشرشده یکسان باشد، چون qBittorrent در namespace مربوط به gluetun bind می‌شود و rule انتشار، ترافیک host را به پورت 8080 در همان‌جا ارسال می‌کند. اگر یکی از این دو عدد را بدون دیگری تغییر دهید، پورت به هیچ درخواستی پاسخ نمی‌دهد. 127.0.0.1:8080:8080 رابط وب را روی آدرس loopback مربوط به host نگه می‌دارد. یک 8080:8080 بدون مقدار، روی همه interfaceها publish می‌شود و rule فایروال خودش را ایجاد می‌کند؛ به همین دلیل پورت‌های منتشرشده Docker مستقیماً از ufw عبور می‌کنند.

آن را بالا بیاورید، سپس به این ترتیب بررسی کنید:

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

docker compose ps باید gluetun را به‌صورت healthy و qbittorrent را به‌صورت running نشان دهد. سپس آدرس خروجی را از داخل namespace تأیید کنید؛ این همان بررسی‌ای است که نتیجه همه موارد دیگر را تعیین می‌کند:

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

فیلد ip در آن JSON باید آدرس provider مربوط به VPN شما باشد. اگر آدرس خود سرور شماست، برنامه داخل tunnel نیست و هیچ‌یک از موارد زیر مطابق توضیح عمل نخواهند کرد.

کلیدها را خارج از فایل compose نگه دارید

gluetun.env حاوی اعتبارنامه‌ها است و نباید در git قرار بگیرد:

WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
WIREGUARD_ADDRESSES=10.64.222.21/32

هر دو مقدار از فایل پیکربندی WireGuard که در پنل کاربری ارائه‌دهنده خود ایجاد می‌کنید، به دست می‌آیند. مجوز فایل را روی 600 تنظیم کنید. در مورد مزیت این کار صادق باشید: کلید در مخزن شما ذخیره نمی‌شود، اما docker inspect gluetun همچنان تمام متغیرهای محیطی را برای هر کسی که به Docker socket دسترسی داشته باشد، نمایش می‌دهد. فایل‌های محیطی و secrets در Docker Compose گزینه‌های امن‌تر را بررسی می‌کند.

نحوه ارتباط یک کانتینر خارج از تونل با کانتینری در داخل آن

هر دو جهت ارتباط کار می‌کنند و هر کدام از نام متفاوتی استفاده می‌کنند. دو کانتینر به یک شبکه Docker مشترک نیاز دارند؛ یعنی شبکه gluetun، زیرا کانتینر متصل‌شده هیچ شبکه مستقلی ندارد. بخش نحوه سیم‌کشی شبکه‌های Docker Compose تنظیمات پیش‌فرض را پوشش می‌دهد.

از خارج به داخل، از نام gluetun و پورتی که برنامه روی آن گوش می‌دهد استفاده کنید. یک کانتینر reverse proxy از طریق gluetun:8080 به رابط وب qBittorrent دسترسی پیدا می‌کند. برای این کار نیازی به ورودی ports: نیست، زیرا ترافیک بین کانتینرها در شبکه Docker باقی می‌ماند و هرگز با پورت میزبان (host) تماس پیدا نمی‌کند.

از داخل به خارج، از نام سرویس کانتینر دیگر استفاده کنید، برای مثال postgres:5432. از نسخه v3.41 به بعد، gluetun نام سایر کانتینرها را از داخل فضای نام (namespace) خود حل می‌کند، بنابراین اگر نامی حل نشد، از این نسخه یا نسخه‌های جدیدتر استفاده کنید.

فایروال gluetun تعیین می‌کند چه کسی اجازه برقراری اتصال با آن را دارد. ترافیک شبکه Docker خودِ gluetun مجاز است. کلاینتی در یک زیرشبکه (subnet) متفاوت، لپ‌تاپی در شبکه LAN شما یا کانتینری در یک شبکه bridge جداگانه، به یک مسیر بازگشت نیاز دارد که توسط فایروال و مسیریابی gluetun مجاز شمرده شود:

FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24

معنای مستندات دقیق است: زیرشبکه‌های جداشده با کاما که gluetun و کانتینرهایی که از پشته شبکه آن استفاده می‌کنند، اجازه دسترسی به آن‌ها را دارند.

اتصالات ورودی از اینترنت یک مسئله جداگانه است. همتایان (peers) یک کلاینت تورنت از سمت VPN می‌آیند، بنابراین انتشار پورت 6881 روی میزبان هیچ تأثیری برای آن‌ها ندارد. شما به یک پورت فوروارد شده از طرف ارائه‌دهنده خود نیاز دارید و آن پورت باید در FIREWALL_VPN_INPUT_PORTS لیست شود، که اجازه استفاده از پورت‌ها را از سمت سرور VPN می‌دهد. Mullvad که در این مثال استفاده شده، از port forwarding پشتیبانی نمی‌کند، بنابراین این مورد به ارائه‌دهنده‌ای نیاز دارد که از آن پشتیبانی کند. این همان بخشی است که اکثر استک‌های رسانه‌ای ساخته‌شده با Docker Compose آن را ناقص باقی می‌گذارند.

کلید قطع اضطراری (kill switch): هنگام قطع تونل چه اتفاقی می‌افتد

این الگو پیچیدگی خود را در زمان بروز خطا نشان می‌دهد. کانتینر متصل، از رابط‌ها (interfaces) و جدول مسیریابی Gluetun استفاده می‌کند. فایروال Gluetun ترافیک عادی اینترنت را در خارج از تونل مسدود می‌کند، اما اجازه عبور به مقصد سرور VPN، ترافیک محلی Docker و استثناهای پیکربندی‌شده را می‌دهد. همین فایروال است که هنگام قطع تونل، از بازگشت به رابط اصلی (plain interface) جلوگیری می‌کند. هیچ بازه زمانی وجود ندارد که در آن بسته‌ها در حین اتصال مجدد کلاینت، از رابط اصلی نشت کنند.

Gluetun اتصال خود را پایش می‌کند. هر دقیقه یک ICMP echo (یک ping) به آدرس‌های موجود در HEALTH_ICMP_TARGET_IPS ارسال می‌کند که به‌صورت پیش‌فرض 1.1.1.1,8.8.8.8 هستند. اگر ICMP مجاز نباشد، این بررسی کوچک به یک پرس‌وجوی ساده UDP DNS تغییر وضعیت می‌دهد. هر پنج دقیقه، یک اتصال کامل TCP و TLS (امنیت لایه انتقال) به HEALTH_TARGET_ADDRESSES برقرار می‌کند که پیش‌فرض آن cloudflare.com:443,github.com:443 است. هنگامی که این موارد با شکست مواجه شوند، VPN را درون کانتینر مجدداً راه‌اندازی کرده و آن را ثبت می‌کند:

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

لاگ‌های کانتینر متصل را با در نظر داشتن این ترتیب بخوانید. خطوطی مانند connection refused، operation not permitted و i/o timeout در داخل برنامه، پیامد قطع شدن تونل هستند، نه علت آن. مستندات Gluetun مستقیماً به این موضوع اشاره کرده است، زیرا کاربران اغلب پیامد را گزارش کرده و ساعت‌ها به دنبال علت آن می‌گردند.

HEALTH_RESTART_VPN=on مقدار پیش‌فرض است و باید فعال بماند. آن را فقط زمانی غیرفعال کنید که در حال عیب‌یابی یک خطای خاص هستید، زیرا با غیرفعال بودن آن، تونل قطع‌شده به همان حالت باقی می‌ماند.

ترتیب‌بندی: جلوگیری از شروع stack پیش از برقراری تونل

این ایمیج دارای یک healthcheck در Docker است:

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

این دستور یک کپی کوتاه و موقت از gluetun اجرا می‌کند که سرور سلامت نسخه در حال اجرا را در http://127.0.0.1:9999/ پرس‌وجو می‌کند. یک تونل فعال پاسخ 200 OK را برمی‌گرداند. تونل قطع‌شده پاسخ 500 Internal server error را به همراه یک رشته خطا برمی‌گرداند و Docker پس از سه بررسی ناموفق متوالی، وضعیت container را unhealthy علامت‌گذاری می‌کند.

condition: service_healthy همان چیزی است که منتظر این وضعیت می‌ماند. عبارت ساده depends_on: [gluetun] تنها منتظر شروع شدن container می‌ماند که چند ثانیه پیش از تکمیل handshake رخ می‌دهد؛ بنابراین برنامه در یک شبکه غیرفعال شروع به کار می‌کند و اغلب در اولین تلاش برای اتصال، متوقف می‌شود. بررسی‌های سلامت در Docker Compose سینتکس و فیلدهای زمان‌بندی را بررسی می‌کند.

یک محدودیت وجود دارد که کاربران را دچار مشکل می‌کند. Compose این شرط را هنگام شروع stack ارزیابی می‌کند. اگر وضعیت gluetun بعداً به unhealthy تغییر کند، برنامه متوقف یا ری‌استارت نمی‌شود. قابلیت auto-healing داخلی gluetun این مورد را پوشش می‌دهد و به همین دلیل است که به جای container، فرآیند VPN را ری‌استارت می‌کند.

پیش از اعتماد به تنظیمات، نشت DNS را بررسی کنید

DNS (domain name system) همان نشت احتمالی است که حتی پس از برقراری صحیح تونل نیز باقی می‌ماند. Gluetun resolver خود را داخل namespace اجرا می‌کند و درخواست‌ها را به‌طور پیش‌فرض از طریق DoT (DNS over TLS) به Cloudflare ارسال می‌کند: DNS_UPSTREAM_RESOLVER_TYPE=dot و DNS_UPSTREAM_RESOLVERS=cloudflare. هر دو مقدار را تغییر ندهید تا lookupها رمزگذاری شوند و از داخل تونل عبور کنند.

تنظیمی که در صورت اشاره به یک resolver محلی این وضعیت را مختل می‌کند، DNS_UPSTREAM_PLAIN_ADDRESSES است. کاربران معمولاً زمانی به این گزینه روی می‌آورند که resolve شدن یک نام با خطا مواجه می‌شود و می‌خواهند router یا resolver ارائه‌دهنده آن‌ها پاسخ را برگرداند. مستندات Gluetun هشدار می‌دهد که درخواست‌های ارسال‌شده به resolver روی Docker bridge یا LAN، خارج از تونل VPN نشت می‌کنند. یک resolver عمومیِ بدون رمزگذاری همچنان درخواست‌ها را از داخل تونل دریافت می‌کند، اما ارائه‌دهنده VPN می‌تواند آن‌ها را بخواند و تغییر دهد. نسخه WireGuard همین اشتباه در DNS که در تونل WireGuard از resolve شدن بازمی‌ماند پوشش داده شده است.

برای آزمایش، SHADOWSOCKS=on و SHADOWSOCKS_PASSWORD را روی gluetun تنظیم کنید، 8388:8388/tcp و 8388:8388/udp را publish کنید، سپس با یک client مربوط به Shadowsocks که برای عبور دادن UDP DNS از تونل پیکربندی شده است متصل شوید و یک DNS leak test را بارگذاری کنید. نتیجه باید نام ارائه‌دهنده شما یا Cloudflare را نشان دهد، نه home router شما را. مستندات خود Gluetun هشدار می‌دهد که برخی leak testها نتایج غیرعادی گزارش می‌کنند، زیرا resolver داخل namespace یک واسط caching محلی است، نه سروری که در نهایت پاسخ را ارائه می‌دهد. کشور نادرست یا resolver مربوط به ISP خودتان را به‌عنوان نشانه واقعی در نظر بگیرید.

افزودن Tailscale در کنار sidecar وی‌پی‌ان و تعیین اولویت

Tailscale یک شبکه overlay مبتنی بر WireGuard برای دسترسی به ماشین‌های شخصی شماست و کاربران اغلب آن را در کنار یک VPN ارائه‌دهنده سرویس اجرا می‌کنند تا یک مسیر مدیریتی به stack خود داشته باشند. اشتراک‌گذاری یک namespace به معنای اشتراک‌گذاری قوانین فایروال است، بنابراین این دو باید تنظیمات فایروال و مسیریابی سازگاری داشته باشند. مستندات Tailscale رفتار پیش‌فرض را این‌گونه بیان می‌کند: این ابزار به عنوان یک شبکه overlay عمل می‌کند، ترافیک را فقط بین دستگاه‌هایی که Tailscale روی آن‌ها اجرا شده مسیریابی می‌کند و به ترافیک اینترنت عمومی شما دست نمی‌زند.

بنابراین پاسخ به یک تنظیم خاص بستگی دارد.

  • Tailscale در container اختصاصی خود با پیکربندی پیش‌فرض: این حالت ترافیک خروجی برنامه را نمی‌بیند. Gluetun تمام ترافیک را حمل می‌کند. یک پردازش در container مربوط به Tailscale از طریق یک شبکه Docker مشترک به برنامه در gluetun:8080 دسترسی پیدا می‌کند؛ برای در دسترس قرار دادن این اتصال برای کلاینت‌های tailnet، به forwarding یا یک proxy نیاز است.
  • Tailscale متصل به namespace مربوط به gluetun با network_mode: "service:gluetun": در حالت پیش‌فرض شبکه userspace، وقتی TS_USERSPACE فعال است، tailscaled هیچ رابطی (interface) ایجاد نمی‌کند و به عنوان یک SOCKS5 یا HTTP proxy عمل می‌کند، بنابراین نمی‌تواند مسیریابی را تغییر دهد. Gluetun همچنان ترافیک خروجی عادی را حمل می‌کند مگر اینکه برنامه به‌طور صریح از آن proxy استفاده کند.
  • همان حالت با TS_USERSPACE=false: Tailscale به دستگاه /dev/net/tun و قابلیت‌های خاص خود نیاز دارد زیرا این موارد همراه با namespace ارائه نمی‌شوند. Tailscaled یک دستگاه تونل ایجاد می‌کند و در لینوکس، معمولاً به جای یک مسیر واحد برای 100.64.0.0/10، مسیرهای فردی IPv4 peer /32 را نصب می‌کند. تنظیم TS_USERSPACE=false به‌تنهایی مسیر کلی (aggregate route) را فعال نمی‌کند. این ابزار مسیرهای subnet سایر گره‌ها را تنها در صورتی نصب می‌کند که --accept-routes را از طریق TS_EXTRA_ARGS ارسال کنید. TS_ROUTES در جهت مخالف عمل می‌کند: این ابزار subnetهایی که این container می‌تواند به آن‌ها دسترسی داشته باشد را به بقیه tailnet شما معرفی می‌کند (معادل tailscale set --advertise-routes=) و هیچ مسیری در اینجا اضافه نمی‌کند. ترافیک عمومی همچنان از طریق gluetun خارج می‌شود.
  • شبکه هسته (Kernel networking) در namespace مربوط به gluetun با انتخاب یک exit node، sudo tailscale set --exit-node=<exit-node-ip>: Tailscale مسیرهای پیش‌فرض را در آن namespace نصب می‌کند، اما فایروال Gluetun می‌تواند آن مسیر را مسدود کند. انتخاب یک exit node در یک container جداگانه، مسیرهای برنامه را تغییر نمی‌دهد و حالت userspace فقط ترافیکی را حمل می‌کند که صریحاً از طریق proxy آن ارسال شده باشد. مسیرهای پیش‌فرض رقیب را در namespace مربوط به gluetun ترکیب نکنید. یک مسیر پیش‌فرض، یک مالک.

اگر هدف، مسیرهای معرفی‌شده (advertised routes) است و می‌خواهید کل شبکه خصوصی پشت آن جعبه قابل دسترسی باشد نه فقط خود جعبه، اجرای یک Tailscale subnet router روی یک VPS مراحل تأیید مسیر، IP forwarding و فلگ سمت کلاینت که TS_ROUTES به‌تنهایی انجام نمی‌دهد را پوشش می‌دهد.

اگر Tailscale برای ارائه یک URL مدیریتی حضور دارد نه یک مسیر، tailscale serve و tailscale funnel پروتکل HTTPS را در مقابل یک سرویس HTTP محلی قرار می‌دهند و فقط قابلیت funnel آن را به اینترنت عمومی باز می‌کند. مستندات Tailscale Serve فقط از http://127.0.0.1 به عنوان مقصد HTTP proxy پشتیبانی می‌کند. یک شبکه Docker مشترک، http://gluetun:8080 را به یک مقصد پشتیبانی‌شده تبدیل نمی‌کند. شبکه namespace مربوط به gluetun را با network_mode: "service:gluetun" به اشتراک بگذارید و http://127.0.0.1:8080 را هدف قرار دهید.

یک اثر جانبی زمانی قابل مشاهده است که Tailscale داخل تونل اجرا شود. همتایان (peers) آن، آدرس ارائه‌دهنده VPN را می‌بینند، بنابراین انتظار داشته باشید که بیشتر به سمت relayها بازگردد. وقتی این اتفاق می‌افتد، tailscale status به جای direct، عبارت relay "..." را در کنار یک peer نشان می‌دهد. اتصال برقرار است اما کندتر خواهد بود. اگر overlay تنها چیزی است که واقعاً به آن نیاز دارید، تفاوت بین WireGuard ساده و Tailscale نقطه شروع بهتری است.

چه چیزهایی از کار می‌افتند و چه پیامی خواهید دید

Docker از ایجاد app container خودداری می‌کند. Error response from daemon: conflicting options: port publishing and the container type network mode یعنی هنوز یک بلوک ports: روی سرویس متصل قرار دارد. آن را به gluetun منتقل کنید.

Compose کل فایل را نمی‌پذیرد. یک سرویس نمی‌تواند هم‌زمان network_mode و networks را تنظیم کند. شبکه‌ها را روی gluetun قرار دهید.

یک container دیگر نمی‌تواند app را resolve کند. curl: (6) Could not resolve host: qbittorrent رفتار صحیح است، چون container متصل به هیچ شبکه‌ای نپیوسته و هیچ نامی ثبت نکرده است. از gluetun و پورت استفاده کنید.

دومین container متصل شروع نمی‌شود. دو فرایند در یک namespace نمی‌توانند یک پورت یکسان را bind کنند و فرایندی که شکست می‌خورد گزارش می‌دهد که آدرس از قبل در حال استفاده است. پورت داخلی app را تغییر دهید یا یک gluetun دوم اجرا کنید.

پس از تغییر gluetun، app دیگر شبکه ندارد. راه‌اندازی مجدد یا ایجاد مجدد gluetun، اتصال همه موارد متصل به آن را قطع می‌کند. آن containerها را restart کنید.

صفحه‌های کوچک بارگذاری می‌شوند، اما صفحه‌های بزرگ متوقف می‌مانند. مشکل مربوط به MTU (maximum transmission unit) است. تونل سربار ایجاد می‌کند و بخشی از مسیر، بسته‌های بیش‌ازحد بزرگ را بدون ارسال خطا حذف می‌کند. WIREGUARD_MTU را بررسی کنید. مقدار پیش‌فرض آن در v3.41.3 برابر 1320 است. اگر مسیر به بسته‌های کوچک‌تری نیاز دارد، این مقدار را کاهش دهید. image توسعه، زمانی که این تنظیم unset باشد، از path MTU discovery استفاده می‌کند.

Gluetun هرگز healthy نمی‌شود. بررسی راه‌اندازی، مظنون‌های اصلی را مشخص می‌کند: WARN [vpn] restarting VPN because it failed to pass the healthcheck: startup check: dialing: dial tcp4: lookup cloudflare.com: i/o timeout. ابتدا بررسی کنید که key منقضی نشده باشد. سپس بررسی کنید فهرست server قدیمی نباشد. در نهایت بررسی کنید firewall میزبان، outbound UDP را مسدود نکرده باشد.

FAQ

چرا پورت‌های منتشرشده (published ports) کانتینر من پس از قرارگیری پشت Gluetun کار نمی‌کنند؟

به این دلیل که network_mode: "service:gluetun" کانتینر را درون namespace شبکهٔ gluetun قرار می‌دهد و هر namespace تنها یک آدرس IP و یک مجموعه پورت شنونده (listening ports) دارد. برنامه همچنان به گوش‌دادن ادامه می‌دهد، اما قانون انتشار (publish rule) باید روی کانتینری تعریف شود که مالک آن namespace است. لیست ports: را به سرویس gluetun منتقل کنید. اگر آن را روی سرویس متصل‌شده باقی بگذارید، Docker حتی آن را ایجاد نخواهد کرد: Error response from daemon: conflicting options: port publishing and the container type network mode.

چگونه از یک کانتینر خارج از تونل VPN به کانتینری درون آن دسترسی پیدا کنم؟

از نام سرویس gluetun و پورتی که برنامه روی آن گوش می‌دهد استفاده کنید، برای مثال gluetun:8080. کانتینر متصل‌شده هیچ شبکهٔ Docker اختصاصی ندارد، بنابراین نام خودش هرگز resolve نمی‌شود. برای ترافیک بین کانتینرها نیازی به انتشار (publishing) هیچ پورتی نیست. در جهت معکوس، یک کانتینر درون namespace می‌تواند با استفاده از نام سرویس، مانند postgres:5432، به کانتینر بیرونی دسترسی پیدا کند (در نسخه Gluetun v3.41 و جدیدتر). یک کلاینت در subnet متفاوت، مانند لپ‌تاپ شما در شبکه LAN، به یک مسیر بازگشت (return path) نیاز دارد که توسط فایروال و مسیریابی gluetun مجاز شمرده شود؛ آن subnet را به FIREWALL_OUTBOUND_SUBNETS اضافه کنید.

آیا Gluetun هنگام قطع شدن VPN به عنوان یک kill switch عمل می‌کند؟

بله، در صورتی که فایروال آن فعال باشد. کانتینر متصل‌شده از رابط‌ها (interfaces) و مسیرهای (routes) شبکهٔ Gluetun استفاده می‌کند و فایروال، ترافیک عادی اینترنت خارج از تونل را مسدود کرده و در عین حال اجازه دسترسی به endpoint سرور VPN، ترافیک محلی Docker و استثناهای پیکربندی‌شده را می‌دهد. Gluetun در این حالت VPN را به صورت داخلی restart می‌کند و لاگ WARN [vpn] restarting VPN because it failed to pass the healthcheck را ثبت می‌کند، به جای اینکه کلاً خارج شود؛ چرا که با restart شدن خودِ gluetun، تمام کانتینرهای متصل‌شده شبکه خود را از دست می‌دهند.

در یک stack مشترک، Tailscale و Gluetun کدام‌یک ترافیک خروجی را هدایت می‌کنند؟

Gluetun ترافیک خروجی عادی را هدایت می‌کند، مگر اینکه صراحتاً آن را از طریق Tailscale ارسال کنید. Tailscale به صورت پیش‌فرض فقط ترافیک بین دستگاه‌ها در tailnet شما را مسیریابی می‌کند و ترافیک عمومی را تغییر نمی‌دهد. در حالت پیش‌فرض userspace این image کانتینری، هیچ رابطی (interface) ایجاد نمی‌شود، بنابراین نمی‌تواند بر مسیریابی تأثیر بگذارد. با TS_USERSPACE=false، لینوکس معمولاً به جای یک مسیر کلی 100.64.0.0/10، مسیرهای اختصاصی IPv4 peer /32 دریافت می‌کند، به علاوه مسیرهای subnet سایر گره‌ها تنها در صورتی اضافه می‌شوند که --accept-routes را از طریق TS_EXTRA_ARGS اضافه کنید. TS_ROUTES subnetهای این کانتینر را به tailnet شما معرفی (advertise) می‌کند و هیچ مسیر محلی اضافه نمی‌کند. انتخاب یک exit node با sudo tailscale set --exit-node=<exit-node-ip>، مسیرهای پیش‌فرض را تنها در namespaceهایی نصب می‌کند که از شبکهٔ kernel-level در Tailscale استفاده می‌کنند؛ یک کانتینر مجزا مسیرهای برنامه را تغییر نمی‌دهد و حالت userspace فقط ترافیکی را حمل می‌کند که از طریق proxy آن ارسال شود. برای جلوگیری از تداخل، یکی از این دو محصول را برای مدیریت مسیر پیش‌فرض انتخاب کنید و از ترکیب هر دو خودداری نمایید.

آیا این مقاله مفید بود؟