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

اتصال به کانتینرها در شبکه Gluetun

کانتینر متصل به Gluetun فاقد رابط شبکه مستقل است. برای دسترسی، پورت‌ها را در Gluetun منتشر کنید و با تنظیم دقیق subnets، ترافیک خروجی را تنها به مسیرهای مجاز محدود کنید.

وقتی یک کانتینر به شبکه gluetun متصل می‌شود چه اتفاقی می‌افتد

کانتینری که network_mode: service:gluetun را تنظیم می‌کند، هیچ رابط شبکه مستقلی ندارد. این کانتینر به فضای نام شبکه (network namespace) متعلق به gluetun می‌پیوندد؛ بنابراین انتشار پورت‌ها و قوانین فایروال دیگر ویژگی‌های آن کانتینر نیستند، بلکه به ویژگی‌های سرویس gluetun تبدیل می‌شوند. تمام پاسخ‌های زیر از همین یک واقعیت ناشی می‌شوند.

فضای نام شبکه، کپی خصوصی هسته از یک پشته شبکه است: شامل رابط‌های اختصاصی، جدول مسیریابی، قوانین فایروال و سوکت‌های در حال گوش دادن (listening sockets) مخصوص به خود. Docker به‌صورت پیش‌فرض به هر کانتینر یکی از این فضاها را اختصاص می‌دهد. وقتی شما network_mode: service:gluetun را می‌نویسید، Docker از آن مرحله صرف‌نظر کرده و کانتینر جدید را درون فضای نامی قرار می‌دهد که gluetun از قبل مالک آن است. کانتینر سیستم فایل خود را حفظ می‌کند، اما /etc/hosts یا /etc/resolv.conf اختصاصی ندارد: Docker همان فایل‌هایی را به آن می‌دهد که gluetun استفاده می‌کند، و این موضوع در ادامه اهمیت پیدا می‌کند.

شما می‌توانید این وضعیت را مستقیماً مشاهده کنید.

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

این دستور container: و سپس شناسه کانتینر gluetun را چاپ می‌کند، در حالی که یک کانتینر معمولی bridge را چاپ می‌کرد. این راهنما از جایی ادامه می‌یابد که مسیریابی ترافیک Docker از طریق VPN با gluetun متوقف شده بود: تونل کار می‌کند، اما اکنون هیچ‌چیز نمی‌تواند با کانتینر ارتباط برقرار کند.

انتشار پورت را روی gluetun انجام دهید، نه روی برنامه

اگر یک بلوک ports: روی سرویسی باقی بگذارید که network_mode را تنظیم می‌کند، Docker از ایجاد container خودداری می‌کند:

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

دلیل آن مستقیم است. انتشار پورت به معنای افزودن یک قانون NAT (ترجمه آدرس شبکه) است که پورت میزبان را به فضای نام شبکه (network namespace) خودِ container هدایت می‌کند، در حالی که این container چنین فضایی ندارد. نگاشت پورت را به سرویس gluetun منتقل کنید. شماره پورت تغییر نمی‌کند، زیرا برنامه همچنان در همان پورت در فضای نام مشترک گوش می‌دهد.

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

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

یک بلوک expose: روی سرویس وابسته نیز به همین شکل با خطا مواجه می‌شود و conflicting options: port exposing and the container type network mode را برمی‌گرداند، و یک بلوک networks: در آنجا نیز یک توقف قطعی است: Compose گزارش می‌دهد که سرویس، مقادیر متناقض network_mode و networks را اعلام کرده است و به‌طور کلی از بارگذاری فایل خودداری می‌کند.

یک پیامد این موضوع بعداً خود را نشان می‌دهد. هر container در این فضای نام، یک فضای پورت واحد را به اشتراک می‌گذارد؛ بنابراین دو برنامه‌ای که هر دو به‌صورت پیش‌فرض از پورت 8080 استفاده می‌کنند با هم تداخل پیدا می‌کنند و دومی که شروع به کار می‌کند با خطای address already in use مواجه می‌شود. یکی از آن‌ها را در پیکربندی اختصاصی خودش تغییر دهید، برای مثال متغیر WEBUI_PORT در image مربوط به qBittorrent از LinuxServer، سپس شماره پورت جدید را روی gluetun منتشر کنید.

