📊 تثبيت Apache Superset — منصة ذكاء الأعمال والرسوم البيانية التفاعلية على Docker
نشر منصة Apache Superset على Ubuntu باستخدام Docker — المنصة المؤسسية مفتوحة المصدر الرائدة عالمياً لتحليل البيانات واستعلام SQL وبناء لوحات التحكم التفاعلية لذكاء الأعمال على المنفذ 8088.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/analytics/superset/superset-ubuntu.sh
chmod +x superset-ubuntu.sh
sudo bash superset-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/analytics/superset/superset-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x superset-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين لقاعدة البيانات (`./db`) وتوليد المفاتيح السرية وتهيئة كاش Redis وتشغيل ترحيلات البيانات وإطلاق Apache Superset على المنفذ 8088.
sudo bash superset-ubuntu.sh
4 ربط قواعد البيانات وبناء لوحات المؤشرات
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8088. سجل دخولك ببيانات المشرف (`admin`)، واربط قواعد بياناتك (PostgreSQL وMySQL وClickHouse وBigQuery)، واكتب استعلاماتك في SQL Lab وابنِ لوحاتك التفاعلية.
http://<your-server-ip>:8088
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8088 | Apache Superset Web UI & API |
نظرة عامة
تعد Apache Superset منصة ذكاء الأعمال (Business Intelligence - BI) واستكشاف البيانات مفتوحة المصدر الرائدة والأكثر تطوراً في العالم. تعمل المنصة عبر المنفذ 8088، وتتصل بأي قاعدة بيانات تدعم لغة SQL (مثل PostgreSQL وMySQL وClickHouse وSnowflake وTrino وBigQuery وSQLite). وتتضمن بيئة عمل متكاملة لكتابة استعلامات SQL (SQL Lab)، وأكثر من 40 نوعاً من الرسوم والمخططات البيانية المتقدمة (خرائط deck.gl الجغرافية، والخرائط الحرارية، ومخططات السلسلة الزمنية)، ومنشئ مخططات بصري بدون كود، ونظام تحكم دقيق بالصلاحيات (RBAC)، وتقارير بريدية مجدولة.
لماذا تستخدمه
تفرض منصات ذكاء الأعمال التجارية مثل Tableau وPowerBI وLooker اشتراكات شهرية باهظة تُحسب لكل مستخدم وتقيد بياناتك في سحابات مغلقة. تمنحك Apache Superset إمكانيات تحليل واستعراض بيانات مؤسسية بدون أي تكاليف تراخيص، مع الحفاظ على خصوصية بياناتك بنسبة 100% على سيرفر Ubuntu الخاص بك، وإمكانية تضمين الرسوم البيانية داخل تطبيقاتك ومواقعك البرمجية.
متى تحتاجه
- تبحث عن بديل مؤسسي مفتوح المصدر لمنصات Tableau وLooker وPowerBI دون دفع رسوم اشتراك شهرية لكل موظف
- تحتاج إلى محرر SQL Lab متطور لاستعلام قواعد بيانات الشركة واستخراج النتائج بصيغ Excel وCSV
- تريد بناء لوحات مؤشرات تفاعلية للقيادات مع فلاتر حية وخرائط جغرافية ومخططات بيانية متنوعة
- تحتاج إلى جدولة إرسال تقارير دورية عبر البريد الإلكتروني أو Slack تتضمن لقطات شاشة للمؤشرات الأسبوعية
- تريد تضمين رسوم بيانية تفاعلية ولوحات تحكم داخل تطبيق الـ SaaS الخاص بك بأمان
من يحتاجه
- محللو وعلماء البيانات ومهندسو ذكاء الأعمال لاستكشاف مجموعات البيانات الضخمة وبناء لوحات المؤشرات (KPIs)
- مديرو المنتجات والرؤساء التقنيون (CTOs) لمراقبة نمو المشاريع والإيرادات الشهرية ومعدلات الاحتفاظ بالمستخدمين
- مهندسو الـ DevOps ومسؤولو قواعد البيانات لإدارة واستعراض مقاييس البنية التحتية من مكان موحد
- المؤسسات والشركات المالية التي تفرض سياسات أمان صارمة تمنع إرسال البيانات لسحابات خارجية
- أصحاب السيرفرات المنزلية لعرض إحصائيات الأجهزة المنزلية وسجلات المراقبة وأنظمة إنترنت الأشياء
حالات الاستخدام الشائعة
- الاتصال بقاعدة بيانات المتجر الإلكتروني وبناء لوحة تحكم فورية لمتابعة المبيعات اليومية ونسب التحويل
- استعلام قاعدة بيانات ClickHouse تحتوي على 100 مليون سجل في أجزاء من الثانية وتوليد مخططات بيانية فورية
- إنشاء خرائط حرارية ثلاثية الأبعاد بـ deck.gl توضح كثافة توصيل الطلبات ومواقع العملاء بالمدن
- جدولة تقرير بريدي صباح كل إثنين يرسل لقطات PNG للمؤشرات الحيوية لكافة مديري الأقسام
- تضمين لوحة تحليلات تفاعلية داخل تطبيق عملاء React مع عزل بيانات كل عميل عبر سياسات الأمان
الميزات الرئيسية
- اتصال شامل بقواعد البيانات: دعم PostgreSQL وMySQL وClickHouse وSnowflake وBigQuery وTrino وSQLite
- محرر SQL Lab التفاعلي: بيئة كتابة استعلامات تدعم الإكمال التلقائي وتصفح الجداول والتنفيذ متعدد النوافذ
- أكثر من 40 نوعاً من المخططات: مخططات خطية، وأعمدة، وجداول محورية، وخرائط ثلاثية الأبعاد، ومخططات Sankey
- منشئ رسوم بدون كود: سحب وإفلات الأبعاد والمقاييس والفلاتر لبناء المخططات البيانية دون كتابة أكواد SQL
- أذونات دقيقة بنظام RBAC: تخصيص صلاحيات الوصول لقواعد البيانات ولوحات التحكم حسب أدوار المستخدمين
- كاش سريع بـ Redis: تخزين نتائج الاستعلامات مؤقتاً لفتح لوحات التحكم في أجزاء من الثانية
- حزمة التضمين البرمجية (Embedded SDK): تضمين الرسوم البيانية بأمان داخل تطبيقات الويب الخارجية
- معمارية Docker Compose تجمع Superset مع قاعدة بيانات PostgreSQL 15 للإعدادات وكاش Redis
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8088 لعرض صفحة دخول Apache Superset
- سجل الدخول بحساب المشرف (`admin` / كلمة المرور المحددة) ثم غيّر كلمة المرور فورياً من ملفك الشخصي
- انتقل إلى Data ← Databases ← '+ Database' واختر نوع قاعدة بياناتك (مثل PostgreSQL) وأدخل رابط الاتصال
- انتقل إلى SQL Lab ← SQL Editor واكتب استعلاماً تجريبياً (مثل `SELECT * FROM sales;`) واضغط 'Create Chart'
- اختر نوع الرسم البياني المفضل وخصص الألوان والمقاييس واحفظه داخل لوحة تحكم جديدة (Dashboard)
- ضع Apache Superset خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة بيانات الإعدادات `./db`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: غيّر كلمة مرور المشرف الافتراضية واضبط مفتاح `SECRET_KEY` عشوائياً قوياً في ملف الإعدادات
- استخدم تشفير HTTPS دائماً في الإنتاج لحماية استعلامات البيانات الحساسة وتوكنات الجلسات أثناء النقل
- اربط قواعد البيانات الإنتاجية بحسابات مستخدمين ذات صلاحية قراءة فقط (Read-Only) لمنع تعديل البيانات بالخطأ
- طبق سياسات الأمان على مستوى الصفوف (Row Level Security) لعزل بيانات العملاء في البيئات متعددة المستأجرين
- احمِ مجلد البيانات `./db` بصلاحيات نظام مناسبة بالسيرفر
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم Apache Superset واجهة الويب ومحرر SQL والواجهة البرمجية عبر منفذ TCP 8088. يجب السماح بالمنفذ 8088 في جدار الحماية للشبكة المحلية (`ufw allow 8088/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8088، مع إبقاء المنفذ 8088 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./db` احتياطياً، والذي يحتوي على قاعدة بيانات PostgreSQL بكافة اللوحات، والمخططات، والمستخدمين، وسجلات الاستعلام
- احتفظ بنسخة من ملفات `docker-compose.yml` و`superset_config.py` وملف المتغيرات `.env`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع كافة اللوحات المحفوظة بنجاح
الأخطاء الشائعة
- ترك قيمة `SECRET_KEY` الافتراضية بدون تغيير مما يظهر تحذيرات أمان ويضعف تشفير الكوكيز والجلسات
- محاولة تشغيل Superset على سيرفر بذاكرة عشوائية أقل من 2 إلى 4 جيجابايت RAM
- ربط قواعد البيانات الإنتاجية بحسابات تمتلك صلاحية التعديل والحذف بدلاً من مستخدم للقراءة فقط
- عدم ربط مجلد التخزين الدائم `./db`، مما يسبب فقدان اللوحات والمخططات المنشأة عند تحديث الحاوية
- التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL
استكشاف الأخطاء وإصلاحها
- فشل الاتصال بقاعدة البيانات — تأكد من صحة صيغة رابط SQLAlchemy (مثل `postgresql://user:pass@host:5432/dbname`)
- انتهاء مهلة تنفيذ الاستعلامات — ارفع مهلة الاستعلام في ملف `superset_config.py` (`SQLLAB_TIMEOUT = 300`)
- ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs superset -f`
- بطء تحميل المخططات البيانية — تأكد من عمل حاوية كاش Redis واستقرارها (`docker compose ps`)
- فشل تسجيل الدخول — أعد تعيين كلمة مرور المشرف بالأمر: `docker exec -it superset superset fab reset-password --username admin`
البدائل
منصة Metabase السهلة للاستفسارات السريعة. منصة Grafana المتخصصة في السلاسل الزمنية ومراقبة السيرفرات. منصة Redash لمشاركة استعلامات SQL. منصات Tableau وPowerBI التجارية المغلقة. أداة Evidence المعتمدة على الماركداون.
متى لا تستخدمه
تجنب استخدام Apache Superset إذا كنت تبحث عن أداة بسيطة للغاية لطرح الأسئلة واستخراج الإحصائيات للموظفين غير التقنيين بدون معرفة بلغة SQL (حيث تعد Metabase أسهل بكثير وأقل تعقيداً). وإذا كنت تحتاج فقط لمراقبة أداء السيرفرات والمعالجات والشبكات عبر Prometheus، فإن Grafana أكثر تخصصاً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي قواعد البيانات التي يمكن لمنصة Apache Superset الاتصال بها؟
تستطيع Superset الاتصال بأي قاعدة بيانات تدعم محركات SQLAlchemy في بايثون، بما في ذلك PostgreSQL وMySQL وClickHouse وSQLite وSnowflake وGoogle BigQuery وAmazon Redshift وMicrosoft SQL Server.
ما هي بيانات تسجيل الدخول الافتراضية؟
اسم مستخدم المشرف الافتراضي هو `admin`، ويتم توليد كلمة المرور أثناء التثبيت التلقائي (أو تعيينها بأمر `superset fab create-admin`). ويجب تغييرها فور تسجيل الدخول الأول.
ما الفرق بين Apache Superset ومنصة Metabase؟
تركز Metabase على البساطة وسهولة الاستخدام للمستخدمين غير التقنيين بدون كتابة استعلامات، بينما تعد Apache Superset منصة مؤسسية عملاقة توفر بيئة SQL Lab متطورة، وربط قواعد بيانات متعددة، ومخططات جغرافية متقدمة، وتحكماً دقيقاً بالصلاحيات.
هل يمكن تضمين الرسوم البيانية لـ Superset داخل تطبيقات أخرى؟
نعم! توفر Superset حزمة رسمية للتضمين (`@superset-ui/embedded-sdk`) تتيح لك تضمين الرسوم واللوحات التفاعلية داخل تطبيقات React ومواقع الويب بأمان مع تطبيق سياسات الأمان الخاصة بكل عميل.
كيف أقوم بجدولة إرسال التقارير عبر البريد الإلكتروني؟
من خلال تفعيل عمال Celery في Superset، يمكنك ضبط جداول زمنية دورية تلتقط صوراً للوحات التحكم عبر متصفح تلقائي وترسلها كتقارير PDF أو PNG عبر البريد الإلكتروني أو Slack.