🔒 تثبيت Gluetun — توجيه أي حاوية عبر VPN

انشر Gluetun على Ubuntu بـ Docker — حاوية عميل VPN خفيفة تتصل بمزود VPN التجاري الخاص بك وتتيح لك توجيه حركة مرور أي حاوية أخرى عبر النفق، مع واجهة تحكم API على المنفذ 8223.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — ينشر Gluetun كعميل VPN. اضبط مزودك وبيانات الاعتماد، ثم وجّه حاويات أخرى إليه باستخدام network_mode: container:gluetun لتوجيه حركة مرورها عبر VPN.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/vpn/gluetun/gluetun-ubuntu.sh
chmod +x gluetun-ubuntu.sh
sudo bash gluetun-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/vpn/gluetun/gluetun-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x gluetun-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم الأمر، ثم يشغّل Gluetun مع صلاحية NET_ADMIN وجهاز tun اللازمين لبناء نفق VPN. تزوّده ببيانات مزود VPN واعتماد OpenVPN عبر متغيرات البيئة؛ وتستمع واجهة التحكم API على المنفذ 8223.

sudo bash gluetun-ubuntu.sh

4 التحقق من النفق وتوجيه حاوية

راجع السجلات للتأكد من اتصال VPN ورؤية IP العام، ثم وجّه حاوية أخرى إلى Gluetun باستخدام network_mode حتى تمر حركة مرورها عبر النفق:

docker logs gluetun | grep -i "public ip"

المنافذ المستخدمة

المنفذالغرض
8223Control API (host → container 8000) — status and public IP
NET_ADMIN + tunRequired to build the VPN tunnel — grant only here
network_modeRoute others with container:gluetun; publish their ports on Gluetun
kill switchBlocks traffic if the tunnel drops — no IP leak

نظرة عامة

Gluetun هو عميل VPN خفيف ومفتوح المصدر مُعبّأ كحاوية Docker واحدة. يتصل خارجياً بأكثر من 30 مزود VPN تجاري — بما فيها NordVPN وMullvad وProtonVPN وSurfshark وPrivate Internet Access والعديد غيرها — باستخدام OpenVPN أو WireGuard، ويظهر كبوابة شبكة يمكن لأي حاوية أخرى توجيه حركة مرورها عبرها. بدلاً من تثبيت عميل VPN داخل كل حاوية تطبيق تريد حمايتها، تشغّل Gluetun مرة واحدة وتربط الحاويات الأخرى بمكدس شبكته، بحيث تخرج كل حركة مرورها عبر النفق المشفّر. مفتاح إيقاف تلقائي (kill switch) مدمج يحظر كل حركة المرور فور انقطاع النفق، حتى لا يعود اتصال VPN المفقود بصمت إلى IP الحقيقي أبداً.

لماذا تستخدمه

إعداد عميل VPN داخل كل حاوية تريد حمايتها عملية متكررة وعرضة للأخطاء، وأغلب صور التطبيقات لا تدعمها أصلاً. يحل Gluetun هذا مرة واحدة: انشره كحاوية مخصصة واحدة، أعطه بيانات اعتماد مزود VPN، ووجّه أي عدد تريده من الحاويات الأخرى عبره باستخدام network_mode: container:gluetun. هذا هو الأسلوب المعتمد لزواحف الويب وعملاء API وأدوات المراقبة، وأي خدمة تريد عزل حركة مرورها عن IP الحقيقي دون لمس حاوية التطبيق نفسها. مفتاح الإيقاف التلقائي المدمج يعني أن انقطاع اتصال VPN يحظر حركة المرور بدلاً من كشف عنوانك الحقيقي بصمت، وهذا هو الضمان الذي يجعل Gluetun جديراً بالثقة للأعمال الحساسة للخصوصية.

