🚩 تثبيت Unleash — منصة إدارة أعلام الميزات (Feature Flags) والتفعيل التدريجي على Docker

نشر منصة Unleash على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لإدارة أعلام الميزات البرمجية (Feature Flags)، والإطلاق التدريجي (Canary Releases)، ومفاتيح الإيقاف الفوري على المنفذ 4242.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Unleash على المنفذ 4242 مع قاعدة بيانات PostgreSQL 16 ومفاتيح الـ SDK واللوحة الرسومية جاهزة.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/unleash/unleash-ubuntu.sh

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

chmod +x unleash-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./postgres-data`) وضبط كلمات المرور وتشغيل منصة Unleash على المنفذ 4242.

sudo bash unleash-ubuntu.sh

4 إنشاء حساب المشرف وأول علم ميزة

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:4242. أنشئ حساب المشرف، وأنشئ مشروعك الأول، وعرّف علم ميزة مع نسبة تفعيل تدريجية، واربط حزمة SDK البرمجية بتطبيقك.

http://<your-server-ip>:4242

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

المنفذالغرض
4242Web UI + API (SDKs fetch flags here)
internalPostgreSQL 16 (unleash-db, not published)

نظرة عامة

تعد Unleash المنصة مفتوحة المصدر الرائدة عالمياً لإدارة أعلام الميزات البرمجية (Feature Flags) والتحكم بالإطلاق التدريجي للبرمجيات. تعمل المنصة عبر المنفذ 4242 بالاعتماد على قاعدة بيانات PostgreSQL 16، لتتيح لفرق البرمجة وهندسة المنتجات فصل عملية نشر الكود (Deployment) عن إطلاقه الفعلي للمستخدمين (Release). وتدعم الإطلاق التدريجي بالنسب المئوية (مثل 10% ثم 50% ثم 100%)، وتخصيص الميزات لمستخدمين محددين، ومفاتيح الإيقاف الفوري عند الطوارئ (Kill Switches) دون الحاجة لإعادة بناء أو نشر التطبيقات.

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

يؤدي دمج وتحديث الميزات البرمجية الضخمة مباشرة في بيئات الإنتاج الحية دون أعلام ميزات إلى أعطال مفاجئة وصعوبة في التراجع السريع عند حدوث أخطاء. كما تفرض المنصات السحابية التجارية (مثل LaunchDarkly وSplit) اشتراكات شهرية باهظة وتخزن معرّفات مستخدمي شركتك على سحابات خارجية. تمنحك Unleash منصة مؤسسية مستضافة ذاتياً مع خصوصية تامة بنسبة 100%، وتقييم فوري للأعلام بالذاكرة المحلية دون أي بطء بالشبكة، وتحكم كامل في عمليات الإطلاق الإنتاجي.

متى تحتاجه

  • تريد فصل نشر الأكواد عن إطلاق الميزات للمستخدمين لتمكين المطورين من دمج التعديلات بأمان
  • تريد إطلاق الميزات تدريجياً (Canary Rollouts) مثل تفعيل واجهة جديدة لـ 5% من الزوار ثم زيادتها تدريجياً
  • تحتاج إلى مفتاح إيقاف طوارئ فوري (Kill Switch) لتعطيل الميزات التي تسبب أعطالاً في ثوانٍ دون إعادة نشر الكود
  • تريد إجراء اختبارات A/B وتقسيم المستخدمين وفق معايير مخصصة (معرّف المستخدم، الدولة، المشتركون التجريبيون)
  • تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً لمنصات LaunchDarkly وSplit بدون أي رسوم تراخيص

من يحتاجه

  • فرق هندسة البرمجيات والمطورون لتطبيق استراتيجيات التطوير المستمر (Trunk-Based Development)
  • مديرو المنتجات وقادة الفرق لإجراء اختبارات البيتا وتفعيل الميزات للمستخدمين المؤهلين
  • مهندسو الـ DevOps والـ SRE للحد من مخاطر النشر والتحكم في مفاتيح الإيقاف الفوري عند الطوارئ
  • المؤسسات والشركات ذات معايير الخصوصية الصارمة التي تتطلب تقييم الأعلام محلياً بالسيرفر
  • أصحاب السيرفرات المنزلية لدراسة وتطبيق أحدث المعايير السحابية في إدارة البرمجيات الموزعة

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

  • تفعيل خوارزمية ترشيح ذكية جديدة لفريق العمل والمستخدمين التجريبيين فقط قبل إطلاقها للعامة
  • تفعيل استعلام قاعدة بيانات ثقيل تدريجياً لـ 10% من الزوار لمراقبة استهلاك معالج السيرفر بأمان
  • إظهار وإخفاء لافتة إعلان أو تنبيه صيانة طارئ في كافة تطبيقات الويب والموبايل بضغطة زر واحدة
  • تخصيص الميزات المتقدمة حسب نوع اشتراك العميل (مثل تفعيل ميزة التقارير فقط لحسابات الخطة المؤسسية)
  • إجراء اختبار A/B على طريقتين مختلفتين لتسجيل الحسابات وقياس معدل إكمال التسجيل في الوقت الفعلي

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

  • تفعيل وإيقاف فوري على المنفذ 4242: تشغيل وتعطيل الميزات البرمجية فورياً دون إعادة تشغيل الحاويات أو الخوادم
  • إطلاق تدريجي محدد بنسب مئوية: خوارزميات تجزئة تضمن ثبات تجربة كل مستخدم عند تكرار الزيارة
  • استراتيجيات تفعيل مخصصة: فلترة حسب معرّف المستخدم، أو عنوان الـ IP، أو أسماء السيرفرات، أو متغيرات الـ JSON
  • إدارة بيئات عمل متعددة: عزل إعدادات الأعلام بين بيئات التطوير والتجربة والإنتاج في مشروع واحد
  • حزم SDK سريعة بالذاكرة المحلية: دعم رسمي لـ Node.js وبايثون وGo وجافا وReact وVue وأندرويد وiOS و.NET
  • نظام صلاحيات هرمي دقيق (RBAC): تقييد صلاحيات تعديل الأعلام في بيئة الإنتاج للمشرفين المعتمدين فقط
  • سجل تدقيق وتتبع التعديلات: توثيق زمني كامل لكل تعديل طرأ على أعلام الميزات ومن قام به
  • معمارية Docker Compose تجمع خادم Unleash مع قاعدة PostgreSQL 16 على المنفذ 4242

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:4242 لبدء شاشة إعداد Unleash
  • أنشئ حساب المشرف الأول بالبريد الإلكتروني وكلمة المرور الآمنة
  • اضغط على '+ New Feature Flag' واكتب اسم العلم (مثل `new_checkout_flow`) واضبط استراتيجية التفعيل
  • توجه إلى Project Settings ← API Access وولّد مفتاح API للخادم أو الواجهة الأمامية
  • ثبت حزمة Unleash SDK في تطبيقك البرمجي واضبط رابط السيرفر ومفتاح الـ API
  • ضع Unleash خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./postgres-data`

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

  • تنبيه أمني حاسم: غيّر بيانات المشرف الافتراضية فور تسجيل الدخول لأول مرة
  • استخدم تشفير HTTPS دائماً في الإنتاج لحماية مفاتيح الـ API وإعدادات الأعلام المنقولة بالشبكة
  • استخدم مفاتيح API مقيدة الصلاحيات: مفاتيح Server-Side للخلفية ومفاتيح Frontend للواجهات العامة
  • أبقِ منفذ قاعدة البيانات الداخلي PostgreSQL 5432 معزولاً عن الإنترنت العام
  • احمِ مجلد البيانات `./postgres-data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يقدم Unleash واجهة الويب والواجهة البرمجية للـ SDK عبر منفذ TCP 4242. يجب السماح بالمنفذ 4242 في جدار الحماية للشبكة المحلية (`ufw allow 4242/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 4242، مع إبقاء المنفذ 4242 مغلقاً خارجياً.

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

  • انسخ مجلد `./postgres-data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات PostgreSQL 16 بكافة الأعلام والاستراتيجيات والمستخدمين
  • استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec unleash-db pg_dump -U unleash unleash > unleash_backup.sql`
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع الأعلام بنجاح

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

  • استخدام مفاتيح Server-Side ذات الصلاحيات العالية داخل كود المتصفح بـ React بدلاً من مفاتيح Frontend المقيدة
  • ترك بيانات المشرف الافتراضية بدون تغيير على سيرفر متصل بالإنترنت
  • عدم ربط مجلد التخزين الدائم لقاعدة البيانات، مما يسبب فقدان الأعلام عند تحديث الحاوية
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر مما يعرض مفاتيح الـ API للتنصت
  • كتابة شروط ثابتة في الكود بدلاً من استعلام حالة العلم برمجياً عبر الـ SDK

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

  • ظهور خطأ 502 Bad Gateway في الواجهة — انتظر دقيقة لاكتمال إقلاع الخادم وتطبيق الميجريشنز ثم راجع السجلات: `docker logs unleash-server -f`
  • حزمة الـ SDK تفشل في جلب الأعلام — تأكد من تطابق نوع مفتاح الـ API مع نوع الحزمة (Client مقابل Frontend) وصحة الرابط
  • الأعلام لا تتحدث فورياً بالتطبيق — تأكد من ضبط فترة المزامنة الدورية بالخلفية للـ SDK (الافتراضي 10-15 ثانية)
  • فشل الاتصال بقاعدة البيانات — تأكد من عمل حاوية `unleash-db` وتطابق البيانات بملف `.env`
  • انهيار الحاوية بسبب نفاد الذاكرة — خصص 1 إلى 2 جيجابايت RAM على الأقل لعمليات Node.js وقاعدة البيانات