کانتینرهای پشت gluetun چگونه به یکدیگر دسترسی پیدا می‌کنند؟

درون فضای نام (namespace)، آن‌ها از قبل یک رابط loopback مشترک دارند. کانتینری که پشت gluetun قرار دارد، بدون درگیر کردن شبکه Docker، به همتای خود در 127.0.0.1:<port> دسترسی پیدا می‌کند.

از خارج از فضای نام، کانتینر هیچ نامی ندارد. DNS تعبیه‌شده در Docker، نام سرویس را به آدرس آن سرویس در یک شبکه تعریف‌شده توسط کاربر ترجمه می‌کند، و این کانتینر در هیچ شبکه‌ای آدرسی ندارد. بنابراین یک کانتینر معمولی مانند Sonarr به کلاینت تورنت در http://qbittorrent:8080 دسترسی پیدا نمی‌کند. بلکه به آن در http://gluetun:8080 دسترسی دارد، زیرا سوکت در فضای نام gluetun و روی آدرس gluetun در حال گوش دادن است. این موضوع برای کسانی که نحوه کارکرد شبکه‌ها و نام‌گذاری سرویس‌ها در Docker Compose را می‌دانند و انتظار دارند قواعد نام‌گذاری معمول اعمال شود، تعجب‌آور است. این کار همچنین بدون نیاز به publish کردن هیچ پورتی روی میزبان (host) انجام می‌شود، زیرا هر دو کانتینر در یک شبکه Compose قرار دارند.

پیش از عیب‌یابی هر چیز دیگری، DNS را بررسی کنید. gluetun سرور DNS اختصاصی خود را درون فضای نام اجرا می‌کند و Docker به هر کانتینر پشت gluetun، همان فایل /etc/resolv.conf را می‌دهد که gluetun دارد؛ بنابراین درخواست‌های lookup برنامه شما به جای استفاده از resolver میزبان، از طریق resolver gluetun انجام می‌شود. به‌طور پیش‌فرض، آن resolver پاسخ‌هایی که به آدرس‌های خصوصی اشاره دارند را رد می‌کند، و به همین دلیل است که نامی که روی میزبان resolve می‌شود، ممکن است درون کانتینر با شکست مواجه شود. مستندات gluetun بیان می‌کنند که چنین نام‌های میزبانی (hostnames) باید در DNS_REBINDING_PROTECTION_EXEMPT_HOSTNAMES لیست شوند.

docker exec qbittorrent cat /etc/resolv.conf

چگونه به سرویسی که روی Docker host اجرا می‌شود دسترسی پیدا کنم؟

از host.docker.internal استفاده کنید. این کار به دو تنظیم نیاز دارد که هر دو باید روی سرویس gluetun اعمال شوند، زیرا دو مشکل متفاوت وجود دارد.

نام در اولویت است. کانتینری که پشت gluetun قرار دارد، /etc/hosts مربوط به gluetun را می‌خواند و Docker ورودی extra_hosts را روی سرویسی که network_mode را با conflicting options: custom host-to-IP mapping and the network mode تنظیم کرده، رد می‌کند. بنابراین این ورودی باید در gluetun قرار گیرد تا تمام کانتینرهای موجود در آن namespace آن را ببینند.

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

host-gateway یک مقدار ویژه است که Docker آن را با آدرس داخلی خودِ host جایگزین می‌کند. در یک نصب معمولی Docker روی لینوکس، این آدرس همان bridge مربوط به docker0 است که معمولاً 172.17.0.1 می‌باشد. آدرس خود را با دستور ip -4 addr show docker0 روی VPS تأیید کنید. Docker Desktop این نام را به‌صورت خودکار resolve می‌کند، به همین دلیل است که راهنماهایی که روی لپ‌تاپ نوشته شده‌اند از خط extra_hosts صرف‌نظر می‌کنند و همان فایل روی سرور با خطا مواجه می‌شود.

مسیر (route) در اولویت دوم قرار دارد. افزودن نام فقط به کانتینر می‌گوید که از کدام آدرس استفاده کند. بسته (packet) همچنان از طریق مسیر پیش‌فرض gluetun که همان تونل است خارج می‌شود و فایروال gluetun آن را مسدود می‌کند. نشانهٔ این مشکل، اتصالی است که معلق می‌ماند و سپس timeout می‌دهد، نه اتصالی که رد (refuse) می‌شود. رد شدن به این معناست که بسته رسیده و پاسخی منفی دریافت شده است، اما timeout به این معناست که بسته هرگز به مقصد نرسیده است.

  gluetun:
    environment:
      - FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32