متى تحتاجه

  • تُشغّل زاحف ويب أو عميل API أو خدمة اتصال صادر وتريد توجيه حركة مروره عبر VPN دون تثبيت عميل VPN داخل تلك الحاوية
  • تحتاج مفتاح إيقاف تلقائي يحظر حركة المرور بالكامل إذا انقطع نفق VPN، بدلاً من العودة بصمت إلى IP الحقيقي
  • تريد توجيه عدة حاويات عبر نفس اتصال VPN بدلاً من إعداد كل واحدة على حدة
  • تستخدم مزود VPN تجاري (NordVPN وMullvad وProtonVPN وSurfshark وعشرات غيرهم) وتريد إتاحته كبنية تحتية تشاركها الحاويات الأخرى
  • تحتاج كشف منفذ حاوية معينة عبر ميزة توجيه المنافذ الخاصة بمزود VPN للاتصالات الواردة
  • تريد بوابة VPN خفيفة ومخصصة بدلاً من تشغيل عميل VPN كامل وإعداد جدار ناري على المضيف نفسه

من يحتاجه

  • مستخدمو المختبرات المنزلية الذين يريدون أن تصل حاويات محددة إلى الإنترنت عبر VPN فقط مع مفتاح إيقاف تلقائي
  • المستخدمون المهتمون بالخصوصية الذين يريدون عزل حاويات معينة عن IP الحقيقي دون لمس شبكة المضيف
  • المستضيفون الذاتيون الذين يشغّلون حزم أتمتة *arr (Sonarr، Radarr، Prowlarr) ويحتاجون توجيه حركة مرور عميل التنزيل عبر VPN
  • مهندسو DevOps الذين يحتاجون حاوية بوابة VPN قابلة لإعادة الاستخدام تلتحق بها خدمات أخرى عبر network_mode
  • مستخدمو مزودي VPN المركّزين على الخصوصية مثل Mullvad أو ProtonVPN الذين يريدون اشتراكهم يحمي أعمال Docker معينة
  • أي شخص يريد ضمان مفتاح إيقاف تلقائي بألا تتسرب حركة المرور إلى IP الحقيقي أبداً إذا انقطع اتصال VPN
  • مشغلو المختبرات المنزلية الذين يحتاجون توجيه منافذ واردة عبر مزود VPN لخدمة ذاتية الاستضافة معينة

حالات الاستخدام الشائعة

  • توجيه حركة مرور زاحف ويب عبر VPN بحيث ترى المواقع المستهدفة IP مزود VPN وليس IP منزلك
  • وضع عدة خدمات ذات اتصال صادر خلف حاوية بوابة VPN واحدة مشتركة بمفتاح إيقاف واحد
  • تشغيل زاحف ويب أو أداة أتمتة عبر VPN لتجنب تحديد المعدل القائم على IP أو القيود الجغرافية
  • بناء مساحة شبكة محمية بمفتاح إيقاف تلقائي تلتحق بها حاويات أخرى، مما يضمن عدم تسرب حركة المرور إذا انقطع النفق
  • اختبار كيفية تصرف خدمة عند الوصول إليها من بلد مختلف بتبديل موقع سيرفر VPN في Gluetun
  • كشف واجهة ويب حاوية عبر توجيه منافذ مزود VPN للوصول عن بُعد المتحكم به

الميزات الرئيسية

  • دعم أكثر من 30 مزود VPN تجاري بما فيها NordVPN وMullvad وProtonVPN وSurfshark وPrivate Internet Access وExpressVPN وWindscribe
  • دعم بروتوكولي OpenVPN وWireGuard، قابل للاختيار حسب كل مزود وما يوفره
  • مفتاح إيقاف تلقائي مدمج يحظر كل حركة مرور الحاويات فوراً إذا انقطع نفق VPN، مانعاً تسرب IP
  • network_mode: container:gluetun يتيح لأي حاوية أخرى مشاركة مكدس شبكته وتوجيه كل حركة مرورها عبر VPN
  • دعم توجيه المنافذ للمزودين الذين يوفرونه، حتى تصل الاتصالات الواردة للخدمات خلف VPN
  • أوضاع وكيل HTTP وSOCKS5 للتطبيقات التي تفضل الاتصال عبر وكيل بدلاً من التوجيه الكامل للشبكة
  • دعم DNS-over-TLS لمنع تسرب DNS الذي قد يكشف نشاط التصفح خارج النفق المشفّر
  • واجهة تحكم API ونظام فحص صحة يبلّغ عن حالة الاتصال وIP العام وتفاصيل سيرفر VPN

