توثيق Nibleaf
البدء

ثبّت Nibleaf على خادم Linux واحد

ثبّت إصدار Nibleaf المثبّت باستخدام برنامج التثبيت الموجّه أو Docker Compose، ثم تحقق من عمليات الترحيل والتسجيل والتخزين والنشر.

  • 2 دقيقة قراءة
  • آخر تحديث 22‏/08‏/2026

يسحب مسار الإنتاج الموصى به صورة متعددة البنى ومثبتة الإصدار من GHCR. ولا يجمع المستودع الأحادي على الخادم. أكمل هذا الدليل التعليمي على مضيف مؤقت قبل نقل المحتوى الحقيقي.

المتطلبات المسبقة

جهّز ما يلي:

  • مضيف Linux عليه Docker Engine وDocker Compose v2 (docker compose)؛
  • الأدوات curl وsed وOpenSSL؛
  • اسم مضيف للوحة التحكم واسم مضيف منفصل للتخزين يمكن الوصول إليه من المتصفح؛
  • وكيلاً عكسيًا يدعم TLS؛
  • بريدًا إلكترونيًا صادرًا عند تفعيل التحقق بالبريد الإلكتروني؛
  • سعة منفصلة كافية للنسخ الاحتياطية من Postgres وتخزين الكائنات.

تحقق من الأدوات المطلوبة:

bash
docker --version
docker compose version
curl --version
openssl version

شغّل برنامج التثبيت الموجّه

لأقصر مسار، شغّل برنامج التثبيت التفاعلي الرسمي من طرفية SSH:

bash
curl -fsSL https://nibleaf.com/install.sh | sh

إذا كانت سياسة الأمان لديك تتطلب الفحص قبل التنفيذ، فنزّل البرنامج النصي نفسه وراجعه أولًا:

bash
curl -fsSLo nibleaf-install.sh https://nibleaf.com/install.sh
less nibleaf-install.sh
sh nibleaf-install.sh

يتحقق برنامج التثبيت من الأدوات المحلية، ويطلب الأصول العامة، وينشئ أسرارًا جديدة، ويكتب ملف .env بصلاحيات الوضع 600، وينزّل ملف Compose الخاص بالإنتاج، ويسحب الصورة المثبتة الإصدار، ثم يشغّل المنظومة. مجلد التثبيت الافتراضي هو $PWD/nibleaf.

ثبّت يدويًا

استخدم هذا المسار عندما تكون إدارة الإعدادات مسؤولة عن ملف البيئة:

bash
git clone https://github.com/lord007tn/nibleaf.git
cd nibleaf
cp .env.production.example .env

عيّن كل قيمة مطلوبة في .env. أنشئ أسرارًا مستقلة؛ ولا تُعد استخدام قيم الأمثلة أو التطوير أو قيم بيئة أخرى مطلقًا:

bash
openssl rand -hex 32
openssl rand -base64 24

ثم اسحب الإصدار المثبت وشغّله:

bash
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

تطبّق خدمة migrate ذات التشغيل الواحد عمليات ترحيل Prisma قبل بدء خدمات التطبيق.

تحقق من أول نتيجة

شغّل:

bash
docker compose -f docker-compose.prod.yml ps
docker compose -f docker-compose.prod.yml logs migrate
docker compose -f docker-compose.prod.yml logs --tail=100 server worker app

ينبغي أن تكون جميع الخدمات طويلة التشغيل سليمة، وأن تنتهي migrate بنجاح. افتح $APP_URL/sign-up، وأنشئ المالك الأول، وارفع صورة واحدة، وانشر مشروعًا من صفحتين. تحقق من عنوان URL للصورة ومن البحث بعد تسجيل الخروج.

إذا كانت إحدى الخدمات غير سليمة، فلا تُعد إنشاء المنظومة مرارًا. اقرأ أول خطأ لهذه الخدمة واستخدم استكشاف الأخطاء وإصلاحها. قبل دعوة الكتّاب، أكمل إعدادات الإنتاج وقائمة التحقق للإنتاج ونفّذ عملية مجرّبة لـالنسخ الاحتياطي والاستعادة.