سپس بررسی کنید که سرویس host واقعاً روی آن آدرس در حال گوش دادن (listening) باشد. یک سرور PostgreSQL که فقط به 127.0.0.1 محدود شده است، از هیچ کانتینری که دارای network namespace اختصاصی خود باشد قابل دسترسی نیست. این شامل تمام کانتینرهای پشت gluetun (چه با تونل و چه بدون آن) می‌شود، زیرا 127.0.0.1 در داخل namespace، همان loopback خودِ آن namespace است. فقط کانتینری که از host networking استفاده می‌کند، loopback مربوط به host را به اشتراک می‌گذارد و کانتینری که پشت gluetun است، قبلاً network_mode خود را صرف gluetun کرده است. به جای آن، PostgreSQL را به 172.17.0.1 متصل (bind) کنید: این کار باعث می‌شود اتصالات کانتینرها پذیرفته شود در حالی که سرویس همچنان از رابط عمومی (public interface) دور می‌ماند. این مورد را با ss -lntp | grep 5432 روی host تأیید کنید.

تغییرات واقعی FIREWALL_OUTBOUND_SUBNETS

مستندات gluetun این متغیر را به عنوان زیرشبکه‌هایی که با کاما از هم جدا شده‌اند تعریف می‌کند که gluetun و کانتینرهای متصل به شبکه آن، اجازه دسترسی به آن‌ها را دارند. این تنظیم شامل تغییرات در فایروال و مسیریابی است و هر دو بخش اهمیت دارند. gluetun برای هر زیرشبکه ذکر شده، یک مسیر (route) از طریق gateway پل Docker اضافه می‌کند تا بسته‌های مربوط به آن آدرس‌ها به جای تونل، از طریق eth0 ارسال شوند. همچنین این تنظیم فایروال را برای آن زیرشبکه‌ها باز می‌کند، زیرا در غیر این صورت gluetun ترافیک خروجی که مقصد آن سرور VPN نباشد را مسدود می‌کند.

مقدار را بدون فاصله بعد از کاماها وارد کنید.

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

دو ویژگی وجود دارد که نادیده گرفتن آن‌ها آسان است. این یک تنظیم در سطح namespace است، بنابراین برای تمام کانتینرهای پشت gluetun اعمال می‌شود، نه فقط کانتینری که مد نظر شما بوده است. همچنین این تنظیم فقط مربوط به ترافیک خروجی است و اتصالات شروع‌شده توسط کانتینر را مدیریت می‌کند. اتصالاتی که به یک پورت منتشر شده (published port) می‌رسند، مسیر متفاوتی را طی می‌کنند و نیازی به ثبت در اینجا ندارند.

دسترسی به رابط کاربری وب از طریق یک peer در Tailscale

Tailscale به هر دستگاه یک آدرس در محدوده 100.64.0.0/10 اختصاص می‌دهد که برای NAT در سطح اپراتور رزرو شده است. این قابلیت در یک tailnet شخصی هزینه‌ای ندارد، اگرچه محدودیت شش کاربر در طرح رایگان تعیین می‌کند که آیا این وضعیت پس از نیاز سایر افراد به دسترسی به همان رابط‌های کاربری همچنان صادق است یا خیر. تعداد دستگاه‌های کاربر در تمام طرح‌ها نامحدود است. سرورها و سایر دستگاه‌های برچسب‌دار (tagged) به‌صورت جداگانه محاسبه می‌شوند: صفحه قیمت‌گذاری Tailscale شامل 50 منبع برچسب‌دار است و موارد بیشتر با هزینه 1 دلار در ماه به ازای هر کدام محاسبه می‌شوند. از آنجایی که صورت‌حساب‌ها به‌جای ماشین‌ها، کاربران را محاسبه می‌کنند، هزینه واقعی یک tailnet پولی عمدتاً به تعداد افرادی که دعوت می‌کنید بستگی دارد، نه به تعداد کانتینرهایی که در اختیار آن‌ها قرار می‌دهید. این دو جهت (ورودی و خروجی) به اقدامات متفاوتی نیاز دارند.

