⚙️ تثبيت Diun — مُنبّه تحديثات صور Docker
انشر Diun على Ubuntu — مُنبّه خفيف وخالٍ من الواجهة يراقب صورك بحثاً عن إصدارات جديدة وينبّهك عبر Telegram وGotify والبريد الإلكتروني وأدوات أخرى كثيرة. بدون واجهة ويب.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/management/diun/diun-ubuntu.sh
chmod +x diun-ubuntu.sh
sudo bash diun-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/management/diun/diun-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x diun-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، يسحب صورة crazymax/diun، ويشغّلها كخدمة خلفية مع تفعيل مزوّد Docker. افتراضياً يراقب كل الحاويات العاملة ويفحص كل 6 ساعات.
sudo bash diun-ubuntu.sh
4 إضافة وسيلة تنبيه
لا يملك Diun واجهة ويب. عدّل docker-compose.yml وأضف وسيلة تنبيه عبر متغيرات البيئة DIUN_NOTIF_* (Telegram وGotify والبريد الإلكتروني وDiscord وغيرها)، ثم أعد إنشاء الحاوية:
docker logs diun # verify it is watching your containers
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| none | Headless — no web UI, no exposed ports (outbound only) |
نظرة عامة
Diun (Docker Image Update Notifier) أداة سطر أوامر مجانية ومفتوحة المصدر وخالية من الواجهة تراقب صور Docker الخاصة بك وتنبّهك لحظة نشر إصدار جديد — دون أن تسحب أو تعدّل أي شيء على جهازك مطلقاً. تدعم عدة مزوّدين (Docker، Docker Swarm، Kubernetes، أو قائمة ملف ثابتة) وأكثر من اثنتي عشرة قناة إشعار، ما يجعلها أخف وسيلة للبقاء على اطلاع بتحديثات الصور المتاحة دون كشف واجهة ويب أو منح صلاحية كتابة على مقبس Docker.
لماذا تستخدمه
الحفاظ على تحديث الحاويات ذاتية الاستضافة مهمة يدوية يسهل نسيانها، والتحديث التلقائي الأعمى لكل شيء (كما يفعل Watchtower) يخاطر بوصول تغييرات كاسرة للإنتاج دون رقابة. يفصل Diun المهمة إلى جزأين: يخبرك لحظة توفر بصمة أو وسم صورة جديد، وأنت تقرر متى وكيف تحدّث. يعمل بمقبس Docker للقراءة فقط، يستهلك موارد شبه معدومة، ولا يحتاج لوحة تحكم، فيندمج بسلاسة في أي مختبر منزلي أو سيرفر إنتاج كحارس خلفي بدلاً من أن يكون خدمة إضافية يجب تأمينها وصيانتها.
متى تحتاجه
- تُشغّل عدة خدمات ذاتية الاستضافة بـ Docker وتريد تنبيهاً موثوقاً عند نشر إصدارات صور جديدة دون فحص Docker Hub يدوياً
- تفضّل مراجعة واختبار التحديثات قبل تطبيقها، لذا لا تريد أداة تحديث تلقائي مثل Watchtower تعيد إنشاء الحاويات بصمت
- تريد توجيه إشعارات التحديث لقناة تستخدمها يومياً بالفعل — Telegram أو Slack أو Discord أو البريد الإلكتروني أو webhook لأتمتتك الخاصة
- تدير عنقود Docker Swarm أو Kubernetes وتحتاج مراقباً واحداً يغطي كل عقدة دون عميل منفصل لكل مضيف
- تحتاج تتبع تحديثات صور مثبتة على وسم محدد (مثل postgres:16) وتريد أن تُعلَم فقط عند تغيّر ذلك الوسم بالتحديد
- تريد سطح هجوم صفرياً من أداة مراقبة التحديثات لديك — بدون منافذ مكشوفة، بدون تسجيل دخول ويب، بدون صلاحية كتابة على Docker
من يحتاجه
- مشغّلو المختبرات المنزلية الذين يديرون عشرات الحاويات ذاتية الاستضافة ويحتاجون طريقة خفيفة لتتبع التحديثات المتاحة
- مديرو الأنظمة الذين يتجنبون التحديثات التلقائية في الإنتاج عن قصد ويريدون نظام تنبيه فقط بدلاً منها
- فرق DevOps التي تدير Docker Swarm أو Kubernetes وتريد رؤية مركزية لتحديثات الصور عبر العنقود بالكامل
- المستخدمون المهتمون بالأمان الذين يريدون رؤية للتحديثات دون منح أداة صلاحية كتابة على مقبس Docker
- الفرق التي لديها بالفعل قناة إشعارات/حوادث (Slack، Telegram، ntfy) وتريد توجيه تحديثات الصور إليها تلقائياً
- أي شخص يستبدل عادة الفحص اليدوي 'docker pull && diff' بمراقب مجدول آلي
حالات الاستخدام الشائعة
- احصل على رسالة Telegram أو Slack لحظة نشر وسم جديد لصورة nginx أو postgres أو أي صورة تتابعها
- راقب عنقود Docker Swarm أو Kubernetes بالكامل بحثاً عن صور قديمة من نسخة Diun مركزية واحدة
- غذِّ إشعارات webhook من Diun في خط أنابيب CI/CD الخاص بك لتشغيل اختبار آلي قبل نشر التحديث
- تابع قائمة منتقاة من الصور معرّفة في ملف YAML ثابت، بمعزل عمّا يعمل حالياً
- ادمج Diun مع عملية إدارة تغيير — احصل على الإشعار، راجع ملاحظات الإصدار، ثم حدّث يدوياً خلال نافذة صيانة
- راقب حاويات محددة فقط باستخدام تصنيفات تضمين/استبعاد بدلاً من مراقبة كل حاوية على المضيف
الميزات الرئيسية
- خالٍ من الواجهة تماماً — بدون واجهة ويب، بدون منافذ مكشوفة، يُهيّأ بالكامل عبر متغيرات بيئة أو ملف YAML
- عدة مزوّدين: Docker (الافتراضي)، خدمات Docker Swarm، حاويات Kubernetes، أو قائمة ملف ثابتة من الصور للمراقبة
- أكثر من اثنتي عشرة تكاملات إشعار: Telegram وDiscord وSlack وGotify وntfy والبريد الإلكتروني (SMTP) وMattermost وRocket.Chat وPushover وwebhook عام وتنفيذ سكريبت
- جدول قابل للتهيئة عبر تعبير cron (DIUN_WATCH_SCHEDULE)، يفحص كل 6 ساعات افتراضياً
- تفعيل/تعطيل لكل حاوية وإعدادات مراقبة مخصصة باستخدام تصنيفات diun.* في Docker
- مقارنة مبنية على البصمة (digest) وليس فقط اسم الوسم — يكتشف عندما يُعاد نشر وسم 'latest' أو ثابت بمحتوى جديد
- بصمة موارد ضئيلة — ثنائي/حاوية Go صغيرة واحدة، مثالية حتى لأصغر VPS
- الوصول للقراءة فقط على مقبس Docker كافٍ — لا يحتاج Diun أبداً لصلاحيات كتابة ليعمل
كيفية الاستخدام بعد التثبيت
- تحقق من سجلات الحاوية (docker logs diun) للتأكد من أنها بدأت وتراقب حاوياتك العاملة
- أضف وسيلة تنبيه واحدة على الأقل عبر متغيرات DIUN_NOTIF_* في docker-compose.yml — بدونها يسجّل Diun التحديثات لكن لا ينبّهك أبداً
- أعد إنشاء الحاوية بعد تعديل متغيرات البيئة حتى يسري إعداد وسيلة التنبيه الجديدة
- أضف تصنيفات diun.enable=true للحاويات إذا ضبطت المراقبة لتشمل الحاويات المصنَّفة فقط بدلاً من كل شيء
- عدّل DIUN_WATCH_SCHEDULE إذا كانت 6 ساعات متكررة جداً أو نادرة جداً بالنسبة لوتيرة تحديثاتك
- شغّل فحصاً يدوياً لاختبار إعداد وسيلة التنبيه قبل انتظار التشغيل المجدول التالي
- راجع أول إشعار بعناية للتأكد من أن تنسيق الرسالة يعمل مع قناة الإشعار التي اخترتها
أفضل ممارسات الأمان
- اربط مقبس Docker للقراءة فقط (:ro) — يحتاج Diun فقط لقراءة بيانات الحاويات/الصور، وليس التحكم بها أبداً
- لا تكشف Diun للإنترنت أبداً — لا يملك واجهة ويب أو طبقة مصادقة لحمايتها، فليس هناك ما يُنشر
- خزّن بيانات اعتماد وسائل التنبيه (رموز بوت Telegram، كلمات مرور SMTP، روابط webhook) كمتغيرات بيئة أو أسرار Docker، وليس مكتوبة مباشرة في ملف compose مرفوع لنظام التحكم بالإصدارات
- شغّل حاوية Diun بسياسة إعادة تشغيل لكن بدون صلاحيات مرتفعة — لا تحتاج جذر داخل الحاوية أكثر مما تتطلبه الصورة الأساسية
- قيّد الحاويات التي يستطيع Diun رؤيتها إذا كان يعمل على مضيف Docker مشترك أو متعدد المستأجرين عبر تحديد سياق Docker معين
- حافظ على تحديث صورة Diun نفسها دورياً، بشكل يفارق المفارقة، بمراجعة crazymax/diun على Docker Hub أو إصدارات GitHub
المنافذ وإعدادات جدار الحماية
لا يكشف Diun أي منفذ إطلاقاً — إنه خدمة خلفية خالية من الواجهة بحركة شبكة صادرة فقط (فحص السجلات وإرسال الإشعارات). ليس هناك ما تفتحه في جدار الحماية لأجل Diun نفسه؛ فقط اسمح بحركة HTTPS الصادرة حتى يصل إلى Docker Hub أو السجلات الأخرى وخدمة الإشعارات التي اخترتها.
النسخ الاحتياطي والصيانة
- خذ نسخة احتياطية من docker-compose.yml ومتغيرات DIUN_* — هذا هو كامل تهيئة Diun
- إذا كنت تستخدم مزوّد الملف الثابت، خذ نسخة احتياطية من ملف YAML الذي يسرد الصور المراقَبة
- يحتفظ Diun بملف حالة محلي صغير (BoltDB) لتجنب الإشعارات المكررة — خذ نسخة احتياطية من حجم بياناته إذا أردت الحفاظ على سجل الإشعارات عبر إعادة الإنشاء
- وثّق إعداد وسيلة التنبيه لديك (أي قناة، أي بيانات اعتماد) بشكل منفصل في حال احتجت إعادة الضبط على مضيف جديد
- لا توجد قاعدة بيانات أو وسائط لحمايتها — استعادة Diun هي ببساطة إعادة نشر الحاوية بنفس متغيرات البيئة
الأخطاء الشائعة
- تثبيت Diun دون تهيئة أي وسيلة تنبيه أبداً — يسجّل التحديثات بصمت في وحدة تحكم لا يقرأها أحد
- ربط مقبس Docker للقراءة والكتابة بينما القراءة فقط كافية — يوسّع سطح الهجوم دون داعٍ
- توقع أن يُحدّث Diun الحاويات تلقائياً — فهو ينبّه فقط؛ ما زال عليك (أو أداة منفصلة) سحب الصورة وإعادة الإنشاء
- ضبط جدول المراقبة بتكرار مفرط (كل بضع دقائق مثلاً) وإرهاق حدود معدل طلبات Docker Hub دون داعٍ
- نسيان أن Docker Hub يفرض حدود معدل سحب على المستخدمين المجهولين — الفحص عالي التكرار عبر صور كثيرة قد يصطدم بها
- عدم اختبار إعداد وسيلة التنبيه قبل الاعتماد عليها — خطأ إملائي في رمز بوت يعني توقفك بصمت عن استقبال التنبيهات
- تشغيل عدة نسخ من Diun تراقب نفس الحاويات، ما يسبب إشعارات مكررة عند كل تحديث
استكشاف الأخطاء وإصلاحها
- لا تصلك إشعارات — راجع docker logs diun بحثاً عن أخطاء وسيلة التنبيه، وتحقق من صحة تهجئة متغيرات DIUN_NOTIF_*
- فشل إشعارات Telegram — تأكد من صحة رمز البوت ومعرف المحادثة؛ يجب أن يكون البوت قد استقبل رسالة واحدة على الأقل مسبقاً لبعض أنواع المحادثات
- Diun لا يكتشف تحديثاً — تحقق أن وسم الصورة يُراقَب فعلاً (راجع التصنيفات/الإعداد) وأن السجل يسمح بالاستعلام المجهول عن البصمة
- الاصطدام بحدود معدل Docker Hub — وثّق Diun بحساب Docker Hub عبر DIUN_REGDATA أو قلّل تكرار الفحص
- لا تُراقَب أي حاويات — تأكد أن مزوّد Docker مفعّل وأن المقبس مرتبط بشكل صحيح داخل الحاوية
- إشعارات مكررة عند كل فحص — تحقق من وجود عدة نسخ من Diun أو قاعدة حالة داخلية تالفة، وامسح حجم البيانات إذا لزم
- الحاوية تتوقف فور بدء التشغيل — تحقق من وجود خطأ صياغة في متغير بيئة أو ملف تهيئة YAML غير سليم
البدائل
Watchtower هو البديل الأكثر شيوعاً — يستطيع التنبيه وسحب/إعادة إنشاء الحاويات تلقائياً معاً، وهذا مريح لكنه أكثر خطورة لأنه قد يطبّق تغييرات كاسرة دون رقابة. What's Up Docker (WUD) يقدّم نهجاً مشابهاً لـ Diun في التنبيه فقط (أو التحديث التلقائي) لكنه يضيف لوحة تحكم ويب كاملة وتكاملاً مع Home Assistant مقابل كشف منفذ. Renovate وDependabot يتعاملان مع تتبع التحديثات لكود المصدر وخطوط أنابيب CI بدلاً من الحاويات العاملة. لأداة إشعار فقط، خفيفة، خالية من الواجهة، بدون سطح ويب، يظل Diun الخيار الأخف؛ اختر Watchtower أو WUD إذا أردت لوحة تحكم أو تحديثات تلقائية بدلاً من المراجعة اليدوية.
متى لا تستخدمه
Diun ليس مناسباً إذا كنت تريد تطبيق التحديثات تلقائياً دون أي خطوة يدوية — فهو ينبّه فقط، لذا ادمجه مع Watchtower أو خط أنابيب CI/CD إذا كان الهدف تحديثاً بلا تدخل. كما أنه غير مفيد إذا احتجت لوحة تحكم مرئية لإصدارات الحاويات؛ فـ Diun خالٍ من الواجهة بالتصميم، لذا يُعد What's Up Docker خياراً أفضل إذا كانت واجهة الويب مهمة لك. أخيراً، في الإعدادات المنزلية الصغيرة جداً بحاوية أو حاويتين فقط، قد يكون الفحص اليدوي العرضي للتحديثات أبسط من تشغيل خدمة مراقبة مخصصة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل يملك Diun واجهة ويب؟
لا. Diun خالٍ من الواجهة تماماً — لا يكشف أي منفذ ولا يملك لوحة تحكم. تهيّئه عبر متغيرات بيئة DIUN_* أو ملف تهيئة YAML، ويعمل كخدمة خلفية ترسل الإشعارات. لواجهة ويب، استخدم What's Up Docker (WUD).
كيف أحصل على إشعارات من Diun؟
أضف وسيلة تنبيه عبر متغيرات البيئة، مثل DIUN_NOTIF_TELEGRAM_TOKEN وDIUN_NOTIF_TELEGRAM_CHATIDS لـ Telegram، أو متغيرات DIUN_NOTIF_* المكافئة لـ Gotify والبريد الإلكتروني وDiscord وSlack وntfy وغيرها.
هل يُحدّث Diun حاوياتي؟
لا. ينبّهك Diun فقط عند وجود إصدار صورة جديد؛ لا يسحب أو يعيد إنشاء الحاويات مطلقاً. بربط مقبس Docker للقراءة فقط، يستطيع Diun مراقبة حاوياتك لكن لا يستطيع تعديل أي شيء على جهازك.
كم مرة يفحص Diun التحديثات؟
كل 6 ساعات افتراضياً، يتحكم بها تعبير cron في DIUN_WATCH_SCHEDULE (0 */6 * * *). غيّر هذا المتغير للفحص بتكرار أكبر أو أقل. يتحكم DIUN_WATCH_WORKERS بعدد الصور التي يفحصها بالتوازي.
ما الفرق بين Diun وWUD؟
كلاهما يراقب صور الحاويات وينبّه دون تحديث تلقائي. Diun خالٍ من الواجهة بدون واجهة ويب وبأصغر بصمة. يضيف WUD لوحة تحكم ويب وتكاملاً مع Home Assistant لكنه يكشف منفذاً. اختر Diun للبساطة القصوى، وWUD للوحة التحكم.