📋 تثبيت Dozzle — عارض سجلات حاويات Docker الفوري

انشر Dozzle على Ubuntu بـ Docker — عارض سجلات خفيف وعديم الحالة وفوري لكل الحاويات العاملة مع بحث مباشر وفلترة regex ودعم عدة مضيفين، دون الحاجة لأي قاعدة بيانات.

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

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

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

عارض سجلات بدون إعداد — اربط مقبس Docker واحصل فوراً على بث مباشر لسجلات كل الحاويات على المنفذ 8080.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/monitoring/dozzle/dozzle-ubuntu.sh
chmod +x dozzle-ubuntu.sh
sudo bash dozzle-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/monitoring/dozzle/dozzle-ubuntu.sh

2 جعله قابلاً للتنفيذ

chmod +x dozzle-ubuntu.sh

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

يُشغّل السكريبت Dozzle مع تركيب مقبس Docker للقراءة فقط. Dozzle عديم الحالة تماماً — لا حاجة لقاعدة بيانات أو تخزين دائم.

sudo bash dozzle-ubuntu.sh

4 الدخول إلى واجهة الويب

افتح المتصفح وانتقل إلى Dozzle:

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

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

المنفذالغرض
8080Dozzle Web UI (HTTP)
/var/run/docker.sockDocker socket (read-only mount)

نظرة عامة

Dozzle عارض سجلات فوري خفيف ومفتوح المصدر لحاويات Docker. يقرأ تدفقات السجلات مباشرة من واجهة Docker Engine API عبر مقبس Docker المُركَّب ويعرضها مباشرة في واجهة ويب نظيفة — بدون عملاء تُثبَّت داخل حاوياتك، وبدون خط أنابيب لنقل السجلات، وبدون قاعدة بيانات للصيانة، لأنه لا يحتفظ بأي شيء في تخزين دائم على الإطلاق.

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

التحقق من سجلات الحاويات عادة يعني الاتصال بالسيرفر عبر SSH وتشغيل docker logs -f لحاوية واحدة في كل مرة. يستبدل Dozzle ذلك بلوحة ويب واحدة تعرض سجلات مباشرة وقابلة للبحث لكل حاوية على المضيف في آن واحد. ولأنه عديم الحالة تماماً ويقرأ مباشرة من مقبس Docker، يستغرق الإعداد أقل من دقيقة ولا توجد قاعدة بيانات سجلات لتحديد حجمها أو تأمينها أو صيانتها — إنه أسرع طريقة للحصول على رؤية حول ما تفعله حاوياتك فعلياً.

متى تحتاجه

  • سئمت من الاتصال بالسيرفر عبر SSH وتشغيل docker logs -f لكل حاوية على حدة
  • تدير عدة حاويات Docker على مضيف واحد وتحتاج لوحة واحدة لرؤية ما تسجّله جميعها فورياً
  • تريد البحث وفلترة السجلات بـ regex أثناء حادثة دون تمريرها عبر grep في سطر الأوامر
  • تحتاج عارض سجلات خفيفاً لا يتطلب إعداد Elasticsearch أو Loki أو مكدس تسجيل كامل آخر
  • تريد مشاركة الوصول للسجلات مع زميل دون منحه وصول SSH للسيرفر
  • تُصحّح حلقة تعطل حاوية وتحتاج مشاهدة السجلات تتحدث فورياً أثناء إعادة تشغيلها

