🌐 تثبيت Zoraxy — الوكيل العكسي الشامل وإدارة النطاقات وشهادات SSL على Docker

نشر منصة Zoraxy على Ubuntu باستخدام Docker — الوكيل العكسي (Reverse Proxy) وإدارة التوجيه مفتوح المصدر الرائد مع شهادات Let's Encrypt التلقائية وحماية Geo-IP على المنافذ 8000 و80 و443.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Zoraxy على المنفذ 8000 مع منافذ الويب 80/443 والتوليد التلقائي لشهادات SSL وقواعد التوجيه جاهزة.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/networking/zoraxy/zoraxy-ubuntu.sh
chmod +x zoraxy-ubuntu.sh
sudo bash zoraxy-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/networking/zoraxy/zoraxy-ubuntu.sh

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

chmod +x zoraxy-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للإعدادات (`./data`) وفتح منافذ الويب (80/443) ومنفذ الإدارة (8000) وتشغيل Zoraxy.

sudo bash zoraxy-ubuntu.sh

4 إنشاء حساب المشرف وتوجيه أول نطاق

افتح متصفحك على الرابط http://ip-سيرفرك:8000. أنشئ حساب المشرف، وأضف أول قاعدة توجيه (مثل توجيه `app.yourdomain.com` لمنفذ `localhost:3000`)، واطلب شهادة SSL مجانية من Let's Encrypt بضغطة زر.

http://:8000
# Create the admin account on first visit

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

المنفذالغرض
8000Management Web UI (keep private)
80Proxied HTTP + ACME challenges
443Proxied HTTPS

نظرة عامة

تعد Zoraxy منصة وكيل عكسي (Reverse Proxy) ونظام توجيه شبكي شامل وعصري مفتوح المصدر تم برمجته بلغة Go وقاعدة بيانات SQLite. تعمل المنصة بواجهة إدارة ويب بصرية مخصصة على المنفذ 8000 بينما تستقبل حركة مرور الويب العامة على المنفذين 80 و443، لتتيح توجيه النطاقات والنطاقات الفرعية بسهولة إلى الحاويات والمنافذ الداخلية. وتتضمن إصداراً وتجديداً تلقائياً لشهادات التشفير Let's Encrypt SSL، وحظر الدول جغرافياً (Geo-IP)، وتحديد معدل الطلبات لمنع الهجمات، والمصادقة بكلمات المرور، ومراقبة الجاهزية الحية.

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

يتطلب تعديل ملفات إعدادات Nginx يدوياً وقتاً ويكون عرضة للأخطاء الإملائية مع صعوبة إدارة تجديد الشهادات. كما تعتمد بعض الواجهات الرسومية الأخرى (مثل Nginx Proxy Manager) على حزم بايثون ونود وقواعد بيانات تستهلك الكثير من الذاكرة. يقدم Zoraxy ملفاً تنفيذياً واحداً بلغة Go يعمل داخل حاوية خفيفة للغاية (~30 ميجابايت رام) مع إدارة تلقائية للـ SSL، وحماية متقدمة، واستقرار تشغيلي فائق.

متى تحتاجه

  • تريد واجهة ويب بصرية وسهلة لتوجيه عدة نطاقات ونطاقات فرعية لحاويات Docker ومنافذ السيرفر الداخلية
  • تريد إصدار وتجديد شهادات SSL/TLS المجانية من Let's Encrypt تلقائياً وبضغطة زر واحدة
  • تبحث عن بديل خفيف وفائق السرعة للوحات Nginx Proxy Manager وTraefik وCaddy
  • تحتاج لميزات أمان متقدمة مدمجة مثل حظر حركة المرور حسب الدول (Geo-IP) وتحديد معدل الطلبات (Rate Limiting)
  • تريد لوحة مراقبة حية تعرض جاهزية وسرعة استجابة كافة المواقع والخدمات الموجهة

