👨💻 تثبيت Flagsmith — أعلام ميزات وإعدادات عن بُعد
انشر Flagsmith على Ubuntu بـ Docker — منصة أعلام ميزات وإعدادات عن بُعد مفتوحة المصدر مع PostgreSQL، تتيح لك تفعيل الميزات حسب البيئة والشريحة والمستخدم الفردي.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/flagsmith/flagsmith-ubuntu.sh
chmod +x flagsmith-ubuntu.sh
sudo bash flagsmith-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/flagsmith/flagsmith-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x flagsmith-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، يُشغّل قاعدة بيانات PostgreSQL 16 بكلمة مرور مُولَّدة، ثم يُطلق Flagsmith على المنفذ 8211 مع فتح التسجيل حتى تتمكن من إنشاء الحساب الأول.
sudo bash flagsmith-ubuntu.sh
4 إنشاء حساب المسؤول
افتح المتصفح وانتقل إلى Flagsmith، ثم سجّل — أول مستخدم مسجَّل يصبح المسؤول:
http://<your-server-ip>:8211
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8211 | Dashboard + API (host → container 8000) |
| internal | PostgreSQL 16 (flagsmith-db, not published) |
نظرة عامة
Flagsmith منصة أعلام ميزات وإعدادات عن بُعد مفتوحة المصدر مبنية بـ Django وPostgreSQL في الخلفية. على عكس نظام تبديل تشغيل/إيقاف بسيط، يمكن لأعلام Flagsmith أن تحمل قيماً — نصاً أو رقماً أو حمولة JSON — فيعمل أيضاً كخدمة إعدادات عن بُعد، ما يتيح لك تغيير سلوك التطبيق من لوحة تحكم ويب دون إصدار بناء جديد. يمكن استهداف الأعلام حسب البيئة أو شريحة المستخدمين أو هوية المستخدم الفردية.
لماذا تستخدمه
تتيح لك أعلام الميزات فصل نشر الكود عن إطلاق الميزات كحدثين منفصلين — انشر ميزة مخفية، ثم فعّلها تدريجياً لنسبة من المستخدمين أو شريحة معيّنة، وارجع عنها فوراً إن حدث خطأ، دون نشر جديد. تُبقي الاستضافة الذاتية لـ Flagsmith تقييم الأعلام وبيانات الإعدادات على بنيتك التحتية الخاصة بدلاً من SaaS من طرف ثالث، ووظائفه الأساسية — الأعلام، الإعدادات عن بُعد، الاستهداف، والاختبار متعدد المتغيرات — مجانية بترخيص BSD-3-Clause المتساهل دون حدود استخدام مصطنعة.
متى تحتاجه
- تريد نشر الكود للإنتاج دون كشف ميزة جديدة فوراً لكل مستخدم
- تحتاج طرح ميزة تدريجياً لنسبة من المستخدمين، أو لشرائح معيّنة، ومراقبتها قبل الإطلاق الكامل
- تريد تغيير سلوك التطبيق أو قيم الإعدادات فوراً دون نشر جديد
- تحتاج مفتاح إيقاف طوارئ لتعطيل ميزة معطلة في الإنتاج دون التراجع عن إصدار كامل
- تُشغّل اختبارات A/B أو تجارب وتحتاج استهدافاً لكل مستخدم أو شريحة
- تريد بنية أعلام ميزات ذاتية الاستضافة بدلاً من الدفع لـ SaaS بسعر لكل مقعد مثل LaunchDarkly
من يحتاجه
- فرق الهندسة التي تمارس النشر المستمر وتحتاج فصل نشر الكود عن إطلاق الميزات
- فرق المنتج التي تُشغّل طروحات مرحلية أو اختبارات A/B وتحتاج استهدافاً لكل شريحة أو مستخدم
- شركات SaaS التي تحتاج تفعيل ميزات حسب كل عميل أو خطة دون نشر كود لكل تغيير
- فرق تطبيقات الموبايل التي لا تستطيع إجبار المستخدمين على التحديث وتحتاج إعدادات عن بُعد لتغيير السلوك بعد الإصدار
- فرق DevOps والمنصات التي تريد بديلاً ذاتي الاستضافة لـ LaunchDarkly لأسباب تكلفة أو إقامة بيانات
- الشركات الناشئة والفرق الصغيرة التي تريد بنية أعلام ميزات دون تسعير SaaS لكل مقعد
حالات الاستخدام الشائعة
- طرح ميزة جديدة تدريجياً لنسبة من المستخدمين مع مراقبة المشكلات
- تفعيل ميزات مميزة حسب خطة الاشتراك أو شريحة العميل دون إعادة نشر الكود
- تعطيل ميزة معطلة في الإنتاج فوراً كمفتاح إيقاف طوارئ
- تشغيل اختبارات A/B بتقديم قيم أعلام مختلفة لشرائح مستخدمين مختلفة
- تغيير قيمة إعداد عن بُعد — نقطة نهاية API، حد معيّن، بعض النصوص — دون إصدار بناء تطبيق موبايل جديد
- منح بيئات QA والتجريب حالات أعلام مختلفة عن الإنتاج للاختبار الآمن
الميزات الرئيسية
- أعلام تحمل قيماً (نص، رقم، JSON)، وليس فقط منطقية، فتعمل أيضاً كخدمة إعدادات عن بُعد
- استهداف حسب البيئة والشريحة وهوية المستخدم الفردية للتحكم الدقيق بمن يرى ماذا
- أعلام متعددة المتغيرات وطروحات مبنية على نسبة مئوية للإصدارات التدريجية واختبار A/B
- REST API وحزم SDK عبر معظم اللغات وأطر العمل الشائعة لقراءة الأعلام في تطبيقك
- لوحة تحكم ويب لإدارة الأعلام والبيئات وقواعد الاستهداف دون لمس الكود
- سجل تدقيق لتغييرات الأعلام حتى ترى من غيّر ماذا ومتى
- الوظائف الأساسية مرخّصة بموجب BSD-3-Clause — مجانية للاستضافة الذاتية دون حدود استخدام مصطنعة
كيفية الاستخدام بعد التثبيت
- سجّل فوراً على http://your-server-ip:8211 — أول مستخدم مسجَّل يصبح المسؤول
- اضبط ALLOW_REGISTRATION_WITHOUT_INVITE على false مباشرة بعد إنشاء حسابك حتى لا يستطيع أحد آخر التسجيل ذاتياً
- أنشئ مشروعك وبيئتك الأولى (مثل Development أو Staging أو Production) لتنظيم أعلامك
- أنشئ أول علم ميزة واختبر تبديله عبر API أو SDK قبل ربطه بكود التطبيق
- أعدّ شرائح مستخدمين إذا احتجت استهداف الأعلام بخصائص مثل مستوى الخطة أو المنطقة أو عمر الحساب
- ثبّت حزمة SDK المناسبة للغة تطبيقك ووجّهها إلى API نسخة Flagsmith لديك
- غيّر DJANGO_ALLOWED_HOSTS من القيمة الافتراضية العامة للمثبّت إلى نطاقك الفعلي قبل الانتقال للإنتاج
أفضل ممارسات الأمان
- اضبط ALLOW_REGISTRATION_WITHOUT_INVITE على false مباشرة بعد إنشاء حساب المسؤول الأول لإغلاق التسجيل المفتوح
- غيّر DJANGO_ALLOWED_HOSTS من الرمز العام الافتراضي (*) إلى نطاقك الفعلي — الرمز العام يقبل طلبات لأي اسم مضيف
- ضع Flagsmith خلف وكيل عكسي مع HTTPS قبل أن يصبح قابلاً للوصول من خارج شبكتك الداخلية
- أبقِ قاعدة بيانات PostgreSQL داخلية ضمن شبكة Docker فقط — يجب ألا تُكشف أبداً للمضيف أو الإنترنت
- استخدم بيانات اعتماد قوية وفريدة لحساب المسؤول، لأنه يستطيع التحكم في سلوك الميزات عبر تطبيقك بالكامل
- قيّد مفاتيح API على أقل نطاق بيئة مطلوب — لا تستخدم مفتاح سيرفر إنتاجي في كود جانب العميل
- راجع سجل التدقيق دورياً بحثاً عن تغييرات أعلام غير متوقعة، خاصة في بيئات الإنتاج
المنافذ وإعدادات جدار الحماية
تستمع لوحة تحكم Flagsmith وAPI على منفذ المضيف 8211، المُعيَّن من منفذ الحاوية الداخلي 8000. تجلب حزم SDK الخاصة بتطبيقك قيم الأعلام من نفس هذا المنفذ، لذا يجب أن يكون قابلاً للوصول من حيث تعمل تطبيقاتك، لكن يجب ألا يُكشف أبداً مباشرة للإنترنت العام دون وكيل عكسي يوفر HTTPS. يعمل PostgreSQL 16، الذي يخزّن كل بيانات الأعلام والبيئات والمستخدمين، كحاوية داخلية فقط (flagsmith-db) غير منشورة للمضيف ويجب أن تبقى محمية بجدار حماية من أي وصول خارجي.
النسخ الاحتياطي والصيانة
- انسخ حجم بيانات PostgreSQL احتياطياً بانتظام — فهو يحمل كل علم وبيئة وشريحة وحساب مستخدم
- خزّن كلمة مرور PostgreSQL المُولَّدة بأمان مع نسخك الاحتياطية حتى تتمكن من إعادة الاتصال بعد الاستعادة
- صدّر إعدادات أعلامك وبيئاتك دورياً كطبقة استعادة إضافية بجانب نسخة قاعدة البيانات الاحتياطية
- استخدم pg_dump أو أداة مشابهة أصلية لـ PostgreSQL للحصول على لقطات متسقة وقابلة للاستعادة بدلاً من نسخ ملفات خام
- اختبر استعادة نسخة احتياطية على نسخة منفصلة للتأكد أن الأعلام وقواعد الاستهداف والمستخدمين تعود بشكل صحيح
- انسخ ملف docker-compose.yml وإعدادات متغيرات البيئة احتياطياً حتى يمكن إعادة نشر المجموعة بنفس الإعدادات
الأخطاء الشائعة
- ترك ALLOW_REGISTRATION_WITHOUT_INVITE مفعّلاً بعد الإعداد، ما يسمح لأي شخص بتسجيل حساب على نسختك
- ترك DJANGO_ALLOWED_HOSTS على القيمة الافتراضية العامة للمثبّت بدلاً من ضبطها على نطاقك الفعلي
- كشف المنفذ 8211 مباشرة للإنترنت دون وكيل عكسي وTLS أمامه
- استخدام مفتاح API لسيرفر إنتاجي داخل كود جانب العميل أو تطبيق موبايل، ما يكشفه للمستخدمين النهائيين
- عدم إنشاء بيئات منفصلة للتطوير والتجريب والإنتاج، ما يخلط أعلام الاختبار بالأعلام الحقيقية
- نسيان أن RBAC وSAML/SSO وبعض تكاملات قواعد البيانات هي ميزات Enterprise Edition تتطلب ترخيصاً منفصلاً
استكشاف الأخطاء وإصلاحها
- تعذّر التسجيل — تحقق أن ALLOW_REGISTRATION_WITHOUT_INVITE لم يُعطَّل بالفعل إذا كنت تحاول إنشاء الحساب الأول فعلياً
- واجهة الويب غير قابلة للوصول — تحقق أن DJANGO_ALLOWED_HOSTS يتضمن اسم المضيف الذي تستخدمه للوصول إليها
- الأعلام لا تتحدّث في التطبيق — تحقق من إعدادات الاستطلاع أو البث في SDK وتأكد أنها تشير إلى مفتاح API الصحيح للبيئة
- الحاوية لا تبدأ — تحقق أن حاوية PostgreSQL flagsmith-db بدأت بنجاح أولاً، لأن Flagsmith يعتمد عليها
- API يُرجع قيم أعلام غير متوقعة — تحقق أنك تستخدم مفتاح API الصحيح للبيئة، لأن مفاتيح التطوير والتجريب والإنتاج تختلف
- تقييم أعلام بطيء — تحقق أن SDK يستخدم تقييماً محلياً للأعلام أو تخزيناً مؤقتاً بدلاً من استطلاع API لكل طلب
البدائل
Unleash منصة أخرى شائعة مفتوحة المصدر وذاتية الاستضافة لأعلام الميزات، أكثر تركيزاً على التبديل باستراتيجيات تفعيل قوية جداً لكن دون دعم Flagsmith المدمج لقيم الإعدادات عن بُعد. LaunchDarkly هو الرائد التجاري المصقول بأعمق مجموعة ميزات مؤسسية، لكنه SaaS فقط ويُسعَّر لكل مقعد، ما يجعل التكلفة تتصاعد. ConfigCat وSplit.io خياران تجاريان مُستضافان أيضاً بفئات مجانية لكنهما يُبقيان بيانات أعلامك على بنيتهما التحتية بالمثل. يركّز GrowthBook أكثر على التجريب وتحليل اختبار A/B من إدارة الأعلام الخالصة. للفرق التي تريد أعلاماً تعمل أيضاً كإعدادات عن بُعد، ذاتية الاستضافة بترخيص متساهل حقاً، يملأ Flagsmith مكانة محددة بين تركيز Unleash على التبديل ونموذج LaunchDarkly التجاري فقط.
متى لا تستخدمه
إذا كان فريقك صغيراً جداً ونادراً ما يحتاج طروحات تدريجية أو استهدافاً لكل شريحة، فقد يكفيك متغير بيئة بسيط أو ملف إعدادات — تشغيل منصة أعلام ميزات كاملة يضيف عبئاً تشغيلياً بفائدة قليلة بهذا الحجم. Flagsmith أيضاً ليس الخيار المناسب إذا احتجت تحديداً ميزات Enterprise مثل RBAC أو SAML/SSO دون الدفع مقابل ترخيص، لأنها محجوبة في نسخة Enterprise. وإذا أراد فريقك SaaS مُدار بالكامل بلا صيانة مع دعم مخصص ولا يمانع تكلفة لكل مقعد، فإن منصة مُستضافة مثل LaunchDarkly تزيل العبء التشغيلي لتشغيل Flagsmith بنفسك.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين Flagsmith وUnleash؟
كلاهما منصتا أعلام ميزات ذاتية الاستضافة. تحمل أعلام Flagsmith قيماً — نصاً أو رقماً أو حمولة JSON — فيعمل أيضاً كخدمة إعدادات عن بُعد، ويستهدف هويات المستخدمين الفردية إلى جانب الشرائح. Unleash أكثر تركيزاً على التبديل باستراتيجيات تفعيل قوية جداً.
ما بيانات الاعتماد الافتراضية؟
لا توجد. يفعّل المثبّت التسجيل، وأول مستخدم يسجّل على المنفذ 8211 يصبح المسؤول. أنشئ حسابك فوراً، ثم اضبط ALLOW_REGISTRATION_WITHOUT_INVITE على false حتى لا يستطيع أحد آخر التسجيل على نسختك.
ما المنفذ الذي يستخدمه Flagsmith؟
يُعيّن سكريبت التثبيت منفذ المضيف 8211 لمنفذ الحاوية الداخلي 8000، بحيث تصل للوحة التحكم وAPI عبر http://your-server-ip:8211. تجلب حزم SDK الأعلام من نفس المنفذ، لذا يجب أن يكون قابلاً للوصول من حيث تعمل تطبيقاتك.
ما هي الإعدادات عن بُعد وكيف يقدّمها Flagsmith؟
علم Flagsmith ليس مجرد تشغيل أو إيقاف — يمكنه حمل قيمة مثل نص أو رقم أو حمولة JSON. هذا يعني أنك تستطيع تغيير نقطة نهاية API، أو حد معيّن، أو بعض النصوص من واجهة الويب ويلتقطها تطبيقك دون بناء جديد، وهو أمر قيّم خاصة لتطبيقات الموبايل التي لا يمكنك إجبارها على التحديث.
لماذا يجب أن أغيّر DJANGO_ALLOWED_HOSTS؟
يضبطه المثبّت على الرمز العام *، الذي يقبل طلبات لأي اسم مضيف. هذا جيد على شبكة خاصة لكنه إعداد ضعيف بمجرد أن تواجه النسخة الإنترنت. اضبطه على نطاقك الفعلي وأعد تشغيل الحاوية حتى يخدم Django فقط طلبات المضيف الذي تتوقعه.