لماذا مدير مرئي لـ Docker Compose
بمجرد أن تبدأ بتشغيل أكثر من حفنة من حُزم Docker Compose، فإن سير العمل المتمثّل في الاتصال بكل خادم عبر SSH، والانتقال إلى المجلد الصحيح، وتشغيل docker compose up -d أو docker compose logs، يصبح مُرهقاً بسرعة. يجمع Dockge كل هذا في علامة تبويب واحدة في المتصفح: ترى كل حُزمة وحالتها الحيّة وسجلّاتها في لمحة. إنشاء حُزمة جديدة هو مجرد نموذج — تلصق فيه ملف compose.yaml وتضغط Start. لا مدير ملفات، ولا SSH.
ما الذي يمنحك إياه Dockge المُستضاف ذاتياً
- محرّر مرئي لملفات
compose.yaml— أنشئ الحُزم أو حرّرها مباشرة في المتصفح مع تلوين الصياغة. - تشغيل وإيقاف وإعادة تشغيل وتحديث بنقرة واحدة لكل حُزمة — دون الحاجة إلى SSH أو حفظ أوامر compose.
- بثّ السجلّات الحيّ لكل حُزمة ولكل حاوية، مع مخرجات مُلوّنة بالرموز.
- لوحة حالة في الزمن الحقيقي تُظهر أي الحُزم قيد التشغيل أو متوقفة أو في حالة خطأ.
- دعم تعدّد النسخ (الإصدار v1.4+): أدِر نسخ Dockge على مضيفات Docker بعيدة من واجهة رئيسية واحدة.
- يعمل كحاوية واحدة بأقل من 150 MB من الذاكرة — آمن للإضافة إلى أي خادم VPS قائم دون التأثير على أحمال العمل الجارية.
المتطلبات
خادم VPS بنظام Ubuntu 22.04 (أو Debian 12) مع تثبيت Docker وDocker Compose v2 مسبقاً. يحتاج Dockge نفسه إلى أقل من 150 MB من الذاكرة وبضعة MB من القرص لقاعدة بيانات SQLite الخاصة به. لا يلزم اسم نطاق — يقدّم Dockge واجهته على المنفذ 5001 عبر HTTP عادي، ويمكن الوصول إليها عبر عنوان IP الخاص بخادمك. إذا أردت HTTPS، فضَع وكيلاً عكسياً Caddy أو Nginx أمامه وأصدِر شهادة Let's Encrypt.
انشر Dockge باستخدام Docker Compose
أنشئ مجلد الحُزم
يخزّن Dockge كل حُزمة يديرها كملف compose.yaml ضمن مجلد مخصّص على المضيف — /opt/stacks افتراضياً. أنشئه قبل تشغيل الحاوية: mkdir -p /opt/stacks. يقوم Dockge بتحميل هذا المجلد داخل الحاوية بحيث تبقى الملفات محفوظة عبر عمليات إعادة تشغيل الحاوية والترقيات.
اكتب ملف Compose
أنشئ /opt/dockge/compose.yaml بالمحتوى التالي. تُحمّل الحاوية مقبس Docker (/var/run/docker.sock) لتتمكّن من إدارة الحاويات الأخرى على المضيف نفسه، ومجلد /opt/stacks لتتمكّن من قراءة ملفات الحُزم والكتابة فيها، وحجماً مُسمّى لقاعدة بيانات SQLite الخاصة بها. اضبط DOCKGE_STACKS_DIR ليطابق مسار المضيف الذي اخترته.
شغّل Dockge
شغّل docker compose up -d داخل /opt/dockge. حجم الصورة (louislam/dockge:1) نحو 200 MB عند السحب الأول. بمجرد التشغيل، افتح http://<your-server-ip>:5001 في متصفحك. سيطلب منك Dockge إنشاء حساب مسؤول عند الزيارة الأولى — اضبط كلمة مرور قوية على الفور.
أضف حُزمتك الأولى
انقر « + Compose » في واجهة Dockge، وامنح الحُزمة اسماً (يصبح هذا المجلد الفرعي ضمن /opt/stacks)، والصق محتوى ملف compose.yaml الخاص بك، ثم اضغط Start. يشغّل Dockge أمر docker compose up -d خلف الكواليس ويُظهر لك سجلّات السحب والإقلاع الحيّة. تظهر الحُزمة في اللوحة بحالة خضراء بمجرد أن تصبح جميع الخدمات سليمة.
اختياري: قيّد الوصول عبر وكيل عكسي
افتراضياً يستمع Dockge على جميع الواجهات على المنفذ 5001. لتجنّب تعريضه للإنترنت، إمّا اربطه بـ 127.0.0.1:5001 في ملف Compose (أضِف "127.0.0.1:5001:5001" إلى ports) ووجّهه عبر وكيل Caddy أو Nginx، أو أضِف قاعدة ufw للسماح بالمنفذ 5001 من عنوان IP الخاص بك فقط: ufw allow from <your-ip> to any port 5001. لا تُعرّض واجهة Dockge للإنترنت العام أبداً دون مصادقة.
أول تسجيل دخول
افتحوا الرابط: يعرض Dockge شاشة لإنشاء حساب المسؤول (لا توجد أي بيانات دخول افتراضية). أنشئوه على الفور بكلمة مرور قوية.
وحدة تحكم الويب مُعطّلة افتراضياً — أبقِها كذلك
عطّل الإصدار v1.5.0 من Dockge وحدة التحكم الطرفية المدمجة (وصول shell عبر الويب) افتراضياً بعد تحذير أمني (GHSA-7vx4-hf96-mqq6). لا تُفعّلها على نسخة موجّهة للعامة إلا إذا كنت تفهم المخاطر تماماً. تبقى بقية Dockge — إدارة الحُزم والسجلّات والحالة — تعمل بكامل وظائفها دون وحدة التحكم. إذا احتجت إلى وصول shell، فاستخدم جلسة SSH فعلية أو أداة طرفية مخصّصة.