دسترسی ورودی ساده‌تر است. انتشار 8080:8080 روی gluetun، آن پورت را روی تمام آدرس‌های میزبان (host) متصل می‌کند و رابط tailscale0 میزبان یکی از آن‌هاست، بنابراین یک peer پورت http://<machine-name>:8080 را باز کرده و به کانتینر دسترسی پیدا می‌کند. Docker روی میزبان NAT اعمال می‌کند و فایروال gluetun اجازه ترافیک ورودی به زیرشبکه Docker خود را می‌دهد.

برای اینکه رابط کاربری فقط از طریق tailnet قابل دسترسی باشد، پورت منتشر شده را به‌جای تمام آدرس‌ها، فقط به آدرس Tailscale میزبان متصل (bind) کنید.

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

آن آدرس را با دستور tailscale ip -4 روی میزبان پیدا کنید. اتصال (Binding) در اینجا کنترل قوی‌تری نسبت به یک قانون فایروال است، زیرا پورت اصلاً روی رابط عمومی باز نمی‌شود. اگر ترجیح می‌دهید به جای استفاده از میزبان و پورت، از طریق یک نام HTTPS به رابط کاربری دسترسی داشته باشید، tailscale serve می‌تواند جلوی آن پورت منتشر شده قرار بگیرد، اگرچه تفاوت serve و funnel در این است که چه کسی در نهایت می‌تواند به آن دسترسی پیدا کند و تنها یکی از این دو، رابط کاربری را در tailnet نگه می‌دارد. این کار همچنین مشکل انتشار پورت‌های Docker مستقیماً از طریق ufw را دور می‌زند. الگوی sidecar در Tailscale برای Compose فراتر می‌رود و پورت میزبان را به‌طور کامل حذف می‌کند، اما این کار با قرار دادن برنامه در فضای نام شبکه (network namespace) سایدکار انجام می‌شود و کانتینری که پشت gluetun قرار دارد، قبلاً تنها network_mode خود را صرف gluetun کرده است.

دسترسی خروجی جایی است که FIREWALL_OUTBOUND_SUBNETS اهمیت پیدا می‌کند. اگر کانتینر باید با یک peer تماس بگیرد، آدرس آن peer را اضافه کنید و به‌جای کل /10، یک /32 به ازای هر peer را ترجیح دهید. اگر ماشینی که با آن تماس می‌گیرید در یک شبکه خصوصی قرار دارد که از طریق یک VPS که آن زیرشبکه را برای tailnet شما تبلیغ می‌کند در دسترس است، به‌جای آدرس 100.x خودِ روتر، محدوده تبلیغ‌شده را لیست کنید و تأیید کنید که میزبان، آن مسیرها را پذیرفته است. نام‌های MagicDNS به‌طور پیش‌فرض داخل کانتینر resolve نمی‌شوند، زیرا کانتینر به‌جای resolver میزبان از سرور DNS مربوط به gluetun استفاده می‌کند؛ بنابراین از آدرس عددی 100.x استفاده کنید یا نام را با یک خط extra_hosts در سرویس gluetun پین کنید. گزینه DNS_UPSTREAM_PLAIN_ADDRESSES در gluetun می‌تواند پرس‌وجوها را به یک resolver دیگر هدایت کند، اما تمام پرس‌وجوها را به‌صورت متن ساده (plaintext) ارسال می‌کند و مستندات gluetun به دلیل نشت پرس‌وجوهای مربوط به آدرس‌های خصوصی از تونل VPN، استفاده از آن را توصیه نمی‌کنند. همین موضوع در هنگام اجرای سرور کنترل Tailscale اختصاصی خود با Headscale نیز صدق می‌کند.

یک فایل compose کامل برای ساختار رایج

یک کلاینت دانلود پشت VPN، دو رابط کاربری وب که فقط روی tailnet پاسخ می‌دهند، و یک کانتینر که دیتابیس PostgreSQL در حال اجرا روی میزبان را می‌خواند.

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