البدائل

منصة Flagsmith مفتوحة المصدر لأعلام الميزات. منصة PostHog لتحليلات المنتجات وأعلام الميزات. منصة LaunchDarkly التجارية الرائدة. منصة Split.io السحابية. محرك Flipt الخفيف بلغة Go.

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

تجنب استخدام Unleash إذا كنت تعمل على سكريبت بسيط لمطور واحد يحتاج فقط لمتغيرات بيئة ثابتة (حيث يكفي ملف `.env` بسيط). وإذا كنت تحتاج لمنصة شاملة تجمع بين تحليلات المنتجات وتسجيل جلسات المستخدمين وأعلام الميزات في شاشة واحدة، فإن منصة PostHog تجمع الثلاثة معاً.

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

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

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

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

ما هي منصة Unleash وكيف تعمل أعلام الميزات (Feature Flags)؟

تعد Unleash منصة متخصصة لإدارة أعلام الميزات البرمجية. تتيح للمطورين إحاطة الأكواد الجديدة بشروط برمجية (Flags) يمكن تفعيلها أو تعطيلها أو إطلاقها لنسبة محددة من المستخدمين من لوحة تحكم حية دون الحاجة لإعادة نشر الكود.

كيف تقيم Unleash حالة الأعلام بدون التسبب في بطء بالشبكة؟

