💬 تثبيت NodeBB — منصة المنتديات والمجتمعات التفاعلية الحديثة على Docker

نشر منصة المنتديات العصرية NodeBB على Ubuntu باستخدام Docker — منصة مجتمعات فائقة السرعة والتفاعل مبنية بـ Node.js وWebSockets وقاعدة بيانات MongoDB للمناقشات الحية.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر NodeBB مع قاعدة بيانات MongoDB 6 على المنفذ 4567 مع حفظ دائم وسرعة استجابة فورية.
عرض على GitHub

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

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

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

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

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

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

chmod +x nodebb-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتهيئة حاوية قاعدة بيانات MongoDB 6 وضبط متغيرات البيئة وتشغيل خدمة NodeBB على المنفذ 4567.

sudo bash nodebb-ubuntu.sh

4 إتمام الإعداد عبر الويب

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:4567 لبدء معالج الإعداد الإداري. أنشئ حساب المشرف واضبط أقسام المنتدى والهوية البصرية.

http://:4567
# Complete the setup wizard on first visit

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

المنفذالغرض
4567NodeBB web UI + websockets
27017 / 6379 / 5432MongoDB / Redis / PostgreSQL (internal only)

نظرة عامة

تعد NodeBB منصة منتديات ومجتمعات نقاشية مفتوحة المصدر من الجيل الحديث، تم بناؤها بلغة Node.js وتعتمد على قاعدة بيانات MongoDB. على عكس المنتديات القديمة المعتمدة على PHP والتي تتطلب إعادة تحميل الصفحة باستمرار، تستخدم NodeBB تقنية WebSockets لبث الإشعارات الفورية، وتحديث المواضيع لحظياً، والمحادثات المباشرة دون أي انقطاع. تعمل المنصة على المنفذ 4567، وتجمع بين ميزات شبكات التواصل الاجتماعي الحديثة (الإشارات @mentions، والتصويت، ومحرر Markdown التفاعلي، ونقاط السمعة) وأدوات الإشراف الإداري الصارمة والتصميم المتجاوب مع الهواتف.

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

أصبحت برمجيات المنتديات التقليدية (مثل phpBB وvBulletin) تبدو قديمة وبطيئة على الهواتف وتفتقر إلى التفاعل اللحظي. تعيد NodeBB الحيوية للمجتمعات بتقديم سرعة وتجربة مستخدم تضاهي تطبيقات المحادثة مثل Discord وSlack ولكن في هيئة موضوعات نقاشية منظمة ومؤرشفة وقابلة للبحث. تمنحك الاستضافة الذاتية لـ NodeBB السيادة الكاملة على بيانات أعضائك، مع إمكانية تثبيت مئات الإضافات المجانية دون أي رسوم اشتراك شهرية.

متى تحتاجه

  • ترغب في بناء مجتمع عملاء نشط، أو منتدى مطورين تقني، أو مجتمع ألعاب تفاعلي
  • يحتاج مجتمعك إلى تنظيم النقاشات وتوثيق الحلول في موضوعات مفهرسة بدلاً من فوضى غرف Discord وSlack
  • تحتاج إلى ميزات التفاعل اللحظي: إشعارات فورية، وظهور الردود أثناء الكتابة، وغرف محادثة مدمجة
  • تريد السيطرة الكاملة على بيانات المستخدمين والهوية البصرية وحماية الخصوصية دون الاعتماد على منصات الشركات
  • تبحث عن بديل مفتوح المصدر لمنصة Discourse يعمل بخفة وسلاسة عبر Node.js وMongoDB