به جای نام محصولات، به الگوی موجود در فایل توجه کنید. هر دو رابط کاربری روی gluetun منتشر شده و به آدرس tailnet میزبان متصل شده‌اند، بنابراین آن‌ها فقط روی Tailscale پاسخ می‌دهند و نه جای دیگر. خط extra_hosts نیز روی gluetun قرار دارد، زیرا Prowlarr هنگام حل کردن host.docker.internal، از /etc/hosts مربوط به gluetun استفاده می‌کند و Docker این خط را روی خودِ Prowlarr نمی‌پذیرد. FIREWALL_OUTBOUND_SUBNETS دو آدرس مجزا را نام می‌برد: آدرس bridge داکرِ میزبان، تا Prowlarr بتواند یک اتصال دیتابیس برقرار کند، و یک peer در tailnet.

سرور PostgreSQL عمداً در این فایل وجود ندارد. این سرور روی VPS به عنوان یک سرویس سیستمی معمولی در حال اجراست و روی 172.17.0.1:5432 گوش می‌دهد. این همان لایه‌بندی در یک پشته arr روی Docker Compose است، با این تفاوت که دیتابیس به خارج از Docker منتقل شده است.

کلید خصوصی WireGuard را خارج از فایل compose نگه دارید. ${WIREGUARD_PRIVATE_KEY} از یک فایل .env در کنار خود می‌خواند؛ الگویی که در فایل‌های env و secrets برای Docker Compose پوشش داده شده است. بند condition: service_healthy از healthcheck که ایمیج gluetun به صورت پیش‌فرض ارائه می‌دهد استفاده می‌کند، بنابراین تا زمانی که تونل وضعیت up را گزارش نکند، هیچ‌چیز شروع نمی‌شود. بررسی‌های سلامت در Compose ساختار کلی آن را توضیح می‌دهند.

انتشار روی تمام آدرس‌ها به جای فقط tailnet

پیشوند آدرس و bindهای پورت را از 0.0.0.0 حذف کنید، که شامل IP عمومی VPS نیز می‌شود. این کار را فقط پشت فایروالی که کنترل می‌کنید انجام دهید و ابتدا یادداشت ufw در بالا را مطالعه کنید.

    ports:
      - "8080:8080/tcp"

تأیید اینکه تونل همچنان ترافیک را منتقل می‌کند

درخواست یکسانی را دو بار اجرا کنید؛ یک بار از داخل namespace و یک بار از روی host، سپس نتایج را مقایسه کنید.

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

خروجی اول باید آدرس خروجی ارائه‌دهنده VPN شما را نشان دهد. خروجی دوم باید آدرس VPS را نمایش دهد. اگر این دو آدرس یکسان باشند، ترافیک کانتینر از طریق تونل عبور نمی‌کند و تا زمانی که این مشکل برطرف نشود، تمام اصلاحات این راهنما بی‌فایده خواهد بود.

قوانین مسیریابی و جداول نشان می‌دهند که چه چیزی خارج از تونل است و چه چیزی نیست.

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

در تنظیمات WireGuard این راهنما، gluetun نام رابط تونل را wg0 می‌گذارد. نام tun0 فقط پیش‌فرض OpenVPN است. همچنین gluetun مسیر پیش‌فرض تونل را خارج از جدول مسیریابی اصلی نگه می‌دارد. ip rule show باید شامل قانونی باشد که تمام ترافیک‌هایی را که توسط خود WireGuard علامت‌گذاری نشده‌اند به جدول 51820 بفرستد، و آن جدول باید یک مسیر پیش‌فرض روی wg0 داشته باشد. جدول 199 به ازای هر ورودی در FIREWALL_OUTBOUND_SUBNETS یک مسیر دارد که هر کدام به gateway پل Docker در eth0 اشاره می‌کنند و قانون آن درست پیش از قانون تونل بررسی می‌شود. یک ip route show ساده همچنان مسیر پیش‌فرض خود Docker را روی eth0 فهرست می‌کند. این مورد انتظار است و نشت (leak) محسوب نمی‌شود، زیرا هر دو قانون gluetun پیش از جدول اصلی بررسی می‌شوند. هر مسیری در جدول 199 که شما فهرست نکرده‌اید، ترافیکی است که از VPN عبور نمی‌کند.