من يحتاجه

  • المطورون ومهندسو DevOps الذين يحتاجون رؤية سريعة ومباشرة لسجلات الحاويات دون مكدس تسجيل ثقيل
  • عشاق المختبرات المنزلية والاستضافة الذاتية الذين يُشغّلون خدمات صغيرة عديدة ويريدون مكاناً واحداً للاطمئنان عليها جميعاً
  • الفرق الصغيرة التي لا تستطيع تبرير تشغيل Elasticsearch أو Loki أو مكدس ELK كامل فقط لعرض السجلات
  • مهندسو الدعم الذين يحتاجون وصولاً للقراءة فقط لسجلات حاويات الإنتاج دون وصول SSH كامل للسيرفر
  • أي شخص يدير حزمة Docker Compose متعددة الحاويات ويريد رؤية موحدة بدلاً من أوامر docker logs منفصلة
  • مدراء الأنظمة الذين يريدون لوحة سجلات سريعة ومتاحة دائماً على مضيف تديره Portainer أو Dockge

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

  • مشاهدة سجلات مباشرة لكل الحاويات العاملة على مضيف من تبويب متصفح واحد
  • تصحيح حاوية تتعطل أو تعيد التشغيل بمشاهدة سجلاتها تتحدث فورياً أثناء فشلها
  • البحث في مخرجات حاويات سابقة بفلترة regex أثناء تحقيق حادثة
  • منح زميل أو مهندس دعم رؤية للقراءة فقط لسجلات الحاويات دون وصول SSH
  • مراقبة سجلات حاويات عدة مضيفين من نسخة Dozzle واحدة في وضع متعدد المضيفين/Swarm
  • التحقق السريع من سجلات بدء التشغيل بعد نشر حاوية جديدة للتأكد من أنها بدأت بشكل صحيح

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

  • بث سجلات فوري مباشرة من واجهة Docker Engine API دون تأخير استطلاع
  • بحث مباشر وفلترة regex لتضييق السجلات فورياً أثناء التصحيح أو حادثة
  • عديم الحالة تماماً — بدون قاعدة بيانات، بدون تخزين دائم، وبدون ملف إعداد مطلوب للبدء
  • عرض متعدد الحاويات — شاهد سجلات عدة حاويات جنباً إلى جنب في شاشة واحدة
  • دعم متعدد المضيفين وDocker Swarm لتجميع سجلات حاويات عدة سيرفرات في لوحة واحدة
  • بصمة خفيفة — تستخدم الحاوية نفسها أدنى قدر من المعالج والذاكرة حتى عند متابعة سجلات كثيرة
  • واجهة ويب بسيطة ونظيفة لا تتطلب أي إعداد يتجاوز تركيب مقبس Docker
  • مصادقة أساسية اختيارية وتوافق مع الوكيل العكسي لتأمين الوصول للوحة

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

  • افتح http://your-server-ip:8080 وتأكد من رؤيتك لقائمة كل الحاويات العاملة على المضيف
  • انقر على أي حاوية لمشاهدة تدفق سجلها المباشر، الذي يتحدث فورياً مع كتابة أسطر سجل جديدة
  • استخدم شريط البحث لفلترة السجلات بكلمة مفتاحية أو فعّل وضع regex لمطابقة أنماط أدق
  • ثبّت أو شاهد عدة حاويات جنباً إلى جنب إذا احتجت ربط مخرجات السجلات عبر خدمات
  • إذا كنت تدير عدة مضيفي Docker، اضبط وضع Dozzle متعدد المضيفين أو وضع العميل لتجميعهم جميعاً في لوحة واحدة
  • أعدّ مصادقة أساسية أو ضع Dozzle خلف وكيل عكسي إذا احتاج الوصول أكثر من شخص واحد
  • احفظ رابط Dozzle كإشارة مرجعية كنقطة توقف أولى افتراضية عند تصحيح أي مشكلة حاوية بدلاً من الاتصال بـ SSH
  • تحقق دورياً من أن تركيب مقبس Docker لا يزال للقراءة فقط ولم يُغيَّر عن طريق الخطأ للقراءة والكتابة

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

  • ركّب مقبس Docker للقراءة فقط (ro) — يحتاج Dozzle فقط لقراءة سجلات الحاويات، لا الكتابة أبداً على واجهة Docker
  • لا تكشف المنفذ 8080 مباشرة للإنترنت دون مصادقة أمامه، فـ Dozzle يعرض المحتوى الكامل لسجلات كل حاوية
  • ضع Dozzle خلف وكيل عكسي مع HTTPS، ومن الأفضل مصادقة أساسية أو وكيل OAuth إذا كان الوصول عن بُعد مطلوباً
  • انتبه إلى أن تركيب مقبس Docker أصلاً يمنح صلاحيات كبيرة للحاوية المُركَّب بها — أبقِ صورة Dozzle محدّثة ومن مصدر موثوق
  • استخدم VPN مثل WireGuard للوصول عن بُعد بدلاً من إعادة توجيه منفذ Dozzle للإنترنت العام
  • راجع من يملك وصول شبكة للوحة Dozzle، فسجلات الحاويات قد تحتوي بيانات حساسة مثل مفاتيح API أو معلومات مستخدمين مطبوعة في رسائل الأخطاء
  • في إعدادات متعددة المضيفين، أمّن الاتصال بين نسخة Dozzle الرئيسية والعملاء البعيدين
  • قيّد لوحة Dozzle على الشبكات الداخلية الموثوقة فقط إذا كانت حاوياتك تسجّل أحياناً معلومات حساسة

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

