🖥️ تثبيت Nginx UI — لوحة تحكم وإدارة خادم Nginx عبر الويب على Docker
نشر لوحة Nginx UI على Ubuntu باستخدام Docker — واجهة ويب عصرية وسلسة لإدارة خوادم Nginx وإنشاء مواقع الوكيل العكسي وتوليد شهادات SSL التلقائية وتحليل السجلات الحية.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/nginx-ui/nginx-ui-ubuntu.sh
chmod +x nginx-ui-ubuntu.sh
./nginx-ui-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/nginx-ui/nginx-ui-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x nginx-ui-ubuntu.sh
3 تشغيل المثبت
./nginx-ui-ubuntu.sh
4 إتمام الإعداد عبر الويب
http://your-server-ip:8259
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8259 | Nginx UI management panel (mapped from container port 80) |
| 8460 | Nginx UI HTTPS (mapped from container port 443) |
نظرة عامة
تعد Nginx UI لوحة تحكم وإدارة متقدمة ومفتوحة المصدر مصممة لتسهيل إدارة خوادم Nginx عبر متصفح الويب. تم بناء المنصة بلغة Go وVue.js، وتعمل على المنفذ 8259 (HTTP) والمنفذ 8460 (HTTPS)، حيث توفر واجهة رسومية جذابة لإنشاء مواقع الوكيل العكسي (Reverse Proxy)، وإصدار شهادات SSL/TLS المجانية تلقائياً عبر Let's Encrypt، وتعديل ملفات تكوين Nginx بمحرر كود متقدم يدعم التلوين البرمجي والتحقق من الأخطاء، بالإضافة إلى استعراض وتحليل سجلات الزيارات والأخطاء لحظياً.
لماذا تستخدمه
على الرغم من قوة وسرعة خادم Nginx، إلا أن إدارة العشرات من النطاقات وتعديل ملفات التكوين عبر موجه الأوامر وتجديد الشهادات يدوياً قد يكون أمراً معقداً وعرضة للأخطاء الإملائية. تجمع Nginx UI بين سهولة الواجهة الرسومية وقوة التحكم البرمجي الكامل؛ حيث يمكنك إضافة المواقع بنقرات بسيطة أو الدخول لمحرر الكود المدمج لكتابة توجيهات Nginx متقدمة مع فحص الصياغة تلقائياً قبل الحفظ.
متى تحتاجه
- تدير عدة خدمات ومواقع وترغب في واجهة ويب سهلة لإضافة النطاقات وتوجيهها للحاويات الداخلية
- تريد إصدار وتجديد شهادات Let's Encrypt SSL تلقائياً دون الحاجة لتشغيل أوامر Certbot في الطرفية
- تحتاج إلى محرر كود مدمج يدعم تلوين صياغة Nginx والإكمال التلقائي وفحص الأخطاء قبل إعادة التحميل
- تريد مراقبة أداء خادم Nginx ومتابعة عدد الاتصالات النشطة وفحص سجلات الأخطاء والزيارات مباشرة من المتصفح
- تبحث عن بديل متقدم لـ Nginx Proxy Manager يتيح لك تعديل ملفات التكوين الخام بحرية كاملة
من يحتاجه
- مديرو الأنظمة ومسؤولو الخوادم الذين يديرون بوابات الوكيل العكسي واستضافة المواقع
- أصحاب السيرفرات المنزلية (Homelab) الراغبون في ربط حاويات Docker بنطاقات مخصصة بسهولة
- مطور الويب الذين يحتاجون لتجهيز بيئات الاستضافة وتوجيه المسارات والشهادات بسرعة
- مهندسو DevOps لمتابعة سجلات الوصول اللحظية وإدارة الخوادم الافتراضية بصرياً
- المستخدمون القادمون من لوحات التحكم التقليدية مثل cPanel الباحثون عن لوحة عصرية وسريعة
حالات الاستخدام الشائعة
- إنشاء وإدارة مواقع الوكيل العكسي لتوجيه النطاقات العامة لعناوين ومنافذ حاويات Docker الداخلية
- إصدار شهادات SSL/TLS تلقائياً من Let's Encrypt وتجديدها في الخلفية دون أي تدخل يدوي
- استعراض سجلات الوصول اللحظية وفحص أكواد الاستجابة (200 و404 و502) وعناوين IP للزوار
- تعديل مجموعات خوادم توزيع الأحمال (Upstream) والتحقق التلقائي من سلامة الأوامر
- تطبيق التحويل التلقائي لـ HTTPS وإضافة ترويسات الأمان المتقدمة للمواقع
الميزات الرئيسية
- واجهة مستخدم عصرية وسريعة مبنية بـ Vue 3 وGo تستهلك قدراً ضئيلاً جداً من موارد السيرفر
- إصدار وتجديد تلقائي لشهادات Let's Encrypt عبر عميل ACME المدمج
- محرر كود متقدم (Monaco Editor) يدعم تلوين صياغة Nginx والتحقق الفوري من صحة الأوامر
- لوحة مراقبة حية تعرض استهلاك المعالج والذاكرة والاتصالات النشطة وسرعة نقل البيانات
- عارض سجلات تفاعلي يدعم البحث وتصفية سجلات الزيارات وسجلات الأخطاء لحظياً
- نظام إدارة مستخدمين وصلاحيات دقيقة مع تسجيل لجميع العمليات والتعديلات
- دعم كامل للتكوينات الخام وقواعد توجيه منافذ TCP/UDP (Stream blocks) والإعدادات العامة
- نشر معزول عبر Docker مع ربط مجلد ./nginx للإعدادات ومجلد ./data لقاعدة البيانات
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8259 لبدء معالج الإعداد الأولي لـ Nginx UI
- أنشئ حساب المشرف الأساسي بإدخال اسم المستخدم والبريد الإلكتروني وكلمة مرور قوية
- انتقل إلى قسم Sites لعرض الخوادم الحالية أو انقر على 'Add Site' لإنشاء موقع وكيل عكسي جديد
- أدخل اسم النطاق الخاص بك، واختر المنافذ المستمعة (80/443)، وحدد عنوان ومنفذ الحاوية المستهدفة
- انتقل لتبويب SSL وفعل خيار Let's Encrypt لإصدار شهادة أمان تلقائية لنطاقك
- انقر على 'Save and Test' للتحقق من صحة الإعدادات وتطبيقها فوراً دون انقطاع الخدمة
أفضل ممارسات الأمان
- غيّر بيانات الاعتماد الافتراضية واختر كلمة مرور قوية للمشرف أثناء الإعداد الأولي
- احمِ منفذ الإدارة 8259 بقصره على شبكتك المحلية أو الوصول إليه عبر شبكة VPN مشفرة (WireGuard)
- فعل تشفير SSL/TLS دائماً لجميع النطاقات والمواقع لحماية بيانات الزوار وتسجيلات الدخول
- لا تمنح صلاحيات المشرف في اللوحة لأشخاص غير موثوقين نظراً لقدرة المشرف على تعديل ملفات السيرفر
- احتفظ بنسخ احتياطية لمجلد ./data واحمِ صلاحياته على السيرفر
- حدّث صورة الحاوية uozi/nginx-ui بانتظام للحصول على أحدث التحديثات الأمنية وإصلاحات ACME
المنافذ وإعدادات جدار الحماية
تستمع لوحة Nginx UI على منفذ 8259 لحركة HTTP ومنفذ 8460 لحركة HTTPS المشفرة (المحولة داخلياً لمنافذ 80 و443). عند استخدامها كبوابة رئيسية للمواقع، يفضل ربط المنفذين القياسيين 80 و443 مباشرة في جدار الحماية (ufw allow 80/tcp && ufw allow 443/tcp) لاستقبال الزوار، مع قصر الوصول للوحة التحكم على المشرفين.
النسخ الاحتياطي والصيانة
- انسخ مجلد ./data احتياطياً، والذي يحتوي على قاعدة بيانات SQLite وحسابات المستخدمين ومفاتيح ACME
- انسخ مجلد ./nginx احتياطياً، والذي يحتوي على جميع ملفات تكوين المواقع والشهادات المولدة
- احتفظ ببيانات مفاتيح DNS API في حال استخدام تحدي DNS-01 لإصدار الشهادات
- أتمت النسخ الاحتياطي اليومي لمجلد التطبيق وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
- اختبر الاستعادة بربط مجلدي البيانات والإعدادات بحاوية جديدة للتأكد من استرجاع المواقع بنجاح
الأخطاء الشائعة
- نسيان فتح المنفذ 80 للإنترنت العام، مما يؤدي لفشل التحقق من ملكية النطاق عند إصدار شهادات Let's Encrypt
- تعديل ملفات الإعداد يدوياً على القرص أثناء تشغيل Nginx UI، مما يسبب تعارضاً وتضارباً مع قاعدة البيانات
- فتح منفذ لوحة التحكم (8259) للإنترنت العام دون حماية بجدار ناري أو شبكة VPN
- عدم ربط مجلدي التخزين الدائم ./data و./nginx، مما يسبب فقدان المواقع وحسابات المستخدمين عند التحديث
- حفظ توجيهات مخصصة غير صحيحة دون الضغط على زر فحص الإعدادات (Test Config)، مما يسبب تعطل Nginx
استكشاف الأخطاء وإصلاحها
- فشل إصدار شهادة Let's Encrypt — تأكد من أن سجل DNS A للنطاق يشير لعنوان IP سيرفرك وأن المنفذ 80 متاح
- ظهور خطأ 502 Bad Gateway — تأكد من تشغيل الحاوية الخلفية المستهدفة ومطابقة المنفذ المحدد
- فشل إعادة تحميل Nginx — راجع نافذة الخطأ أو نفذ 'nginx -t' داخل الحاوية لمعرفة تفاصيل الخطأ البرمجي
- نسيان كلمة مرور المشرف — أعد تعيين كلمة المرور عبر فتح قاعدة البيانات ./data/nginx-ui.db أو سطر الأوامر
- عدم إمكانية فتح لوحة التحكم — افحص سجلات الحاوية بالأمر: docker logs nginx-ui -f لمعرفة أسباب التعطل
البدائل
تطبيق Nginx Proxy Manager هو الخيار الأبسط والأشهر للمبتدئين لإدارة الوكيل العكسي، ولكنه أقل مرونة في تعديل الملفات الخام. خادم Caddy يوفر إصدار شهادات SSL تلقائياً بالكامل بملف تكوين فائق البساطة. منصة Traefik خيار سحابي يكتشف الحاويات تلقائياً عبر وسوم Docker. خادم HAProxy مخصص لموازنة الأحمال العالية مع لوحة إحصائيات مدمجة.
متى لا تستخدمه
تجنب استخدام Nginx UI إذا كنت تدير بنيتك التحتية كأكواد برمجية (Infrastructure as Code) عبر Git وAnsible وتفضل عدم استخدام لوحات التحكم الرسومية. وإذا كنت تعتمد بالفعل على Caddy أو Traefik لاكتشاف الحاويات تلقائياً، فلا حاجة لإضافة Nginx UI.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي لوحة Nginx UI؟
Nginx UI هي لوحة تحكم وإدارة عبر متصفح الويب تتيح للمسؤولين تهيئة مواقع الوكيل العكسي في Nginx بصرياً، وإصدار شهادات SSL مجانية، وتعديل ملفات التكوين بمحرر متقدم، واستعراض سجلات الزوار الحية.
كيف تدير Nginx UI شهادات Let's Encrypt SSL؟
تحتوي Nginx UI على عميل ACME مدمج. عند إنشاء موقع وتفعيل خيار SSL، تطلب اللوحة شهادة مجانية من Let's Encrypt وتقوم بجدولة تجديدها تلقائياً قبل انتهائها.
هل يمكنني كتابة توجيهات Nginx مخصصة داخل اللوحة؟
نعم، على عكس بعض اللوحات الرسومية المغلقة، توفر Nginx UI محرر كود Monaco متكاملاً يتيح لك كتابة أي أوامر وتوجيهات متقدمة في Nginx بحرية كاملة مع فحص صحتها قبل الحفظ.
ما الفرق بين Nginx UI وNginx Proxy Manager؟
توفر كلتا اللوحتين إدارة رسومية لـ Nginx. تطبيق Nginx Proxy Manager مصمم للبساطة التامة للمبتدئين، بينما تقدم Nginx UI تحكماً أعمق ومحرر كود للملفات الخام ومراقبة حية للموارد وتحليلاً تفاعلياً للسجلات.
كم تستهلك لوحة Nginx UI من الذاكرة العشوائية؟
تم بناء Nginx UI بلغة Go وهي فائقة الخفة والكفاءة؛ حيث تستهلك عادة ما بين 30 إلى 60 ميجابايت فقط من الذاكرة العشوائية أثناء التشغيل العادي.