كيف تصل حاوية Gluetun إلى المضيف والحاويات؟
تعرّف إلى سبب ظهور خطأ نشر المنافذ مع network_mode: service:gluetun، وكيف تنشر المنافذ على Gluetun وتسمح فقط بالشبكات المطلوبة خارج النفق.
ما الذي يحدث عندما تنضم حاوية إلى شبكة gluetun
لا تملك الحاوية التي تضبط network_mode: service:gluetun واجهات شبكة خاصة بها. فهي تنضم إلى مساحة أسماء الشبكة الخاصة بـgluetun، ولذلك لا يعود نشر المنافذ وقواعد الجدار الناري خصائص لهذه الحاوية، بل تصبح خصائص لخدمة gluetun. تستند كل الإجابات أدناه إلى هذه الحقيقة وحدها.
مساحة أسماء الشبكة هي نسخة خاصة من مكدس الشبكة داخل النواة: لها واجهاتها الخاصة، وجدول التوجيه الخاص بها، وقواعد الجدار الناري الخاصة بها، ومقابس الاستماع الخاصة بها. يمنح 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 إنشاء الحاوية:
Error response from daemon: conflicting options: port publishing and the container type network modeالسبب مباشر. نشر منفذ يعني إضافة قاعدة NAT (ترجمة عناوين الشبكة) تعيد توجيه منفذ من المضيف إلى مساحة أسماء الشبكة الخاصة بالحاوية. لكن هذه الحاوية لا تملك مساحة أسماء خاصة بها. انقل الربط إلى خدمة 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 المتعارضين، ويرفض تحميل الملف بالكامل.
تظهر نتيجة أخرى لاحقاً. تشترك كل حاويات مساحة أسماء الشبكة في مساحة منافذ واحدة. لذلك يحدث تعارض إذا استخدم تطبيقان المنفذ الافتراضي 8080، ويفشل التطبيق الثاني الذي يبدأ برسالة تفيد بأن العنوان قيد الاستخدام. غيّر أحد المنفذين في إعدادات التطبيق نفسه، مثل متغير WEBUI_PORT في صورة LinuxServer qBittorrent، ثم انشر الرقم الجديد على gluetun.
كيف تصل الحاويات خلف gluetun إلى بعضها؟
تشترك الحاويات داخل مساحة أسماء gluetun في واجهة loopback نفسها. تصل الحاوية الموجودة خلف gluetun إلى الحاوية الشقيقة على 127.0.0.1:<port> من دون استخدام أي Docker network.
من خارج مساحة الأسماء، لا يكون للحاوية اسم. يحل DNS المضمّن في Docker اسم الخدمة إلى عنوان تلك الخدمة على شبكة يعرّفها المستخدم، لكن هذه الحاوية لا تملك عنواناً على أي شبكة. لذلك لا تصل حاوية عادية مثل Sonarr إلى عميل التورنت على http://qbittorrent:8080. بل تصل إليه على http://gluetun:8080، لأن الـsocket يستمع في مساحة أسماء gluetun وعلى عنوان gluetun. يفاجئ ذلك من يعرفون طريقة عمل شبكات Docker Compose وأسماء الخدمات ويتوقعون تطبيق التسمية المعتاد. ويعمل ذلك أيضاً من دون نشر أي منفذ إلى المضيف، لأن الحاويتين موجودتان على شبكة Compose نفسها.
تحقق من DNS قبل تصحيح أي مشكلة أخرى. يشغّل Gluetun خادم DNS خاصاً به داخل مساحة الأسماء، ويمنح Docker كل حاوية خلف gluetun ملف /etc/resolv.conf نفسه الموجود لدى gluetun، لذلك تمر عمليات البحث التي تجريها تطبيقاتك عبر محلل gluetun بدلاً من محلل المضيف. ويرفض هذا المحلل، افتراضياً، الإجابات التي تشير إلى عناوين خاصة، ولذلك قد يفشل اسم يُحل على المضيف داخل الحاوية. توضح وثائق gluetun ضرورة إدراج أسماء المضيفين هذه في DNS_REBINDING_PROTECTION_EXEMPT_HOSTNAMES.
docker exec qbittorrent cat /etc/resolv.confكيف أصل إلى خدمة تعمل على مضيف Docker؟
استخدم host.docker.internal. يتطلب ذلك إعدادين، وكلاهما في خدمة gluetun، لأن هناك مشكلتين مختلفتين.
يأتي الاسم أولاً. تقرأ الحاوية الموجودة خلف gluetun ملف gluetun /etc/hosts، ويرفض Docker إدخال extra_hosts في خدمة تضبط network_mode باستخدام conflicting options: custom host-to-IP mapping and the network mode. لذلك يجب أن يكون الإدخال في gluetun، وستراه كل حاوية في مساحة الأسماء نفسها.
gluetun:
extra_hosts:
- "host.docker.internal:host-gateway"host-gateway قيمة خاصة يستبدلها Docker بعنوان داخلي للمضيف نفسه. في تثبيت Docker عادي على Linux، يكون هذا عنوان جسر docker0، وغالباً ما يكون 172.17.0.1. تحقّق من القيمة لديك باستخدام ip -4 addr show docker0 على VPS. يحل Docker Desktop هذا الاسم تلقائياً، ولذلك تتجاوز الأدلة المكتوبة لحاسوب محمول سطر extra_hosts، ثم يفشل الملف نفسه على الخادم.
يأتي المسار ثانياً. إضافة الاسم تحدد فقط العنوان الذي تستخدمه الحاوية. تظل الحزمة تخرج عبر المسار الافتراضي لـ gluetun، وهو النفق، ثم يحظرها جدار gluetun الناري. يتمثل العَرَض في اتصال يظل معلقاً ثم تنتهي مهلته، وليس في اتصال مرفوض. الرفض يعني أن الحزمة وصلت وأن شيئاً ما رد بالرفض. أما انتهاء المهلة فيعني أنها لم تصل.
gluetun:
environment:
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32تحقّق بعد ذلك من أن خدمة المضيف تستمع فعلاً على ذلك العنوان. لا يمكن الوصول إلى خادم PostgreSQL المرتبط فقط بـ 127.0.0.1 من أي حاوية لديها مساحة أسماء شبكية خاصة بها، ويشمل ذلك كل حاوية خلف gluetun، سواء استُخدم النفق أم لا، لأن 127.0.0.1 داخل مساحة الأسماء هو loopback الخاص بمساحة الأسماء نفسها. الحاوية التي تستخدم شبكة المضيف فقط تشارك loopback الخاص بالمضيف، بينما تكون الحاوية الموجودة خلف gluetun قد استهلكت network_mode الخاص بها في gluetun. اربط PostgreSQL بـ 172.17.0.1 بدلاً من ذلك؛ فهو يقبل الاتصالات من الحاويات مع بقائه غير متاح على الواجهة العامة. تحقّق من ذلك باستخدام ss -lntp | grep 5432 على المضيف.
ما الذي يغيّره FIREWALL_OUTBOUND_SUBNETS فعلياً
تصف وثائق gluetun هذه القيمة بأنها الشبكات الفرعية المفصولة بفواصل التي يُسمح لـgluetun والحاويات التي تشارك مكدس الشبكة الخاص به بالوصول إليها، وتوضح أنها تتضمن تغييرات على جدار الحماية والتوجيه. كلا الجانبين مهم. يضيف gluetun مساراً لكل شبكة فرعية مدرجة عبر بوابة Docker bridge، لذلك تخرج الحزم المتجهة إلى تلك العناوين عبر eth0 بدلاً من النفق. كما يفتح جدار الحماية أمامها، لأن gluetun يسقط بخلاف ذلك حركة المرور الصادرة التي لا تتجه إلى خادم VPN.
اكتب القيمة من دون مسافات بعد الفواصل.
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32,192.168.1.0/24,100.64.7.9/32من السهل إغفال خاصيتين. هذا الإعداد على مستوى مساحة الأسماء، لذلك ينطبق على كل حاوية خلف gluetun، وليس على الحاوية التي تقصدها وحدها. وهو يخص الاتصالات الصادرة فقط: إذ يتحكم في الاتصالات التي تبدأها الحاوية. أما الاتصالات الواردة إلى منفذ منشور فتسلك مساراً مختلفاً، ولا تحتاج إلى إدراجها هنا.
الوصول إلى واجهة الويب من نظير Tailscale
يمنح Tailscale كل جهاز عنواناً ضمن 100.64.0.0/10، وهو النطاق المحجوز لـNAT على مستوى مزود الخدمة. لا تترتب أي تكلفة على ذلك في tailnet شخصي، مع أنّ حد الخطة المجانية البالغ ستة مستخدمين يحدد ما إذا كان ذلك سيظل صحيحاً عندما يحتاج أشخاص آخرون إلى الوصول إلى واجهات الويب نفسها. أما أجهزة المستخدمين فغير محدودة في جميع الخطط. وتُحتسب الخوادم والأجهزة الأخرى التي تحمل وسوماً بشكل منفصل: تعرض صفحة أسعار Tailscale تضمين 50 مورداً موسوماً، مع احتساب $1 شهرياً لكل مورد إضافي. وبما أنّ الفوترة تحتسب المستخدمين لا الأجهزة، فإن التكلفة الفعلية لـtailnet مدفوعة تعتمد أساساً على عدد الأشخاص الذين تدعوهم، لا على عدد الحاويات التي تتيحها لهم. ويتطلب الاتجاهان إعداداً مختلفاً.
الوصول الوارد هو الأبسط. يؤدي نشر 8080:8080 على gluetun إلى ربط ذلك المنفذ بجميع عناوين المضيف، ويُعدَّت واجهة tailscale0 للمضيف أحدها، لذلك يفتح النظير http://<machine-name>:8080 ويصل إلى الحاوية. يطبّق Docker NAT على المضيف، ويسمح جدار gluetun الناري بحركة المرور الواردة إلى شبكة Docker الفرعية الخاصة به.
لجعل واجهة الويب قابلة للوصول عبر tailnet فقط، اربط المنفذ المنشور بعنوان Tailscale الخاص بالمضيف بدلاً من ربطه بجميع العناوين.
ports:
- "100.101.102.103:8080:8080/tcp"اعثر على ذلك العنوان باستخدام tailscale ip -4 على المضيف. يُعدّ الربط هنا وسيلة تحكم أقوى من قاعدة جدار ناري، لأن المنفذ لا يُفتح على الواجهة العامة أصلاً. إذا كنت تفضّل الوصول إلى واجهة الويب باستخدام اسم HTTPS بدلاً من المضيف والمنفذ، فيمكن لـtailscale serve أن يعمل كواجهة أمامية لذلك المنفذ المنشور، مع أنّ serve وfunnel يختلفان في الجهة التي يمكنها الوصول إليه، وواحداً منهما فقط يُبقي واجهة الويب ضمن tailnet. كما يتجنب ذلك المشكلة الموضحة في نشر Docker للمنافذ متجاوزاً ufw مباشرة. يذهب نمط Tailscale sidecar في Compose إلى أبعد من ذلك ويلغي منفذ المضيف تماماً، لكنه يعمل عبر وضع التطبيق في مساحة أسماء الشبكة الخاصة بـsidecar، وقد استهلكت حاوية تعمل خلف gluetun بالفعل قيمة network_mode الوحيدة على gluetun.
هنا تظهر مشكلة الوصول الصادر، إذ تعود FIREWALL_OUTBOUND_SUBNETS. إذا احتاجت حاوية إلى الاتصال بنظير، فأضف عنوان ذلك النظير، وفضّل استخدام /32 لكل نظير بدلاً من استخدام /10 بالكامل. إذا كان الجهاز الذي تتصل به موجوداً على شبكة خاصة يمكن الوصول إليها عبر VPS يعلن تلك الشبكة الفرعية لـtailnet الخاص بك، فأدرج النطاق المعلن بدلاً من عنوان 100.x الخاص بالموجّه، وتأكد من أنّ المضيف نفسه قبل تلك المسارات. لا تُحل أسماء MagicDNS داخل الحاوية افتراضياً، لأن الحاوية تستخدم خادم DNS الخاص بـgluetun بدلاً من محلل الأسماء في المضيف. لذلك استخدم عنوان 100.x الرقمي، أو ثبّت الاسم باستخدام سطر extra_hosts في خدمة gluetun. يمكن لخيار DNS_UPSTREAM_PLAIN_ADDRESSES في gluetun إعادة توجيه الاستعلامات إلى محلل أسماء آخر، لكنه يرسل كل استعلام بنص واضح، وتوصي وثائق 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 يقرأ /etc/hosts الخاص بـgluetun عند حل host.docker.internal، ولأن Docker سيرفض هذا السطر إذا وُضع على Prowlarr نفسه. يحدّد FIREWALL_OUTBOUND_SUBNETS عنوانين منفردين: عنوان جسر Docker الخاص بالمضيف، حتى يتمكن Prowlarr من فتح اتصال بقاعدة البيانات، وعنوان أحد أقران tailnet.
يغيب خادم PostgreSQL عن الملف عمداً. فهو يعمل على VPS كخدمة نظام عادية وتستمع الخدمة على 172.17.0.1:5432. هذه هي الطبقات نفسها المستخدمة في حزمة arr على Docker Compose، مع نقل قاعدة البيانات إلى خارج Docker.
أبقِ المفتاح الخاص بـWireGuard خارج ملف Compose. يقرأ ${WIREGUARD_PRIVATE_KEY} من ملف .env بجانبه، وفق النمط المشروح في ملفات البيئة والأسرار في Docker Compose. يستخدم شرط condition: service_healthy healthcheck الذي تتضمنه صورة gluetun أصلاً، لذلك لا يبدأ أي شيء حتى يعلن النفق أنه يعمل. يشرح فحص الحالة في Compose الصيغة العامة.
النشر على كل عنوان بدلاً من tailnet فقط
احذف بادئة العنوان وربط المنفذ على 0.0.0.0، الذي يتضمن عنوان VPS العام. نفّذ ذلك فقط خلف جدار ناري تتحكم فيه، واقرأ ملاحظة ufw أعلاه أولاً.
ports:
- "8080:8080/tcp"تحقّق من استمرار تمرير النفق لحركة الشبكة
نفّذ الطلب نفسه مرتين، مرة من داخل مساحة الأسماء ومرة من المضيف، ثم قارن النتيجتين.
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، ويشير كل مسار إلى بوابة جسر Docker على eth0، وتُفحص قاعدته قبل قاعدة النفق مباشرة. يعرض ip route show العادي مسار Docker الافتراضي الخاص به على eth0. هذا متوقع ولا يُعد تسرّباً، لأن قاعدتي gluetun تُفحصان قبل الجدول الرئيسي. وأي مسار في الجدول 199 لم تُدرجه هو حركة شبكة تتجاوز VPN.
يمكن لخادم التحكم في Gluetun عرض عنوان IP العام نفسه على المنفذ 8000، في /v1/publicip/ip، ولكن بعد إعداد المصادقة فقط وفق الإعداد الافتراضي. توضّح وثائق gluetun أن جميع مسارات خادم التحكم أصبحت خاصة افتراضياً، ولذلك يفشل الطلب العادي إلى ذلك المسار. اضبطه باستخدام ملف مصادقة مربوط داخل الحاوية في /gluetun/auth/config.toml، باستخدام طريقة basic أو apikey، ثم أعد تشغيل gluetun. يربط ملف compose أعلاه ./gluetun في /gluetun، ولذلك يجب وضع الملف في ./gluetun/auth/config.toml على المضيف. ويُعد المتغير 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إلى فتح كل عنوان قد يعلنه نظير torrent ضمن ذلك النطاق. اكتب10.0.1.7/32. - استخدام نطاق يتداخل مع عناوين النفق نفسه. تحذر وثائق gluetun من أنّ ذلك يجعله يرسل حركة VPN عبر الجسر بدلاً من ذلك، مما يعطل إعادة توجيه المنافذ. افحص قيمة
WIREGUARD_ADDRESSESقبل فتح أي نطاق خاص. - استخدام
100.64.0.0/10لـTailscale. يؤدي ذلك تقريباً إلى فتح أربعة ملايين عنوان كي يمكن الوصول إلى نظير واحد. أدرج النظائر التي تحتاج إليها كإدخالات/32.
تذكر أنّ هذا الإعداد يغطي مساحة الأسماء بأكملها. يؤدي فتح شبكة فرعية كي يتمكن مفهرس من الوصول إلى خدمة على المضيف إلى فتح الشبكة الفرعية نفسها لعميل torrent الذي يشارك مساحة الأسماء تلك. أعد فحص عنوان IP العام بعد كل تغيير في هذا المتغير، لأن هذا هو الاختبار الوحيد الذي يوضح ما إذا كان التغيير قد حقق الغرض المقصود.
ما الذي يتعطل عند إعادة تشغيل gluetun
يمتلك gluetun مساحة الأسماء، لذلك ترتبط دورة حياة gluetun بدورة حياة مساحة الأسماء. يفشل تشغيل حاوية تعتمد عليه فوراً عندما تكون gluetun متوقفة:
Error response from daemon: cannot join network namespace of a non running container: container <id> is exitedتُعد إعادة تشغيل gluetun في موضعها الحالة الأكثر صعوبة في الملاحظة. تواصل الحاويات التابعة عملها بينما يُعاد إنشاء مساحة الأسماء التي اتصلت بها من تحتها، لذلك يبلّغ docker ps بأن كل شيء سليم، ولا يستجيب أي شيء. بعد إجراء أي تغيير على خدمة gluetun، أعد إنشاء المجموعة بأكملها بدلاً من إعادة تشغيل جزء واحد منها.
docker compose up -d --force-recreateينطبق الأمر نفسه على تحديثات الصور. يؤدي سحب صورة gluetun جديدة وإعادة إنشاء هذه الخدمة وحدها إلى ترك الخدمات الأخرى متصلة بمساحة أسماء لم تعد موجودة.
FAQ
لماذا يعرض Docker الرسالة "port publishing and the container type network mode"؟
لأن كتلة ports: لا تزال موجودة في خدمة تضبط أيضاً network_mode: service:gluetun. يؤدي نشر منفذ إلى إضافة قاعدة NAT تعيد توجيه منفذ على المضيف إلى مساحة أسماء الشبكة الخاصة بالحاوية، لكن الحاوية التي تستخدم هذا الوضع لا تملك مساحة أسماء خاصة بها. احذف كتلة ports: من تلك الخدمة، وأضف التعيين نفسه إلى خدمة gluetun. يبقى رقم المنفذ كما هو، لأن التطبيق لا يزال يستمع عليه داخل مساحة أسماء الشبكة المشتركة.
كيف تصل الحاويات الأخرى إلى خدمة تعمل خلف gluetun؟
تصل الحاويات الموجودة داخل مساحة الأسماء نفسها إلى بعضها عبر 127.0.0.1. أما الحاويات الموجودة خارجها، فتستخدم اسم خدمة gluetun، ولذلك يعمل http://gluetun:8080 بينما لا يعمل http://qbittorrent:8080. لا تملك حاوية التطبيق عنواناً على أي شبكة Docker، لذلك لا يملك خادم DNS المضمّن شيئاً يحلّه لاسمها. لا تحتاج هذه الحالة إلى نشر منفذ، ما دام كلا الحاويتين يشتركان في شبكة Compose.
ماذا أضع في FIREWALL_OUTBOUND_SUBNETS؟
أضف فقط العناوين التي يجب على حاوية تعمل خلف gluetun بدء اتصال بها، واكتبها بأضيق نطاق ممكن. يُمثَّل جهاز واحد بـ /32. الإدخالان الشائعان هما مضيف Docker على 172.17.0.1/32، وإدخال /32 واحد لكل نظير Tailscale تتصل به. لا تضف 0.0.0.0/0 مطلقاً، ولا تضف نطاقاً يتداخل مع عناوين النفق الخاصة بشبكة VPN. لا تحتاج الاتصالات الواردة إلى منفذ منشور إلى إدخال هنا.
لماذا لا تستطيع الحاوية حل أسماء MagicDNS الخاصة بـTailscale؟
يعمل MagicDNS عبر توجيه محلل الأسماء في المضيف إلى خادم DNS الخاص بـTailscale، لكن الحاوية لا تستخدم محلل الأسماء في المضيف. بل تستخدم /etc/resolv.conf الذي تشاركه مع gluetun، وهذا المحلل يشير إلى خادم DNS الخاص بـgluetun. تحقّق من ذلك باستخدام docker exec <container> cat /etc/resolv.conf. استخدم العنوان الرقمي 100.x للنظير، أو ثبّت الاسم بإضافة extra_hosts إلى خدمة gluetun. يستطيع Gluetun إعادة توجيه الاستعلامات إلى محلل آخر باستخدام DNS_UPSTREAM_PLAIN_ADDRESSES، لكن ذلك يرسلها بنص واضح، وتوصي وثائقه بعدم استخدامه.
كيف أتأكد من أن حركة الشبكة لا تزال تمر عبر 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.