سرور کنترل gluetun می‌تواند همان IP عمومی را روی پورت 8000 در /v1/publicip/ip گزارش دهد، اما به‌طور پیش‌فرض تنها پس از تنظیم احراز هویت. مستندات gluetun بیان می‌کنند که تمام مسیرهای سرور کنترل اکنون به‌طور پیش‌فرض خصوصی هستند، بنابراین یک درخواست ساده به آن مسیر با خطا مواجه می‌شود. آن را با یک فایل احراز هویت که در /gluetun/auth/config.toml با استفاده از روش basic یا apikey bind mount شده است پیکربندی کنید، سپس gluetun را restart کنید. فایل compose بالا قبلاً ./gluetun را در /gluetun mount کرده است، بنابراین فایل باید در ./gluetun/auth/config.toml روی host قرار گیرد. متغیر HTTP_CONTROL_SERVER_AUTH_DEFAULT_ROLE سریع‌ترین راه است. تنظیم آن روی {"auth":"none"} احراز هویت را به‌طور کامل غیرفعال می‌کند که مستندات آن را به‌شدت توصیه نمی‌کنند. در نسخه‌های پیش از v3.39.1، سرور به این شکل قفل نشده است و مستندات هشدار می‌دهند که به هر چیزی که می‌تواند به آن دسترسی داشته باشد اعتماد نکنید.

نشتی که یک زیرشبکه اشتباه ایجاد می‌کند

FIREWALL_OUTBOUND_SUBNETS حفره‌ای است که شما عمداً در فایروال ایجاد می‌کنید، بنابراین اندازه حفره برابر با اندازه ریسک است. چهار اشتباهی که باید از آن‌ها اجتناب کرد:

  • 0.0.0.0/0 در اعتبارسنجی پیکربندی با outbound subnet has an unspecified address: 0.0.0.0/0 شکست می‌خورد. gluetun به‌جای مسیریابی همه چیز به خارج از تونل، آن را رد می‌کند.
  • محدوده‌ای وسیع‌تر از هدف. باز کردن 10.0.0.0/8 برای دسترسی به یک ماشین در 10.0.1.7، همچنین تمام آدرس‌هایی را که یک peer تورنت ممکن است در آن محدوده تبلیغ کند، باز می‌کند. از 10.0.1.7/32 استفاده کنید.
  • محدوده‌ای که با آدرس‌های خودِ تونل همپوشانی دارد. مستندات gluetun هشدار می‌دهند که این کار باعث می‌شود gluetun ترافیک VPN را از طریق bridge به بیرون بفرستد که باعث اختلال در port forwarding می‌شود. قبل از باز کردن هر محدوده خصوصی، مقدار WIREGUARD_ADDRESSES خود را بررسی کنید.
  • 100.64.0.0/10 برای Tailscale. این تقریباً چهار میلیون آدرس است که باز می‌شوند تا بتوان به یک peer دسترسی پیدا کرد. peerهایی که نیاز دارید را به‌عنوان ورودی‌های /32 لیست کنید.

به یاد داشته باشید که این تنظیمات کل فضای نام را پوشش می‌دهد. باز کردن یک زیرشبکه برای اینکه یک ایندکسر بتواند به یک سرویس میزبان دسترسی پیدا کند، همان زیرشبکه را برای کلاینت تورنتی که از آن فضای نام استفاده می‌کند نیز باز می‌کند. پس از هر تغییر در این متغیر، بررسی IP عمومی را دوباره انجام دهید، زیرا این تنها آزمایشی است که نشان می‌دهد آیا تغییر انجام‌شده همان چیزی بوده که مد نظر شما بوده است یا خیر.

چه چیزی هنگام راه‌اندازی مجدد gluetun دچار اختلال می‌شود

مدیریت namespace بر عهده gluetun است، بنابراین چرخه حیات namespace به چرخه حیات gluetun وابسته است. شروع یک container وابسته در حالی که gluetun خاموش است، بلافاصله با شکست مواجه می‌شود:

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

راه‌اندازی مجدد gluetun در جای خود، نوعی شکست بی‌سروصدا است. containerهای وابسته به کار خود ادامه می‌دهند در حالی که namespaceای که به آن متصل بودند در زیر آن‌ها بازسازی می‌شود؛ بنابراین docker ps وضعیت را سالم گزارش می‌کند اما هیچ پاسخی دریافت نمی‌شود. پس از هر تغییری در سرویس gluetun، به‌جای راه‌اندازی مجدد یک بخش، کل گروه را بازسازی کنید.

docker compose up -d --force-recreate