من يحتاجه

  • مديرو المجتمعات وصناع المحتوى لبناء مساحات نقاشية وتفاعلية متخصصة
  • شركات البرمجيات والمشاريع مفتوحة المصدر لتقديم الدعم الفني للمستخدمين وتلقي الاقتراحات
  • مجتمعات وفرق الألعاب الإلكترونية لتنظيم البطولات واستراتيجيات اللعب والفعاليات
  • الجامعات والمؤسسات التعليمية لمناقشات المقررات الدراسية والتفاعل بين الطلاب
  • مديرو الأنظمة الذين يبحثون عن محرك منتديات حديث ومستقر يتم نشره بسلاسة عبر Docker

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

  • استضافة منتدى دعم فني رسمي مع إمكانية تصويت المستخدمين وتعيين شارات التوثيق للموظفين
  • إدارة مجتمع نقاشي تفاعلي مع رفع الصور ونظام الرتب والشارات ونقاط السمعة التنافسية
  • إنشاء قاعدة معرفية ومجتمع نقاش داخلي للموظفين مع دعم تسجيل الدخول الموحد (SSO)
  • تنظيم منتديات لتطوير وتعديل الألعاب ومناقشات البرمجة مع دعم تمييز الأكواد البرمجية
  • أرشفة المقالات والأسئلة الشائعة والظهور القوي في نتائج محركات البحث (SEO)

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

  • بث فوري عبر WebSockets: تدفق الردود والإشعارات الفورية والمحادثات الحية بدون إعادة تحميل الصفحة
  • محرر نصوص Markdown غني مع معاينة حية لحظية وحفظ تلقائي للمسودات وسحب وإفلات الصور
  • نظام سمعة ومكافآت متقدم: شارات المستخدمين، نقاط السمعة، الصلاحيات التلقائية، ولوحة الشرف
  • أدوات إشراف متطورة: طابور البلاغات، مراجعة تعديلات المشاركات، الحظر المؤقت، وحظر الآي بي
  • تصميم متجاوب بالكامل يدعم تثبيت التطبيق كتطبيق ويب تقدمي (PWA) مع إشعارات الهاتف
  • واجهة برمجية RESTful API متكاملة لربط المنتدى بالتطبيقات الخارجية والبوتات
  • سوق إضافات وسمات غني يمكن تثبيته وتفعيله بنقرة زر من لوحة تحكم المشرف
  • معمارية حاويات مع قاعدة بيانات MongoDB 6 تضمن سرعة كتابة فائقة وتخزيناً دائماً

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

  • انتقل إلى الرابط http://ip-سيرفرك:4567 لبدء معالج الإعداد الأولي للمنتدى
  • أنشئ حساب المشرف العام وحدد اسم المنتدى واللغة الافتراضية للموقع
  • اضبط عنوان الموقع العام (قيمة url في ملف config.json) ليطابق اسم نطاقك المخصص المشفر بـ HTTPS
  • انتقل إلى لوحة التحكم (ACP) ← إدارة ← الأقسام لإنشاء وتنسيق أقسام المنتدى وأيقوناتها
  • اضبط خادم البريد الصادر SMTP من قسم الإعدادات ← البريد لتفعيل إرسال رسائل تفعيل الحسابات واستعادة كلمات المرور
  • تصفح قسم الإضافات (Plugins) لتثبيت ميزات تسجيل الدخول عبر Google/GitHub أو السمات المخصصة
  • ضع المنتدى خلف وكيل عكسي (مثل Nginx أو Caddy) مع تفعيل دعم ترقية بروتوكول WebSockets

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

  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي مع دعم WebSockets لحماية جلسات وكلمات مرور الأعضاء
  • اختر كلمة مرور قوية لحساب المشرف وفعل المصادقة الثنائية (2FA) للمشرفين والمديرين
  • أبقِ منفذ MongoDB 27017 معزولاً داخل شبكة Docker الداخلية وتجنب فتحه للإنترنت العام
  • احمِ التسجيل من البوتات بتفعيل reCAPTCHA أو hCaptcha من إعدادات التسجيل في لوحة التحكم
  • راجع سجلات نشاط المشرفين دورياً من لوحة التحكم للتأكد من سلامة العمليات الإدارية
  • حدّث صورة الحاوية nodebb/docker دورياً للحصول على التحديثات الأمنية وإصلاحات لغة Node.js

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