كيفية الاستخدام بعد التثبيت

  • اضبط اسم مزود VPN والبروتوكول (OpenVPN أو WireGuard) وبيانات الاعتماد كمتغيرات بيئة قبل التشغيل الأول
  • راجع سجلات الحاوية للتأكد من نجاح اتصال النفق ولاحظ IP العام الذي يُبلّغ عنه
  • استعلم واجهة التحكم API على المنفذ 8223 للتحقق من حالة الاتصال وتأكيد أن VPN نشط
  • انشر الحاوية التي تريد حمايتها (مثل زاحف ويب أو عميل API) باستخدام network_mode: container:gluetun بدلاً من إعدادات شبكتها الخاصة
  • انشر منافذ الحاوية المحمية على حاوية Gluetun نفسها، لأنها تمتلك مساحة الشبكة المشتركة
  • فعّل توجيه المنافذ في إعدادات Gluetun إذا كان مزود VPN يدعمه وتحتاج اتصالات واردة
  • اختبر مفتاح الإيقاف التلقائي بإيقاف اتصال VPN عمداً والتأكد من أن الحاوية الموجّهة تفقد الإنترنت بالكامل
  • راقب حالة فحص صحة الحاوية لتُنبَّه إذا انقطع نفق VPN بشكل غير متوقع

أفضل ممارسات الأمان

  • خزّن بيانات اعتماد مزود VPN كمتغيرات بيئة أو أسرار Docker، ولا تضعها مباشرة في ملف compose يُرفع لنظام تحكم الإصدار
  • تحقق دائماً من أن مفتاح الإيقاف التلقائي نشط بكسر اتصال VPN عمداً والتأكد من توقف حركة المرور الموجّهة تماماً
  • امنح صلاحية NET_ADMIN وجهاز /dev/net/tun لحاوية Gluetun فقط، ولا تمنحها لحاويات التطبيقات مباشرة أبداً
  • استخدم DNS-over-TLS لمنع تسرب استعلامات DNS خارج نفق VPN وكشف نشاط التصفح
  • اختر مزود VPN بسياسة عدم تسجيل موثقة إذا كان الهدف خصوصية حقيقية، وليس مجرد إخفاء IP
  • قيّد واجهة التحكم API على المنفذ 8223 على localhost أو الشبكات الموثوقة، لأنها قد تكشف تفاصيل الاتصال والإعداد
  • حافظ على تحديث صورة Gluetun، لأن قوائم سيرفرات مزودي VPN وإعدادات البروتوكولات تتغير وتتطلب تحديثات دورية
  • تجنّب توجيه حركة مرور لا تنوي حمايتها عبر Gluetun، لأن سوء الإعداد قد يكشف أو يحظر الحاوية الخاطئة

المنافذ وإعدادات جدار الحماية

يكشف Gluetun واجهة تحكم API على منفذ المضيف 8223، معيّنة من المنفذ الداخلي 8000 للحاوية، تُستخدم للتحقق من حالة الاتصال وIP العام. بناء نفق VPN نفسه يتطلب صلاحية NET_ADMIN والوصول لجهاز /dev/net/tun — هذه ليست منافذ شبكة بل صلاحيات Linux مطلوبة لإنشاء واجهات شبكة، ويجب منحها لحاوية Gluetun فقط. الحاويات الأخرى المرتبطة عبر network_mode: container:gluetun لا تنشر منافذها الخاصة؛ بدلاً من ذلك، انشر منافذها على حاوية Gluetun نفسها لأنها تمتلك مساحة الشبكة المشتركة. يحظر مفتاح الإيقاف التلقائي كل حركة المرور الصادرة إذا انقطع نفق VPN، لذا لا حاجة لفتح أي منفذ لكي تعمل هذه الحماية — إنها مفروضة داخلياً بقواعد جدار Gluetun.

