⚙️ تثبيت Komodo — بناء ونشر وإدارة Docker على نطاق واسع
انشر Komodo على Ubuntu — منصة مبنية بلغة Rust لبناء ونشر وإدارة الحاويات والحزم والسيرفرات عبر أسطولك بالكامل من واجهة ويب واحدة.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/management/komodo/komodo-ubuntu.sh
chmod +x komodo-ubuntu.sh
sudo bash komodo-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/management/komodo/komodo-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x komodo-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، ويشغّل قاعدة بيانات MongoDB 6، ثم يطلق Komodo Core وعميل Periphery على المنفذ 9120. تُطبع الأسرار المُولَّدة (passkey وJWT وwebhook) في النهاية.
sudo bash komodo-ubuntu.sh
4 إنشاء حساب المشرف
افتح متصفحك وانتقل إلى Komodo، ثم سجّل أول حساب — سيصبح هو المشرف:
http://<your-server-ip>:9120
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 9120 | Komodo Core Web UI + API |
| internal | MongoDB 6 + Periphery agent (not published) |
نظرة عامة
Komodo منصة مفتوحة المصدر مبنية بلغة Rust لبناء ونشر وإدارة حاويات Docker وحزم Compose وسيرفرات كاملة من واجهة ويب واحدة. تتكون من جزأين: Komodo Core الذي يستضيف الواجهة البرمجية وقاعدة البيانات ولوحة التحكم، وKomodo Periphery وهو عميل خفيف يُثبَّت على كل سيرفر تريد إدارته. يعامل Core عمليات البناء المرتبطة بـ Git وحزم Compose المُصدَّرة كميزات أساسية من الدرجة الأولى، مع إعادة نشر تلقائية عبر webhook، لذا يتصرف بقدر كبير كنظام CI/CD خفيف بقدر ما يتصرف كمدير حاويات.
لماذا تستخدمه
يمنحك Komodo مكاناً واحداً لبناء ونشر ومراقبة الحاويات عبر أسطول كامل من السيرفرات بدلاً من التنقل بين أوامر Docker أو Compose منفصلة على كل جهاز. ولأنه يخزّن كل تعريف حزمة وإعداد بناء وإجراء نشر مع سجل إصدارات كامل، تحصل على مسار تدقيق لما تغيّر ومتى، بالإضافة إلى تراجع بضغطة واحدة. وعلى عكس بعض الأدوات المنافسة، لا يملك Komodo طبقة مدفوعة تحجب الميزات المتقدمة — كل سيرفر تربطه وكل قدرة، بما فيها البناء المُطلَق بواسطة Git، متاحة بلا تكلفة تحت رخصته مفتوحة المصدر.
متى تحتاجه
- تدير حاويات Docker أو حزم Compose عبر أكثر من سيرفر واحد وتريد لوحة تحكم واحدة بدلاً من الاتصال بكل جهاز عبر SSH
- تريد أن تُطلق أحداث Git push أو webhook إعادة بناء تلقائية للصور وإعادة نشر للحزمة المقابلة
- تحتاج مسار تدقيق واضح لتغييرات الإعداد وعمليات النشر ومن أطلقها عبر بنيتك التحتية
- تريد صلاحيات محددة النطاق حتى يستطيع أعضاء فريق مختلفون إدارة السيرفرات أو الحزم المخصصة لهم فقط
- تجاوزت سير عمل docker compose up اليدوي وتريد إجراءات تربط عدة خطوات نشر معاً
من يحتاجه
- مشغّلو المختبرات المنزلية وأصحاب الاستضافة الذاتية الذين يشغّلون أحمال Docker عبر أجهزة فيزيائية أو افتراضية متعددة
- الفرق الصغيرة والشركات الناشئة التي تحتاج نشراً بأسلوب CI/CD خفيف دون تبني منصة ثقيلة مثل Kubernetes
- مهندسو DevOps الذين يريدون بناءً مُطلَقاً بواسطة Git ونشر Compose مُصدَّر مع سجل تغييرات كامل
- الوكالات والمستقلون الذين يديرون بنية تحتية Docker لعدة عملاء من مركز تحكم مركزي واحد
- المطورون الذين يفضّلون أداة سريعة منخفضة الحمل مبنية أصلياً بـ Rust على واجهات إدارة حاويات مبنية بـ Java أو Node
- مسؤولو الأنظمة الذين يحتاجون توحيد وتدقيق طريقة نشر الحاويات عبر أسطول سيرفرات متنامٍ
حالات الاستخدام الشائعة
- إدارة مركزية لحاويات Docker وحزم Compose العاملة عبر أسطول من السيرفرات
- إطلاق بناء صور تلقائي وإعادة نشر من دفعات Git أو webhooks
- التراجع بحزمة إلى إعداد سابق معروف الصلاحية بضغطة واحدة بعد نشر فاشل
- ربط إجراءات نشر متعددة الخطوات — بناء، اختبار، نشر، إشعار — في سير عمل واحد قابل لإعادة الاستخدام
- منح أعضاء الفريق وصولاً محدود النطاق فقط للسيرفرات أو الحزم المرتبطة بدورهم
- استبدال سير عمل SSH وdocker compose العشوائي بعملية نشر موثّقة وقابلة للتدقيق
الميزات الرئيسية
- بنية Core/Periphery — يستضيف Core لوحة التحكم والواجهة البرمجية، وPeriphery عميل خفيف لكل سيرفر
- بناء صور متكامل مع Git يُطلَق تلقائياً عند الدفع أو عبر webhook، مع الاحتفاظ بسجلات البناء في الواجهة
- نشر حزم Compose مُصدَّرة مع سجل إعداد كامل وتراجع بضغطة واحدة لأي إصدار سابق
- صلاحيات محددة النطاق للموارد بحيث يمكن تقييد المستخدمين أو الفرق بسيرفرات أو حزم أو عمليات بناء معينة
- إجراءات نشر تربط عدة إجراءات (بناء، نشر، فحص صحة، إشعار) في خط أنابيب قابل للتكرار
- سجلات حاويات وإحصاءات ووصول طرفية فورية للسيرفرات المُدارة مباشرة من واجهة الويب
- دعم لأي مزود Git (GitHub وGitLab وGitea) وأي سجل حاويات (Docker Hub وGHCR وAWS ECR أو ذاتي الاستضافة)
- مفتوح المصدر بالكامل تحت رخصة GPL-3.0 دون طبقة مدفوعة — سيرفرات غير محدودة ووصول كامل للواجهة البرمجية للجميع
كيفية الاستخدام بعد التثبيت
- افتح Komodo Core في متصفحك وسجّل أول حساب مستخدم، الذي يُمنح تلقائياً صلاحيات المشرف
- راجع الأسرار المُولَّدة (passkey وسر JWT وسر webhook) التي طبعها المثبّت واحفظها في مكان آمن
- ثبّت عميل Komodo Periphery على أي سيرفرات إضافية تريد إدارتها وسجّلها من لوحة تحكم Core
- اربط مزود Git (GitHub أو GitLab أو Gitea) إذا كنت تخطط لاستخدام بناء صور أو نشر Compose مُطلَق بواسطة Git
- أنشئ أول حزمة Compose أو نشر مستقل لديك وتأكد أنه يبدأ بشكل صحيح على السيرفر المستهدف
- أعدّ webhook على مستودع Git لديك حتى تُطلق الدفعات إعادة بناء وإعادة نشر تلقائية في Komodo
- ادعُ أعضاء الفريق وامنحهم صلاحيات محددة النطاق مقتصرة على السيرفرات أو الحزم التي يجب أن يديروها
- ابنِ إجراء نشر يربط خطوات البناء والنشر والإشعار لسير عمل الإصدار الأكثر شيوعاً لديك
أفضل ممارسات الأمان
- غيّر مفتاح passkey وسر JWT المُولَّدين افتراضياً إن لم تترك المثبّت يولّد قيماً عشوائية قوية
- ضع Komodo Core خلف وكيل عكسي مع HTTPS قبل السماح بأي وصول يتجاوز شبكتك المحلية
- لا تكشف منفذ عميل Periphery مباشرة للإنترنت أبداً — يجب أن يكون متاحاً فقط من Komodo Core
- استخدم الصلاحيات محددة النطاق لتطبيق مبدأ أقل امتياز بدلاً من منح كل عضو فريق صلاحيات مشرف
- أبقِ MongoDB غير منشورة ومتاحة فقط على شبكة Docker الداخلية، ولا تكشفها أبداً على الواجهة العامة للمضيف
- دوّر أسرار webhook دورياً وفوراً إذا تعرّض مستودع أو نظام CI يملك الوصول إليها للاختراق
- راجع سجل النشاط بانتظام للتأكد أن عمليات النشر وتغييرات الإعداد تطابق ما يتوقعه فريقك
- حافظ على تحديث صور Komodo Core وPeriphery وMongoDB لاستلام تصحيحات الأمان من المصدر
المنافذ وإعدادات جدار الحماية
يقدّم Komodo Core واجهة الويب والواجهة البرمجية على المنفذ 9120 على المضيف، وهو المنفذ الوحيد الذي تحتاج عادة كشفه، وفقط للشبكات الموثوقة أو خلف وكيل عكسي مع HTTPS. تتواصل MongoDB وعميل Periphery عبر شبكة Docker الداخلية افتراضياً وغير منشورة للمضيف، لذا لا شيء لفتحه في جدار الحماية لهما على نفس الجهاز مع Core. إذا ثبّت Periphery على سيرفر بعيد منفصل، يجب أن يكون منفذ Periphery لذلك السيرفر متاحاً من Core، لكن يجب أن يظل محمياً بجدار حماية يقبل الاتصالات فقط من عنوان IP الخاص بـ Core بدلاً من الإنترنت المفتوح.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً حجم ./mongo، الذي يحمل كل إعداد Komodo — السيرفرات والحزم وعمليات البناء والإجراءات وسجل النشر
- احتفظ بنسخة من docker-compose.yml أو ملف البيئة المُولَّد من المثبّت حتى يمكن إعادة إنشاء Core وPeriphery وMongoDB مطابقة
- صدّر أو دوّن الأسرار المُولَّدة (passkey وJWT وwebhook) منفصلة في مدير كلمات مرور في حال فقدان ملف البيئة
- إذا كنت تستخدم بناءً مُطلَقاً بواسطة Git، فمصدر الحقيقة الفعلي يعيش في Git أيضاً — تأكد من نسخ تلك المستودعات احتياطياً بشكل مستقل
- قبل ترقيات إصدار Komodo الكبرى، خذ لقطة من حجم ./mongo حتى تستطيع التراجع بنظافة إذا سببت الترقية مشاكل
- اختبر دورياً استعادة نسخة احتياطية على سيرفر احتياطي للتأكد أن نسخة MongoDB أو الحجم المحفوظة قابلة للاستخدام فعلياً
الأخطاء الشائعة
- كشف منفذ عميل Periphery مباشرة للإنترنت العام بدلاً من تقييده على عنوان IP الخاص بـ Core فقط
- ترك واجهة ويب Komodo Core متاحة عبر HTTP عادي على الإنترنت العام دون وكيل عكسي يضيف HTTPS
- منح كل عضو فريق مدعو صلاحيات مشرف كاملة بدلاً من استخدام صلاحيات محددة النطاق لأقل امتياز
- نسيان نسخ حجم ./mongo احتياطياً، ثم فقدان كل إعدادات الحزم والبناء والإجراءات بعد عطل السيرفر
- عدم تسجيل الحساب الأول فوراً بعد التثبيت، مما يترك نافذة قصيرة يستطيع فيها أي شخص يصل للواجهة الاستحواذ على صلاحيات المشرف
- تشغيل مكدس Komodo كامل على كل سيرفر مُدار بدلاً من تثبيت عميل Periphery الخفيف فقط
- تخطي إعداد سر webhook، مما يسمح بطلبات غير موثّقة بإطلاق إعادة بناء وإعادة نشر
- تجاهل سجلات البناء والنشر بعد تفعيل الأتمتة، مما يفوّت عمليات إعادة نشر فاشلة حتى يتعطل شيء في الإنتاج
استكشاف الأخطاء وإصلاحها
- تعذّر الوصول لواجهة الويب — تحقق أن حاوية komodo-core تعمل بـ docker ps وأن المنفذ 9120 غير محظور بواسطة ufw
- عميل Periphery يظهر منقطعاً — تأكد أن منفذ العميل متاح من Core وأن قواعد جدار الحماية تسمح بهذا الاتصال المحدد
- أخطاء اتصال MongoDB عند البدء — تحقق من صلاحيات حجم ./mongo وتأكد أن حاوية MongoDB بدأت قبل Core
- عمليات البناء المُطلَقة بواسطة Git لا تعمل — تحقق أن رابط webhook والسر المُعدّين في مزود Git يطابقان ما يتوقعه Komodo
- النشر عالق أو فاشل — راجع سجلات البناء والنشر في واجهة Komodo لمعرفة الخطأ المحدد من Docker أو Compose
- تعذّر تسجيل الدخول بعد اكتمال المثبّت — تأكد أنك تسجّل أول حساب على الإطلاق، الذي يُمنح تلقائياً صلاحيات مشرف
- فقدان الأسرار بعد إعادة إنشاء حاوية — أعد توليد passkey وسر JWT في ملف البيئة وأعد تشغيل Komodo Core
- أداء بطيء للوحة التحكم مع اتصال سيرفرات كثيرة — تحقق من تخصيص موارد MongoDB واستهلاك المعالج والذاكرة في مضيف Core
البدائل
Portainer واجهة إدارة Docker عامة الغرض أكثر نضجاً بمجتمع كبير ونسخة Business مدفوعة للميزات المتقدمة مثل OAuth وإدارة عملاء الحافة على نطاق واسع؛ لا يملك Komodo مثل هذا الحاجز المدفوع ويعامل بناء Git كوظيفة أساسية لا إضافة. Dockge واجهة أخف بكثير تركز على Compose موجهة للمختبرات المنزلية وتفتقر لإدارة أسطول متعدد السيرفرات وخط أنابيب البناء المُطلَق بواسطة Git الذي يملكه Komodo. يجعل انقسام Portainer الأقدم بين Business/Community وتصميم Rancher المرتكز على Kubernetes كليهما أثقل أو أضيق ملاءمة حسب ما إذا كنت تدير Docker عادياً أو عنقود Kubernetes. للفرق التي تريد بناءً مدفوعاً بـ Git ونشر Compose مُصدَّر وإدارة عبر الأسطول بالكامل في أداة واحدة مبنية أصلياً بـ Rust ومفتوحة المصدر بالكامل، يُعد Komodo أحد أقوى الخيارات المتاحة.
متى لا تستخدمه
Komodo ليس الأداة المناسبة إذا كنت تشغّل Kubernetes بالفعل وتحتاج طبقة إدارة أصلية لـ Kubernetes — Komodo مبني حول Docker وDocker Compose، وليس بيانات Kubernetes الوصفية. إذا كنت تدير سيرفراً واحداً فقط وتريد واجهة حاويات بسيطة بالنقر دون تكامل Git أو ميزات أسطول، فقد تكون أداة أخف مثل Dockge أو نسخة Portainer المجانية أبسط للتعلم. الفرق المستثمرة بعمق بالفعل في منصة CI/CD كاملة مثل GitLab CI أو GitHub Actions للبناء قد تجد نظام بناء Komodo زائداً عن الحاجة، رغم أن جانب النشر وإدارة الأسطول لديه ما زال يضيف قيمة عند طبقته فوق ذلك. لكن لأي شيء يتجاوز حفنة من السيرفرات بسير عمل نشر حقيقي، يستحق مزيج Komodo من البناء والحزم المُصدَّرة والصلاحيات مكانه.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين Komodo Core وPeriphery؟
يستضيف Komodo Core واجهة الويب والواجهة البرمجية وقاعدة البيانات وينسّق كل شيء. عميل Periphery عملية خفيفة تعمل على كل سيرفر تريد إدارته وتنفّذ أوامر Docker هناك. يتصل Core بعميل Periphery واحد أو أكثر.
كيف أضيف سيرفراً آخر إلى Komodo؟
ثبّت عميل Komodo Periphery على السيرفر الآخر وسجّله في Core. لا تُشغّل مكدس Komodo كاملاً لكل جهاز، بل العميل الخفيف فقط. بمجرد الاتصال، تصبح حاويات وموارد ذلك السيرفر قابلة للإدارة من واجهتك المركزية.
أي منفذ يستخدمه Komodo؟
يقدّم Komodo Core واجهة الويب والواجهة البرمجية على المنفذ 9120 على المضيف، فتصل إليه عبر http://your-server-ip:9120. تتواصل MongoDB وعميل Periphery عبر شبكة Docker الداخلية وهي غير منشورة.
هل يحتاج Komodo قاعدة بيانات؟
نعم. يشغّل هذا النشر MongoDB 6 في حاوية komodo-mongo لتخزين الإعداد والحزم والإجراءات وسجل النشر. تبقى البيانات محفوظة في حجم ./mongo. FerretDB مدعوم أيضاً من المصدر كبديل مدعوم بـ Postgres.
كيف يختلف Komodo عن Portainer؟
كلاهما يدير Docker عبر عدة أجهزة، لكن Komodo مبني بلغة Rust ويعامل بناء الصور المرتبط بـ Git وحزم Compose المُصدَّرة كميزات أساسية، مع إعادة نشر مُطلَقة عبر webhook. Portainer واجهة عامة أكثر نضجاً بنسخة Business مدفوعة للميزات المتقدمة.