همین موضوع در مورد به‌روزرسانی imageها نیز صدق می‌کند. دریافت (pull) یک image جدید برای gluetun و بازسازی تنها همان سرویس، باعث می‌شود سایر سرویس‌ها به namespaceای اشاره کنند که دیگر وجود ندارد.

FAQ

چرا Docker خطای "port publishing and the container type network mode" را نمایش می‌دهد؟

به این دلیل که یک بلوک ports: روی سرویسی قرار دارد که network_mode: service:gluetun را نیز تنظیم کرده است. انتشار (publishing) یک پورت، یک قانون NAT اضافه می‌کند که پورت میزبان را به فضای نام شبکه (network namespace) کانتینر هدایت می‌کند، در حالی که کانتینر در این حالت چنین فضایی ندارد. بلوک ports: را از آن سرویس حذف کنید و نگاشت (mapping) مشابه را به سرویس gluetun اضافه کنید. شماره پورت ثابت می‌ماند، زیرا برنامه همچنان در همان فضای نام اشتراکی روی آن پورت گوش می‌دهد.

سایر کانتینرها چگونه به سرویسی که پشت gluetun قرار دارد دسترسی پیدا می‌کنند؟

کانتینرهایی که در یک فضای نام هستند، یکدیگر را در 127.0.0.1 می‌بینند. کانتینرهای خارج از آن از نام سرویس gluetun استفاده می‌کنند، بنابراین http://gluetun:8080 کار می‌کند در حالی که http://qbittorrent:8080 کار نمی‌کند. کانتینر برنامه هیچ آدرسی در هیچ شبکه Docker ندارد، بنابراین سرور DNS داخلی چیزی برای حل کردن (resolve) برای نام آن ندارد. تا زمانی که هر دو کانتینر در یک شبکه Compose مشترک باشند، نیازی به انتشار پورت برای این کار نیست.

در FIREWALL_OUTBOUND_SUBNETS چه چیزی باید قرار دهم؟

فقط آدرس‌هایی که کانتینر پشت gluetun باید اتصال به آن‌ها را آغاز کند، و باید تا حد امکان دقیق نوشته شوند. یک ماشین واحد یک /32 است. دو ورودی رایج، میزبان Docker در 172.17.0.1/32 و یک /32 برای هر همتای Tailscale است که با آن تماس می‌گیرید. هرگز 0.0.0.0/0 را اضافه نکنید و هرگز محدوده‌ای که با آدرس‌های تونل VPN شما همپوشانی دارد را وارد نکنید. اتصالات ورودی به یک پورت منتشر شده، نیازی به ورودی در اینجا ندارند.

چرا کانتینر نمی‌تواند نام‌های Tailscale MagicDNS من را حل کند؟

MagicDNS با اشاره کردن resolver میزبان به سرور DNS شرکت Tailscale کار می‌کند، و کانتینر از resolver میزبان استفاده نمی‌کند. کانتینر از /etc/resolv.conf که با gluetun به اشتراک گذاشته استفاده می‌کند، که به سرور DNS خودِ gluetun اشاره دارد. این موضوع را با docker exec <container> cat /etc/resolv.conf تأیید کنید. از آدرس عددی 100.x همتا استفاده کنید، یا نام را با یک ورودی extra_hosts روی سرویس gluetun ثابت کنید. Gluetun می‌تواند پرس‌وجوها را با DNS_UPSTREAM_PLAIN_ADDRESSES به یک resolver دیگر هدایت کند، اما این کار آن‌ها را به صورت متن ساده (plaintext) ارسال می‌کند و مستندات آن توصیه می‌کنند این کار را انجام ندهید.

چگونه تأیید کنم که ترافیک همچنان از طریق VPN عبور می‌کند؟

یک درخواست از داخل فضای نام و همان درخواست را از میزبان اجرا کنید، سپس پاسخ‌ها را مقایسه کنید. docker run --rm --network=container:gluetun curlimages/curl:latest -s https://api.ipify.org باید آدرس خروجی ارائه‌دهنده VPN شما را برگرداند، در حالی که curl -s https://api.ipify.org روی VPS باید آدرس همان VPS را برگرداند. اگر دو پاسخ یکسان باشند، به این معنی است که تونل، ترافیک کانتینر را حمل نمی‌کند. این بررسی را پس از هر تغییر در FIREWALL_OUTBOUND_SUBNETS دوباره انجام دهید.

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