🔍 تثبيت WUD (What's Up Docker) — نظام مراقبة وتنبيهات تحديثات حاويات Docker
نشر منصة WUD على Ubuntu باستخدام Docker — نظام مراقبة وتنبيهات تحديثات صور وحاويات Docker مع دعم الإشعارات عبر Discord وTelegram وتصنيف التحديثات على المنفذ 3046.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/management/wud/wud-ubuntu.sh
chmod +x wud-ubuntu.sh
sudo bash wud-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/management/wud/wud-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x wud-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم (`./wud-data`) وربط مقبس Docker بوضع القراءة فقط (`/var/run/docker.sock:ro`) وتشغيل WUD على المنفذ 3046 (المحول من 3000 الداخلي).
sudo bash wud-ubuntu.sh
4 فتح لوحة التحكم وضبط التنبيهات
افتح متصفحك على الرابط http://ip-سيرفرك:3046. استعرض الحاويات المشغلة، وافحص التحديثات المكتشفة، واضبط قنوات التنبيه عبر Discord أو Telegram أو Gotify أو Webhooks.
http://<your-server-ip>:3046
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3046 | Web UI + API (host → container 3000) |
نظرة عامة
تعد WUD (اختصاراً لـ What's Up Docker) منصة وتطبيق ويب مفتوح المصدر وخفيف لمراقبة وفحص وتنبيهات تحديثات صور حاويات Docker. تعمل المنصة عبر المنفذ 3046 (المحول من منفذ 3000 الداخلي) وتتصل بمقبس دكر المحلي بوضع القراءة فقط (Read-only) لفحص سجلات Docker Hub وGitHub Container Registry (ghcr.io) ومستودعات الصور الخاصة. وتكتشف الإصدارات الجديدة تلقائياً، وتدعم مطابقة الترقيم الدلالي (SemVer)، وترسل إشعارات فورية عبر Discord وTelegram وGotify وSlack والبريد الإلكتروني.
لماذا تستخدمه
يعد التحديث التلقائي الأعمى للحاويات (مثل Watchtower) في بيئات الإنتاج خطيراً، حيث قد يؤدي تحديث رئيسي مفاجئ لكسر قواعد البيانات أو تعطيل الخدمات. يوفر WUD الحل المثالي الأكثر أماناً: ينبهك فور صدور إصدارات أحدث للحاويات مع تصنيف نوع التحديث (رئيسي، فرعي، ترقيعي)، لتتمكن من مراجعة سجل التغييرات وترقية الخدمات يدوياً بأمان وفي أوقات الصيانة المخططة.
متى تحتاجه
- تريد إشعارات تلقائية فور صدور إصدارات أحدث لصور وحاويات Docker المشغلة بسيرفرك
- تريد تفادي التحديثات التلقائية العشوائية التي قد تسبب انهيار خدمات الإنتاج وقواعد البيانات
- تريد تصنيفاً دقيقاً للتحديثات وفق الترقيم الدلالي (SemVer) للتمييز بين التحديثات الأمنية والتحديثات الكبرى
- تدير عدة سيرفرات Docker وتريد لوحة تحكم مركزية تعرض حالة تحديثات كافة الخدمات في شاشة واحدة
- تحتاج لإرسال تنبيهات التحديث لقنوات متعددة مثل Discord وTelegram وGotify والبريد الإلكتروني
من يحتاجه
- مديرو الأنظمة ومهندسو الـ DevOps لإدارة وتتبع تحديثات حاويات الإنتاج والخدمات السحابية
- أصحاب السيرفرات المنزلية (Homelab) الذين يديرون عشرات الخدمات المستضافة ذاتياً لمتابعة تحديثاتها
- مهندسو الأمان السيبراني لمراقبة الحاويات القديمة وتفادي استخدام صور تحتوي على ثغرات معروفة
- مطورو البرمجيات لمتابعة نشر صور الحاويات الجديدة الناتجة عن خطوط معالجة الـ CI/CD
- فرق التشغيل التقني لتخطيط وتنظيم مواعيد الصيانة الدورية للسيرفرات
حالات الاستخدام الشائعة
- استلام إشعار على Discord بمجرد صدور تحديث أمني جديد لحاوية Nextcloud أو Vaultwarden
- فلترة التنبيهات بقواعد SemVer لتجاهل التحديثات الكبرى المسببة للتغييرات الجذرية والتنبيه فقط على الترقيعات
- مراقبة الصور الخاصة بمستودعات GitHub Container Registry (ghcr.io) باستخدام مفاتيح API مشفرة
- إرسال رسائل عبر بروتوكول MQTT إلى Home Assistant لعرض شارات التحديث في لوحة التحكم المنزلية
- فحص وتدقيق 50 حاوية مشغلة على سيرفر Ubuntu ومعرفة الخدمات القديمة في جدول بصري منسق
الميزات الرئيسية
- لوحة مراقبة بصرية على المنفذ 3046: واجهة ويب أنيقة تستعرض كافة الحاويات وحالة التحديثات المتوفرة
- ذكاء الترقيم الدلالي (SemVer): تمييز وتصنيف التحديثات آلياً إلى Major وMinor وPatch وPrerelease
- دعم واسع لكافة السجلات: الاتصال بـ Docker Hub وGHCR وQuay وAWS ECR والمستودعات الخاصة
- تنبيهات متعددة القنوات: تكامل مدمج مع Discord وTelegram وPushover وGotify وSlack والبريد والـ Webhooks
- تشغيل آمن بوضع القراءة فقط: يكتفي WUD بصلاحية القراءة بمقبس دكر `/var/run/docker.sock:ro` دون صلاحيات تعديل
- تخصيص القواعد لكل حاوية: ضبط فترات الفحص وقواعد الفلترة عبر وسوم الحاويات (Docker Labels)
- معمارية Node.js خفيفة للغاية: استهلاك شبه معدوم لموارد المعالج وسرعة فائقة في الفحص
- معمارية Docker Compose تنشر المنفذ 3046:3000 بتثبيت مباشر وسريع
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3046
- راجع قائمة الحاويات المشغلة وسجلات الصور المكتشفة
- اضبط قنوات الإشعارات في ملف `docker-compose.yml` (مثل إضافة رابط ويب هوك Discord)
- أضف وسوم Docker Labels للحاويات الحساسة لتخصيص قواعد الفحص (مثل الفلترة بنمط SemVer)
- ضع WUD خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع كلمة مرور للمديرين
- أعد سكريبت نسخ احتياطي دوري لمجلد البيانات `./wud-data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: اربط مقبس Docker دائماً بوضع القراءة فقط (`/var/run/docker.sock:/var/run/docker.sock:ro`)
- ضع WUD خلف وكيل عكسي محمي بكلمة مرور؛ حيث لا يتضمن التطبيق نظام تسجيل دخول مدمج
- لا تفتح المنفذ 3046 للإنترنت العام مباشرة دون وكيل عكسي مشفر بـ SSL
- اقصر الاتصال بالمنفذ 3046 على شبكة الإدارة الداخلية الموثوقة (`ufw allow 3046/tcp`)
- خزن رموز ومفاتيح الوصول لمستودعات الصور الخاصة بأمان في متغيرات البيئة
- حدّث صورة الحاوية دورياً للحصول على أحدث سكريبتات فحص سجلات الحاويات
المنافذ وإعدادات جدار الحماية
يقدم WUD واجهة الويب والـ API عبر منفذ TCP 3046 (المحول من منفذ 3000 الداخلي). اسمح بالمنفذ 3046 للشبكة المحلية (`ufw allow 3046/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 3046، مع إبقاء المنفذ 3046 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./wud-data` احتياطياً، والذي يحتوي على كاش حالة الحاويات وتاريخ الإشعارات
- احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات المحتوي على إعدادات الويب هوك
- أتمت النسخ الاحتياطي لملفات الإعدادات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
الأخطاء الشائعة
- ربط مقبس دكر بوضع القراءة والكتابة بينما يكتفي التطبيق بوضع القراءة فقط (`:ro`)
- كشف المنفذ 3046 للإنترنت العام بدون كلمة مرور أو حماية خلف وكيل عكسي
- عدم استخدام وسوم SemVer للحاويات التي تستخدم وسوماً غير قياسية أو وسوم التواريخ
- ضبط فترات فحص متقاربة جداً مما يسبب حظر السيرفر مؤقتاً من Docker Hub بسبب تجاوز المعدل (Rate Limit 429)
- نسيان ضبط بيانات تسجيل الدخول للمستودعات الخاصة مثل GitHub Container Registry
استكشاف الأخطاء وإصلاحها
- رفض الاتصال بالواجهة — تأكد من عمل الحاوية بالأمر `docker compose ps` وافحص السجلات: `docker logs wud -f`
- خطأ Docker Hub Rate Limit 429 — أضف بيانات حسابك في Docker Hub بإعدادات WUD لرفع حد الطلبات المجاني
- عدم اكتشاف تحديثات الصور الخاصة — تأكد من صحة رمز الـ API في متغيرات البيئة (`WUD_REGISTRY_GHCR_TOKEN=...`)
- فشل وصول إشعارات Discord أو Telegram — راجع صحة رابط الـ Webhook أو رمز البوت في ملف `docker-compose.yml`
- ظهور حالة الحاوية كـ 'unknown' — تأكد مما إذا كانت الحاوية تستخدم بصمة SHA ثابتة أو وسماً غير قابل للتتبع
البدائل
أداة Watchtower للتحديث التلقائي المباشر للحاويات. أداة DIUN للطرفية والإشعارات بدون واجهة ويب. لوحة Portainer لإدارة الحاويات وإعادة سحب الصور. منصة Dockge لإدارة حزم Docker Compose.
متى لا تستخدمه
تجنب استخدام WUD إذا كنت تريد تحديث وإعادة تشغيل الحاويات تلقائياً بدون تدخل بشري في منتصف الليل (حيث صُممت Watchtower للتحديث الآلي الفوري). وإذا كنت تبحث فقط عن أداة سطر أوامر خفيفة ترسل بريداً دون الحاجة لواجهة ويب، فإن DIUN أخف.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو تطبيق WUD (What's Up Docker) وكيف يعمل؟
تطبيق WUD هو منصة مفتوحة المصدر لمراقبة تحديثات حاويات Docker. يفحص الحاويات المشغلة بسيرفرك ويقارن بصمات صورها مع السجلات الخارجية (Docker Hub وGHCR) ويرسل إشعارات فورية عند توفر إصدارات أحدث.
هل يقوم WUD بتحديث وإعادة تشغيل الحاويات تلقائياً؟
لا، تم تصميم WUD كمنصة مراقبة وتنبيهات فقط وليس للتحديث الإجباري. يقوم بإعلامك فور توفر التحديث لتتمكن من مراجعة التغييرات وتطبيق التحديث بأمان في موعد الصيانة المناسب لمنع انهيار الخدمات.
ما هي قنوات الإشعارات التي يدعمها WUD؟
يدعم WUD قنوات Discord وTelegram وPushover وGotify وSlack والبريد الإلكتروني (SMTP) وMQTT (لتكامل Home Assistant) والـ JSON Webhooks العامة.
هل يستطيع WUD مراقبة سجلات الحاويات الخاصة؟
نعم! يستطيع WUD الاتصال والمصادقة مع مستودعات GitHub Container Registry (ghcr.io) وQuay.io وسجلات GitLab وAWS ECR والمستودعات الخاصة المستضافة ذاتياً باستخدام مفاتيح API مشفرة.
كم يستهلك تطبيق WUD من الذاكرة العشوائية (RAM)؟
تم بناء WUD بـ Node.js ويتميز بخفة استثنائية، حيث يستهلك عادة ما بين 40 إلى 90 ميجابايت فقط من الرام داخل Docker.