النسخ الاحتياطي والصيانة

  • انسخ احتياطياً متغيرات البيئة أو ملف .env الذي يحتوي اسم مزود VPN والبروتوكول وبيانات الاعتماد
  • انسخ احتياطياً docker-compose.yml حتى يمكن إعادة إنشاء علاقات network_mode الدقيقة بين Gluetun والحاويات الموجّهة عبره
  • وثّق أي الحاويات موجّهة عبر Gluetun باستخدام network_mode: container:gluetun حتى يمكن إعادة بناء الإعداد بشكل صحيح
  • Gluetun نفسه لا يحتفظ بحالة دائمة ذات معنى بخلاف إعداداته — لا توجد قاعدة بيانات أو دليل محتوى يحتاج نسخاً احتياطياً
  • إذا استخدمت توجيه المنافذ، دوّن رقم المنفذ الموجّه لأن بعض المزودين يعيدون تعيينه وقد يحتاج إعادة ضبط بعد الاستعادة
  • خزّن بيانات اعتماد VPN في مدير كلمات مرور منفصل عن أرشيف النسخ الاحتياطي كطبقة حماية إضافية

الأخطاء الشائعة

  • نسيان منح صلاحية NET_ADMIN والوصول لجهاز tun، مما يمنع Gluetun من بناء نفق VPN تماماً
  • عدم التحقق من أن مفتاح الإيقاف التلقائي يعمل فعلاً قبل الاعتماد عليه — اختبره دائماً بكسر الاتصال عمداً
  • نشر منافذ على الحاوية الموجّهة نفسها بدلاً من Gluetun، الذي يمتلك مساحة الشبكة المشتركة
  • استخدام network_mode: container:gluetun قبل نجاح فحص صحة Gluetun نفسه، مما يجعل الحاوية التابعة تبدأ بدون وصول للشبكة
  • كتابة بيانات اعتماد VPN مباشرة في ملف docker-compose.yml يُرفع لنظام تحكم الإصدار
  • افتراض أن Gluetun سيرفر VPN مثل WireGuard Easy أو Headscale، بينما هو في الواقع عميل يتصل خارجياً بمزود تجاري
  • عدم تقييد منفذ واجهة التحكم API، تاركاً تفاصيل حالة الاتصال والإعداد مكشوفة دون داعٍ
  • اختيار بروتوكول VPN لا يدعمه المزود جيداً فعلياً، مما يسبب انقطاعات متكررة وأنفاقاً غير مستقرة

استكشاف الأخطاء وإصلاحها

  • النفق لا يتصل — تحقق من بيانات اعتماد مزود VPN واختيار البروتوكول ومنطقة السيرفر مضبوطة بشكل صحيح في متغيرات البيئة
  • الحاوية الموجّهة بلا وصول للإنترنت — تأكد من نجاح فحص صحة Gluetun قبل بدء الحاوية التابعة
  • مفتاح الإيقاف التلقائي يبدو غير نشط — راجع قواعد جدار Gluetun وتأكد أنك تختبر بكسر اتصال VPN فعلياً، وليس فقط بمراجعة السجلات
  • توجيه المنافذ لا يعمل — تأكد أن مزود VPN يدعمه وأنه مفعّل صراحة في إعدادات Gluetun
  • اكتُشف تسرب DNS — تحقق من تفعيل DNS-over-TLS وأن الحاوية الموجّهة لا تتجاوز إعدادات DNS الخاصة بـ Gluetun
  • واجهة التحكم API غير متاحة على المنفذ 8223 — تحقق من تعيين المنفذ وتأكد أن الحاوية تعمل باستخدام docker ps
  • انقطاعات متكررة — جرّب تبديل بروتوكول VPN (OpenVPN مقابل WireGuard) أو منطقة السيرفر، فبعض التركيبات أقل استقراراً حسب المزود
  • الحاوية التي تستخدم network_mode: container:gluetun لا تبدأ — تأكد أن Gluetun نفسه بدأ بنجاح أولاً، لأن الحاوية التابعة تعتمد على مساحة شبكته