تستمع خدمة NodeBB وواجهاتها وقنوات WebSockets على منفذ TCP 4567. في الإنتاج، يوصى بتهيئة وكيل عكسي مشفر (مثل Nginx Proxy Manager أو Caddy) على المنفذ 443 وربطه بـ 4567 مع تمرير ترويسات WebSockets. وتعمل قاعدة بيانات MongoDB على المنفذ الداخلي 27017 داخل شبكة Docker المعزولة (`nodebb-net`) ويجب عدم فتحها في جدار الحماية الخارجي.

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

  • انسخ مجلد ./mongo احتياطياً، والذي يحتوي على قاعدة بيانات MongoDB بجميع الموضوعات والمستخدمين والإعدادات
  • انسخ مجلد ./data احتياطياً، والذي يحتوي على ملف الإعداد config.json والمرفقات والصور المرفوعة
  • استخدم أمر mongodump لأخذ نسخ احتياطية دورية لقاعدة البيانات: docker exec nodebb-mongo mongodump --out /data/db/backup
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
  • اختبر دورياً استعادة البيانات في بيئة تجريبية للتأكد من سلامة الجداول والمشاركات بنجاح

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

  • نسيان ترويسات ترقية WebSockets في إعدادات Nginx، مما يجبر NodeBB على نمط الاستطلاع البطيء (HTTP Long-Polling)
  • كتابة عنوان IP بدلاً من النطاق المشفر بـ HTTPS في خاصية 'url' بملف config.json مما يسبب أخطاء التحقق من الجلسات (CSRF)
  • فتح منفذ قاعدة البيانات MongoDB 27017 للإنترنت العام دون حماية
  • عدم ربط مجلدي التخزين الدائم ./mongo و./data، مما يؤدي لمسح المناقشات والمستخدمين عند تحديث الحاوية
  • ترك التسجيل مفتوحاً للعامة دون تفعيل التحقق بالبريد أو كابتشا، مما يعرض المنتدى لهجمات السبام التلقائي

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

  • الإشعارات الفورية لا تظهر — تأكد من إعدادات الوكيل العكسي وعدم حظر اتصالات WebSockets
  • خطأ 'Invalid CSRF Token' عند تسجيل الدخول — تأكد من أن متغير 'url' في ملف config.json يطابق تماماً النطاق المستخدم في المتصفح مع https://
  • فشل الاتصال بقاعدة البيانات — تأكد من تشغيل حاوية nodebb-mongo وصلاحيات مجلد البيانات
  • إضافة برمجية تسببت في تعطل المنتدى — شغل المنتدى في الوضع الآمن عبر الطرفية: docker exec -it nodebb ./nodebb reset -p
  • إعادة تشغيل مستمرة للحاوية — افحص سجلات الحاوية بالأمر: docker logs nodebb -f لمعرفة تفاصيل الخطأ

البدائل

منصة Discourse هي المنصة الرائدة عالمياً للمجتمعات الحديثة والمبنية بـ Ruby on Rails ولكنها تستهلك ذاكرة أكبر (2 جيجابايت كحد أدنى). منصة Flarum منتدى خفيف وأنيق مبني بـ PHP وتصميم الصفحة الواحدة. برنامج phpBB خيار كلاسيكي عريق. منصة Lemmy شبكة نقاشات لا مركزية شبيهة بـ Reddit مبنية على بروتوكول ActivityPub.

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

تجنب استخدام NodeBB إذا كنت تفضل منصة تصويت ومشاركة روابط شجرية شبيهة بنظام Reddit (استخدم Lemmy بدلاً منه). وإذا كان سيرفرك بمواصفات متواضعة جداً (أقل من 1 جيجابايت RAM)، فإن المنتديات الخفيفة بـ PHP مثل Flarum تستهلك ذاكرة أقل. وإذا كانت مؤسستك تعتمد كلياً على تكاملات معقدة مع Active Directory، فإن Discourse يقدم تكاملات مؤسسية جاهزة أوسع.

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

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

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

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

ما هي قاعدة البيانات التي يعتمد عليها NodeBB؟

يدعم NodeBB كلاً من MongoDB وRedis وPostgreSQL. في هذا التثبيت، تم ربطه بقاعدة بيانات MongoDB 6 التي تقدم أداءً فائقاً واستجابة سريعة جداً للمنتديات النشطة.

لماذا تعد تقنية WebSockets أساسية لـ NodeBB؟

تتيح WebSockets اتصالاً مستمراً ومزدوجاً بين المتصفح والخادم، مما يمكن NodeBB من دفع الإشعارات الفورية وتحديث الردود والمحادثات الحية لحظياً دون الحاجة لتحديث الصفحة يدوياً.

كيف أحل مشكلة خطأ CSRF Token عند تسجيل الدخول؟

يحدث هذا الخطأ عند عدم تطابق رابط الموقع في ملف الإعداد مع شريط المتصفح. عدل ملف /root/docker/nodebb/data/config.json واجعل خاصية 'url' تطابق نطاقك الفعلي مع https:// ثم أعد تشغيل الحاوية.

هل يمكن تثبيت الإضافات من داخل لوحة التحكم مباشرة؟

نعم، تحتوي لوحة تحكم المشرف (ACP) على دليل إضافات مدمج في قسم ACP ← Extend ← Plugins، يتيح لك تثبيت السمات وطرق تسجيل الدخول والأدوات بنقرة زر واحدة.

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

تستهلك حاوية NodeBB بجانب MongoDB معاً ما بين 400 إلى 700 ميجابايت تقريباً من الذاكرة العشوائية في الاستخدام المتوسط، وتعمل بكفاءة على سيرفر بمواصفات 1 إلى 2 جيجابايت RAM.