تستمع واجهة ويب Dozzle على منفذ المضيف 8080 افتراضياً. ولأن Dozzle يعرض سجلات مباشرة قد تتضمن بيانات حساسة (استجابات API، تتبعات أخطاء، وأحياناً بيانات اعتماد مُسجَّلة بنص عادي من تطبيقات سيئة الإعداد)، يجب ألا يُكشف هذا المنفذ أبداً مباشرة للإنترنت العام دون مصادقة وTLS أمامه — ضعه خلف وكيل عكسي مثل Nginx Proxy Manager، أو قيّد الوصول على VPN. مقبس Docker المُركَّب (/var/run/docker.sock) ليس منفذ شبكة، لكن يجب أن يبقى دائماً للقراءة فقط، فأي شيء يملك وصول كتابة على مقبس Docker يملك فعلياً تحكماً بمستوى root على المضيف.

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

  • لا يوجد فعلياً شيء لنسخه احتياطياً في تخزين Dozzle الخاص — فهو عديم الحالة تماماً ولا يحمل أي بيانات دائمة
  • انسخ docker-compose.yml أو أمر docker run احتياطياً حتى يمكن إعادة إنشاء نفس إعداد Dozzle وتركيب المقبس وتعيين المنفذ بالضبط على مضيف جديد
  • إذا أعددت وضع متعدد المضيفين/العملاء أو المصادقة، انسخ متغيرات البيئة وملفات الإعداد الخاصة بذلك احتياطياً
  • بما أن Dozzle يعرض فقط السجلات التي يحتفظ بها Docker نفسه بالفعل، تأكد من أن إعدادات احتفاظ/تدوير سجلات Docker daemon تلبي احتياجاتك للتدقيق أو التصحيح بشكل مستقل عن Dozzle
  • وثّق أي مضيفين وعملاء متصلين في إعداد Dozzle متعدد المضيفين حتى يمكن إعادة بناء البنية سريعاً عند الحاجة

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

  • تركيب مقبس Docker للقراءة والكتابة بدلاً من القراءة فقط، مما يمنح Dozzle وصول كتابة غير ضروري على واجهة Docker
  • كشف المنفذ 8080 للإنترنت العام دون أي مصادقة، مما يسمح لأي شخص برؤية سجلات كل الحاويات مباشرة
  • افتراض أن Dozzle يخزّن سجل تاريخ السجلات — فهو يعرض فقط ما يحتفظ به سائق تسجيل Docker نفسه، وله حدود احتفاظ خاصة به
  • نسيان أن سجلات التطبيقات المطولة المعروضة عبر Dozzle قد تحتوي أسراراً أو معلومات شخصية تُكشَف لأي شخص يملك وصول اللوحة
  • تشغيل Dozzle بدون restart: unless-stopped، فتترك إعادة تشغيل السيرفر لوحة السجلات غير متاحة حتى إعادة التشغيل اليدوي
  • عدم إعداد وضع متعدد المضيفين عند إدارة عدة مضيفي Docker، مما ينتج عدة تبويبات Dozzle منفصلة بدلاً من رؤية موحدة
  • التعامل مع Dozzle كبديل لنظام تجميع سجلات وتنبيه حقيقي في بيئة إنتاج بمتطلبات امتثال
  • ترك صورة Dozzle قديمة وغير مُحدَّثة تعمل لفترة طويلة رغم كونها أداة منخفضة الصيانة تُعدّ وتُنسى

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

  • Dozzle لا يعرض أي حاويات — تحقق من تركيب مقبس Docker (/var/run/docker.sock) بشكل صحيح داخل حاوية Dozzle
  • واجهة الويب غير قابلة للوصول على المنفذ 8080 — تحقق من أن حاوية Dozzle تعمل بـ docker ps وأن المنفذ غير محظور بجدار الحماية المضيف
  • السجلات تبدو متأخرة أو تتوقف عن التحديث — أعد تشغيل حاوية Dozzle؛ يحدث هذا أحياناً بسبب انتهاء مهلة اتصالات طويلة الأمد بمقبس Docker
  • أخطاء رفض الإذن في سجلات Dozzle نفسها — تأكد من أن صلاحيات ملف مقبس Docker تسمح لمستخدم الحاوية بقراءته
  • وضع متعدد المضيفين لا يعرض حاويات بعيدة — تحقق من أن عميل Dozzle البعيد يعمل وقابل للوصول على الشبكة، وأن عنوان الاتصال مضبوط بشكل صحيح
  • البحث أو فلترة regex تُرجع نتائج غير متوقعة — تأكد من تفعيل وضع regex إذا كنت تستخدم صياغة نمط بدلاً من بحث نصي عادي
  • استخدام ذاكرة عالٍ عند متابعة حاويات مطولة جداً — هذا متوقع عندما تسجّل حاويات كثيرة بكثافة؛ فكّر بتقليل مستوى تفصيل السجلات على مستوى التطبيق
  • حاوية Dozzle تعيد التشغيل بشكل غير متوقع — راجع سجلات Docker daemon على المضيف بحثاً عن أخطاء متعلقة بالمقبس أو الوصول لحدود موارد