تقوم مكتبات SDK الخاصة بـ Unleash بتنزيل قواعد الأعلام بالخلفية وتخزينها محلياً، وتقيم دالة `isEnabled()` بالذاكرة الحية في أجزاء من الميكروثانية بدون أي طلبات شبكية إضافية عند كل استعلام.

ما الفرق بين مفاتيح Server-Side ومفاتيح Frontend في Unleash؟

مفاتيح Server-Side مخصصة لخوادم الخلفية (Node.js، بايثون، Go) لتقييم الأعلام بأمان في الذاكرة. بينما مفاتيح Frontend مقيدة الصلاحيات ومخصصة لتطبيقات الويب والموبايل العامة عبر وسيط Unleash Proxy.

هل يمكن تطبيق الإطلاق التدريجي بالنسب المئوية في Unleash؟

نعم! تستخدم Unleash خوارزميات MurmurHash الحتمية لضمان بقاء المستخدم الذي وقع في شريحة الـ 20% مستمتعاً بالميزة الجديدة دائماً عند كل زيارة دون الحاجة لحفظ حالته في ملفات تعريف مؤقتة.

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

تم بناء خادم Unleash بـ Node.js مع قاعدة PostgreSQL 16 بكفاءة بالغة، وتستهلك الحزمة عادة ما بين 250 إلى 600 ميجابايت فقط من الذاكرة العشوائية داخل Docker.