من يحتاجه

  • أصحاب السيرفرات المنزلية لاستضافة خدمات متعددة (Nextcloud وPlex وVaultwarden) خلف عنوان IP عام واحد
  • مديرو الأنظمة لإدارة توجيه النطاقات وشهادات التشفير والمواقع الافتراضية بسهولة
  • مطورو الويب لإتاحة منافذ التطبيقات المحلية والتطويرية للإنترنت عبر نطاقات HTTPS آمنة
  • المسؤولون الأمنيون لتطبيق سياسات الحظر الجغرافي والحد من هجمات حجب الخدمة (DDoS)
  • أصحاب المشاريع الصغيرة الباحثون عن وكيل عكسي سهل الاستخدام بدون أي رسوم تراخيص

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

  • توجيه نطاق `cloud.example.com` للمنفذ 8080 ونطاق `vault.example.com` للمنفذ 8000 بتشفير HTTPS تلقائي
  • حظر زيارات المواقع القادمة من مناطق جغرافية محددة باستخدام جدار الحماية الجغرافي المدمج (Geo-IP)
  • وضع شاشة تسجيل دخول بكلمة مرور (HTTP Basic Auth) لحماية لوحات الإدارة والخدمات الحساسة
  • إنشاء مسارات وتوجيهات فرعية مخصصة (مثل توجيه مسار `/docs` لويكي التوثيق الداخلي)
  • مراقبة استقرار وسرعة استجابة 15 موقعاً وخدمة مستضافة ذاتياً في شاشة واحدة

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

  • لوحة إدارة بصرية على المنفذ 8000: واجهة ويب أنيقة لإدارة قواعد التوجيه، وشهادات SSL، ومؤشرات الشبكة
  • شهادات Let's Encrypt تلقائية على المنافذ 80/443: إصدار وتجديد تلقائي بالكامل عبر تحدي ACME HTTP-01
  • جدار حماية جغرافي (Geo-IP) وتحكم بالوصول: حظر أو السماح بحركة البيانات بناءً على الدول ونطاقات الـ IP
  • تحديد معدل الطلبات (Rate Limiting): حماية الخوادم الخلفية من هجمات التخمين والزحف العشوائي
  • دعم بروتوكولات HTTP/2 وWebSockets: توافق كامل مع التطبيقات التفاعلية في الوقت الفعلي (مثل هوم أسيستانت)
  • نظام مراقبة الجاهزية المدمج: فحص الخوادم الموجهة وتنبيهك عند حدوث أي انقطاع
  • معمارية Go خفيفة وفائقة السرعة: استهلاك ضئيل للذاكرة (~30 إلى 60 ميجابايت رام) مع سرعة توجيه فائقة
  • معمارية Docker Compose تنشر المنفذ 8000 مع منافذ الويب 80 و443 بتثبيت مباشر وسريع

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8000
  • سجل حساب المشرف الشخصي الأول باسم مستخدم وكلمة مرور قوية
  • انتقل إلى Proxy Rules ← اضغط '+ Add Rule'، واكتب اسم نطاقك (مثل `app.domain.com`) والمنفذ المستهدف (مثل `127.0.0.1:3000`)
  • توجه إلى إعدادات TLS/SSL واطلب شهادة Let's Encrypt مجانية لنطاقك
  • اختبر فتح موقعك عبر رابط HTTPS العام للتأكد من عمل التوجيه والتشفير
  • أعد سكريبت نسخ احتياطي دوري لمجلد الإعدادات `./data`

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

  • تنبيه أمني حاسم: عيّن كلمة مرور معقدة لحساب المشرف أثناء شاشة التثبيت الأولى
  • لا تكشف منفذ الإدارة 8000 للإنترنت العام مباشرة؛ واقصره على شبكتك المحلية الموثوقة أو شبكة VPN
  • فعل التوجيه الإجباري لـ HTTPS دائماً لضمان تشفير كافة زيارات المستخدمين بالشبكة
  • فعل تحديد معدل الطلبات على صفحات تسجيل الدخول لمنع هجمات التخمين
  • احمِ مجلد البيانات `./data` المحتوي على المفاتيح الخاصة بشهادات SSL بصلاحيات نظام صارمة (`chmod 700`)
  • حدّث صورة الحاوية دورياً للحصول على أحدث مكتبات التشفير وإصلاحات الأمان

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