البدائل

WireGuard Easy وHeadscale وNetbird وTailscale سيرفرات VPN — تتيح لك الاتصال بشبكتك الخاصة من الخارج، وهي وظيفة معاكسة تماماً لـ Gluetun. تشغيل عميل VPN يدوياً داخل كل حاوية تطبيق ممكن لكنه متكرر وعرضة للأخطاء ومعظم الصور لا تدعمه أصلاً. بعض مزودي VPN يقدمون صور Docker رسمية خاصة بهم، لكنها عادة تحمي حاوية واحدة فقط بدلاً من العمل كبوابة مشتركة. لتوجيه عدة حاويات عبر مزود VPN تجاري مع مفتاح إيقاف تلقائي موثوق وإعداد بسيط، يبقى Gluetun الخيار المعتمد في مجتمع الاستضافة الذاتية.

متى لا تستخدمه

إذا كنت تحتاج إنشاء شبكتك الخاصة للوصول لخدماتك المنزلية عن بُعد، فأنت تحتاج سيرفر VPN مثل WireGuard Easy أو Netbird، وليس Gluetun — فهو يؤدي الوظيفة المعاكسة. إذا كان مزود VPN لديك لا يهتم إطلاقاً بحركة مرورك وتحتاج فقط حماية تطبيق خفيف واحد، فتشغيل عميل ذلك المزود الرسمي مباشرة قد يكون أبسط من إضافة حاوية إضافية. يعتمد Gluetun أيضاً كلياً على موثوقية وجودة سيرفرات مزود VPN التجاري لديك — لا يمكنه إصلاح خدمة VPN بطيئة أو غير مستقرة، بل يوفر فقط البنية التي تستخدمها.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو Gluetun؟

هو عميل VPN خفيف مُعبّأ كحاوية. يتصل خارجياً بمزود VPN تجاري (NordVPN وMullvad وProtonVPN وSurfshark والعديد غيرها) ويعمل كبوابة شبكة يمكن للحاويات الأخرى توجيه حركة مرورها عبرها.

كيف أوجّه حاوية أخرى عبره؟

شغّل الحاوية الأخرى بـ network_mode: container:gluetun. هذا يجعلها تشارك مكدس شبكة Gluetun، بحيث تمر كل حركة مرورها عبر VPN.

ما هو مفتاح الإيقاف التلقائي ولماذا يهم؟

مفتاح الإيقاف التلقائي يعني أنه إذا انقطع نفق VPN، يحظر Gluetun كل حركة المرور للحاويات الموجّهة بدلاً من تركها تعود لاتصال إنترنتك الحقيقي. هذا هو الضمان الحاسم للخصوصية: بدونه، قد يكشف انقطاع VPN عن IP الحقيقي بصمت.

لماذا يحتاج NET_ADMIN وجهاز tun؟

بناء نفق VPN يتطلب إنشاء وإدارة واجهات شبكة، وهذا يحتاج صلاحية NET_ADMIN والوصول لجهاز /dev/net/tun. هذه مطلوبة لعمل أي عميل VPN. إنها صلاحيات قوية، لذا امنحها لحاوية Gluetun فقط دون غيرها.

هل هو سيرفر VPN مثل WireGuard أو Headscale؟

لا — هذا تمييز مهم. WireGuard Easy وHeadscale وNetbird وTailscale سيرفرات VPN تتيح لك الدخول لشبكتك الخاصة من الخارج. Gluetun عميل VPN يرسل حاويات مختارة للخارج عبر مزود VPN تجاري.