البدائل

يتضمن Portainer عارض سجلات أساسياً كجزء من واجهة إدارة الحاويات الأوسع لديه، مفيد إذا كنت تُشغّله بالفعل لكنه أقل تركيزاً من Dozzle على بث السجلات المباشر تحديداً. LazyDocker بديل قائم على الطرفية يوفّر السجلات مع الإحصاءات وإدارة الحاويات في واجهة نصية بدلاً من لوحة ويب. لتجميع سجلات بمستوى إنتاجي مع احتفاظ طويل الأمد وتنبيهات وبحث منظّم، مكدس كامل مثل Grafana Loki أو مكدس ELK (Elasticsearch وLogstash وKibana) أو Graylog هو الأداة الصحيحة — لكنها جميعاً تتطلب إعداداً وموارد أكبر بكثير من Dozzle. تخصص Dozzle ضيق عمداً: عرض سجلات مباشر وفوري بدون إعداد وبلا شيء للصيانة.

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

إذا احتجت احتفاظاً طويل الأمد بالسجلات، أو بحثاً نصياً كاملاً عبر أسابيع أو أشهر من التاريخ، أو قواعد تنبيه، أو سجلات تدقيق بمستوى امتثال، فـ Dozzle غير كافٍ بمفرده — اقرنه أو استبدله بمكدس تجميع سجلات حقيقي مثل Loki أو مكدس ELK. إذا كنت تُشغّل Portainer بالفعل وتحتاج فقط تحققات سجلات عرضية، فقد يكفي عارض السجلات المدمج به دون إضافة أداة أخرى. Dozzle مُصمَّم خصيصاً لرؤية مباشرة ومؤقتة لمخرجات الحاويات — لا يحتفظ بتاريخ يتجاوز ما يحتفظ به سائق تسجيل Docker نفسه، فهو ليس بديلاً لمنصة مراقبة حقيقية في بيئة إنتاج بمتطلبات امتثال صارمة.

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

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

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

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

هل يخزّن Dozzle أو يحتفظ بتاريخ السجلات؟

لا. Dozzle عديم الحالة تماماً — يبث السجلات مباشرة من واجهة Docker Engine API ولا يخزّن شيئاً بنفسه. مقدار التاريخ الذي يمكنك التمرير عبره يعتمد كلياً على سائق تسجيل Docker نفسه وإعدادات الاحتفاظ/التدوير الخاصة به، لا على Dozzle.

هل من الآمن تركيب مقبس Docker لـ Dozzle؟

ركّبه للقراءة فقط (ro)، ويستخدمه Dozzle فقط لقراءة سجلات الحاويات وبياناتها الوصفية — لا يكتب أبداً على واجهة Docker. مع ذلك، تعامل مع أي حاوية تملك وصولاً لمقبس Docker كحاوية مميزة، وأبقِ الصورة محدّثة، ولا تكشف أبداً واجهة ويب Dozzle للإنترنت دون مصادقة أمامها.

هل يستطيع Dozzle مراقبة حاويات على عدة سيرفرات؟

نعم. يدعم Dozzle وضع متعدد المضيفين حيث تتصل نسخة رئيسية بعملاء Dozzle بعيدين يعملون على مضيفي Docker آخرين، ويجمع كل سجلات حاوياتهم في لوحة واحدة. هذا مفيد لأي شخص يدير أكثر من سيرفر Docker واحد.

هل أحتاج قاعدة بيانات لتشغيل Dozzle؟

لا. لا يحتاج Dozzle أي قاعدة بيانات ولا أي حجم تخزين دائم على الإطلاق — يقرأ مباشرة من مقبس Docker ويعرض السجلات مباشرة في الذاكرة. هذا ما يجعل الإعداد يستغرق أقل من دقيقة ويُبقي الحاوية خفيفة جداً.

هل يمكنني البحث أو فلترة السجلات في Dozzle؟

نعم. يملك Dozzle شريط بحث مباشر مع وضع regex اختياري، يتيح لك فلترة مخرجات السجلات بكلمة مفتاحية أو نمط فورياً مع تدفق أسطر جديدة، وهو مفيد خاصة أثناء حادثة نشطة.