يستخدم Zoraxy منفذ TCP 8000 للوحة الإدارة الخاصة، ومنفذ TCP 80 لحركة HTTP العامة وتحديات ACME، ومنفذ TCP 443 لحركة HTTPS المشفرة. اسمح بالمنافذ 80 و443 بجدار الحماية العام (`ufw allow 80/tcp && ufw allow 443/tcp`). واقصر منفذ الإدارة 8000 على شبكتك الداخلية (`ufw allow from 192.168.1.0/24 to any port 8000`).

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

  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على قاعدة بيانات SQLite الخاصة بـ Zoraxy، وقواعد التوجيه، وشهادات Let's Encrypt
  • احتفظ بنسخة من ملف `docker-compose.yml`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بنسخ مجلد `./data` بحاوية تجريبية والتأكد من تحميل كافة قواعد التوجيه بنجاح

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

  • كشف منفذ الإدارة 8000 للإنترنت العام بدون حماية جدار ناري أو شبكة VPN
  • نسيان فتح المنفذ 80 بجدار الحماية بالسيرفر مما يؤدي لفشل إصدار شهادات Let's Encrypt
  • عدم ربط مجلد التخزين الدائم `./data`، مما يسبب مسح كافة قواعد التوجيه وشهادات SSL عند تحديث الحاوية
  • كتابة أسماء حاويات دكر الداخلية دون ربط Zoraxy بنفس شبكة دكر المشتركة
  • إنشاء حلقات إعادة توجيه لا نهائية بكتابة النطاق العام نفسه كهدف بدلاً من عنوان IP الداخلي

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

  • فشل إصدار شهادة Let's Encrypt — تأكد من فتح المنفذ 80 للإنترنت العام وتوجيه سجل A بالنطاق لعنوان IP سيرفرك بدقة
  • ظهور خطأ 502 Bad Gateway بالنطاق — تأكد من أن التطبيق الخلفي يعمل ويستمع على العنوان والمنفذ المحددين
  • انقطاع اتصالات الـ WebSockets — فعل خيار دعم WebSockets في إعدادات قاعدة التوجيه المحددة داخل Zoraxy
  • تعذر فتح لوحة الإدارة على المنفذ 8000 — افحص حالة الحاوية بالأمر `docker compose ps` وراجع السجلات: `docker logs zoraxy -f`
  • قاعدة بيانات Geo-IP قديمة — توجه لإعدادات Geo-IP واضغط 'Update Geo-IP Database' لتحميل أحدث ملفات MaxMind

البدائل

لوحة Nginx Proxy Manager (NPM) الشهيرة. خادم Traefik السحابي الديناميكي. خادم Caddy للتشفير التلقائي. خادم HAProxy للأداء العالي. ميزة Cloudflare Tunnels للربط بدون فتح منافذ.

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

تجنب استخدام Zoraxy إذا كنت تدير خدمات ديناميكية داخل عنقود Kubernetes حيث تقوم أدوات Ingress كـ Traefik بإعداد المسارات آلياً من ملفات الـ Pods. وإذا كنت تحتاج فقط لخادم ويب ثابت لصفحة HTML واحدة بدون أي وكيل عكسي، فإن Caddy أو Nginx المباشر أبسط.

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

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

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

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

ما هي منصة Zoraxy وما الفرق بينها وبين Nginx Proxy Manager؟

منصة Zoraxy هي وكيل عكسي شامل مبرمج بلغة Go. بينما تعتمد Nginx Proxy Manager على حزم متعددة من Nginx وبايثون ونود وقاعدة MySQL، يعمل Zoraxy كملف تنفيذي فردي خفيف للغاية (~30 ميجابايت رام) ويتضمن حظر الدول جغرافياً ومراقبة الجاهزية بشكل مدمج.

هل يقوم Zoraxy بتجديد شهادات Let's Encrypt تلقائياً؟

نعم! يتضمن Zoraxy نظام أتمتة ACME مدمجاً. يطلب شهادات SSL مجانية لنطاقاتك ويجددها تلقائياً قبل انتهائها بدون أي تدخل يدوي منك.

هل يدعم Zoraxy تطبيقات WebSockets مثل Home Assistant وWeKan؟

نعم! يدعم Zoraxy بروتوكول WebSockets بشكل أصلي، حيث يكفي تفعيل خيار WebSocket في إعدادات النطاق لضمان الاتصال اللحظي الفوري.

لماذا يعد المنفذ 80 ضرورياً إذا كنت أستخدم تشفير HTTPS (المنفذ 443) فقط؟

يعد المنفذ 80 ضرورياً لسببين: (1) استقبال تحديات التحقق من Let's Encrypt لإصدار وتجديد الشهادات، و(2) إعادة توجيه الزوار تلقائياً من روابط `http://` غير المشفرة إلى روابط `https://` الآمنة.

كم يستهلك نظام Zoraxy من الذاكرة العشوائية (RAM)؟

تم بناء Zoraxy بلغة Go مع قاعدة بيانات SQLite مدمجة، ويتميز بخفة استثنائية حيث يستهلك عادة ما بين 25 إلى 60 ميجابايت فقط من الرام داخل Docker.