🔔 تثبيت ntfy — إشعارات فورية ذاتية الاستضافة
انشر ntfy على Ubuntu مع Docker — خدمة إشعارات pub/sub بسيطة ومبهجة تعتمد على HTTP. أرسل إشعارات فورية لهاتفك أو حاسوبك من أي سكريبت أو مهمة مجدولة بطلب HTTP واحد.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/ntfy/ntfy-ubuntu.sh
chmod +x ntfy-ubuntu.sh
sudo bash ntfy-ubuntu.sh
خطوات التنفيذ
1 تحميل وتشغيل السكريبت
يثبّت السكريبت Docker ويشغّل سيرفر ntfy مع تخزين دائم لسجل الرسائل.
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/ntfy/ntfy-ubuntu.sh
chmod +x ntfy-ubuntu.sh
sudo bash ntfy-ubuntu.sh
2 إرسال أول إشعار
أرسل إشعاراً تجريبياً بأمر curl بسيط. المواضيع (Topics) تُنشأ تلقائياً — بدون تسجيل:
curl -d "Backup finished successfully!" http://<your-server-ip>:8095/alerts
3 الاشتراك من هاتفك
ثبّت تطبيق ntfy على Android أو iOS. اضغط 'إضافة اشتراك' ← 'استخدم سيرفراً آخر' ← أدخل عنوان سيرفرك واسم الموضوع. ستصل الإشعارات الفورية فور نشر أي رسالة.
4 الدمج مع السكريبتات والمهام المجدولة
أضف إشعارات ntfy لأي سكريبت Shell أو cron job. استخدم HTTP headers لتحديد الأولوية والوسوم والعناوين لإشعارات أغنى.
curl -H "Title: Server Alert" \
-H "Priority: urgent" \
-H "Tags: warning,computer" \
-d "Disk usage exceeded 90%!" \
http://<your-server-ip>:8095/alerts
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8095 | ntfy Web UI & API |
نظرة عامة
ntfy (تُنطق 'notify') هي خدمة إشعارات pub/sub مفتوحة المصدر عبر HTTP. يمكن لأي سكريبت أو تطبيق أو خدمة إرسال إشعار فوري لأي جهاز مشترك عن طريق طلب HTTP POST واحد. لا تسجيل تطبيق، لا مفاتيح API للناشرين — فقط أرسل لـ URL موضوع ويتلقاه جميع المشتركين فوراً.
لماذا تستخدمه
ntfy تحل مشكلة آخر ميل في أتمتة السيرفر: إيصال إشعار فوري لهاتفك من أي سكريبت أو مهمة cron أو تنبيه مراقبة — بطلب HTTP POST واحد وبدون أي تسجيل تطبيق. على عكس Slack webhooks أو تنبيهات البريد الإلكتروني، تُسلَّم ntfy فورياً كإشعارات push أصلية للجوال وتعمل من أي بيئة قادرة على طلب HTTP، بما فيها bash وPython وcurl. الاستضافة الذاتية تعني عدم مرور بيانات تنبيهاتك عبر خوادم خارجية أبداً.
متى تحتاجه
- تريد إشعارات push من مهام cron وسكريبتات السيرفر لهاتفك دون بناء تطبيق
- مجموعة المراقبة لديك (Uptime Kuma أو Netdata أو Grafana) تحتاج هدف webhook خفيف للتنبيهات
- تريد استبدال تنبيهات البريد الإلكتروني بـ push فوري للجوال لأحداث DevOps
- خط CI/CD يحتاج لإشعارك عند نجاح أو فشل البناء دون Slack
- تريد قناة pub/sub بسيطة للإشعارات يمكن لأي عضو في الفريق الاشتراك بها
- تشغّل نسخاً احتياطية أو سكريبتات صيانة آلية وتريد تنبيهات فورية عند الفشل
من يحتاجه
- مسؤولو الأنظمة الذين يؤتمتون مهام السيرفر ويحتاجون تغذية راجعة فورية
- مهندسو DevOps الذين يبنون خطوط CI/CD ذاتية الاستضافة تحتاج خطافات إشعار
- المطورون الذين يريدون تنبيه أنفسهم من المشاريع الشخصية والسكريبتات
- محبو Homelab الذين يراقبون خدمات متعددة ويريدون إشعارات موحدة
- مهندسو الأمن الذين يريدون تنبيهات تسجيل SSH وأحداث مشبوهة
- فرق تقنية المعلومات التي تشغّل مجموعات مراقبة وتحتاج قناة تنبيه صادرة بسيطة
- محبو المصادر المفتوحة الذين يريدون بنية الإشعارات كاملة على خوادمهم الخاصة
- أي شخص يملّ من فحص البريد لنتائج السكريبتات ويريد push فوري للجوال
حالات الاستخدام الشائعة
- إرسال إشعارات فورية من سكريبتات bash عند اكتمال مهمة cron أو فشلها
- تنبيه مهندسي oncall عند اكتشاف نظام مراقبة لحادثة
- استقبال إشعارات الجوال عند اكتمال عملية طويلة التشغيل على السيرفر
- إخطار قناة فريق عند اكتمال خط أنابيب CI/CD دون تكامل معقد
- الإنذار عند تسجيل دخول شخص لسيرفرك عبر SSH باستخدام خطاف PAM
- تشغيل تلقائيات على هاتفك عند حدوث أحداث على السيرفر باستخدام تطبيق ntfy
الميزات الرئيسية
- HTTP pub/sub — انشر بـ curl أو أي عميل HTTP، اشترك بالتطبيق أو المتصفح
- إشعارات push أصلية لـ Android وiOS — لا polling، تسليم فوري
- واجهة ويب — اشترك وعرض الرسائل في المتصفح على URL سيرفرك
- دعم المصادقة — اسم مستخدم/كلمة مرور أو رمز وصول للناشرين والمشتركين
- أولويات الرسائل — min وlow وdefault وhigh وmax مع مؤشرات مرئية في التطبيق
- تسليم مجدول — أرسل إشعارات بتأخير للتذكيرات المستقبلية
- مرفقات الملفات — أرفق ملفات صغيرة (لقطات شاشة، سجلات) بالإشعارات
- وضع بدون Firebase — تطبيق ntfy على F-Droid يستخدم WebSocket مباشر، بدون خدمات Google
كيفية الاستخدام بعد التثبيت
- افتح https://your-domain.com في المتصفح للوصول لواجهة ntfy الويب
- ثبّت تطبيق ntfy على Android (F-Droid أو Play Store) أو iOS (App Store)
- في التطبيق، انقر Add subscription وأدخل URL سيرفرك واسم الموضوع
- اختبر إشعاراً: curl -d 'مرحباً من ntfy' https://your-domain.com/mytopic
- فعّل المصادقة بإنشاء server.yml مع auth-file وauth-default-access: deny
- أنشئ رموز وصول في واجهة المسؤول واستخدمها في سكريبتاتك بدلاً من كلمات المرور
- اربط ntfy بـ Uptime Kuma (الإعدادات > Notification > ntfy) لتنبيهات uptime
- أضف تنبيهات تسجيل SSH بإضافة خطاف PAM يُرسل POST لموضوع ntfy عند تسجيل الدخول
أفضل ممارسات الأمان
- فعّل المصادقة فوراً — بدونها يمكن لأي شخص يعرف URL سيرفرك النشر والاشتراك
- استخدم أسماء مواضيع طويلة عشوائية كطبقة ثانية — الشتى يمنع التخمين العرضي
- أنشئ رموز وصول لكل سكريبت بدلاً من مشاركة كلمة المرور الرئيسية في السكريبتات
- ضع ntfy خلف Nginx Proxy Manager مع HTTPS — النشر عبر HTTP العادي يكشف محتوى الرسائل
- اضبط auth-default-access: deny في server.yml لحجب القراءة والكتابة المجهولة
- راقب سجلات ntfy لأنماط وصول غير متوقعة للمواضيع قد تشير لوصول غير مصرح
المنافذ وإعدادات جدار الحماية
تعمل ntfy على المنفذ 80 (HTTP) وبالاختيار 443 (HTTPS) افتراضياً. ضعها خلف Nginx Proxy Manager على HTTPS المنفذ 443 — يجب على جميع الناشرين والمشتركين استخدام HTTPS لتشفير محتوى الرسائل أثناء النقل. تطبيقات Android/iOS وواجهة الويب تتصل بـ URL السيرفر المضبوط. لا تحتاج منافذ واردة غير 443. إذا استخدمت Firebase لتسليم push على Android، يلزم الوصول الصادر لخوادم Google FCM؛ نسخة F-Droid تتجنب هذا تماماً.
النسخ الاحتياطي والصيانة
- بيانات ntfy قليلة — انسخ ملف server.yml
- انسخ قاعدة بيانات المصادقة (ntfy.db أو مسار auth-file المضبوط) إذا كنت تستخدم المصادقة
- انسخ مجلد تخزين المرفقات إذا تستخدم مرفقات الملفات في الإشعارات
- تاريخ الرسائل في SQLite (cache-file في server.yml) — انسخه إذا كان التاريخ مهماً
- docker-compose.yml وأي volumes منثورة هي الحجم الكامل للنسخة الاحتياطية
- ntfy عديمة الحالة بما يكفي أن الاستعادة مجرد إعادة نشر بملفات الضبط
الأخطاء الشائعة
- تشغيل ntfy بدون مصادقة — يمكن لأي شخص نشر spam أو قراءة تنبيهاتك
- استخدام أسماء مواضيع قصيرة أو سهلة التخمين — عاملها كأسرار مشتركة
- عدم تفعيل HTTPS — محتوى الرسائل ينتقل بنص عادي عبر HTTP
- تضمين كلمة مرور ntfy في سكريبتات bash — استخدم رموز وصول بدلاً من ذلك
- عدم اختبار تسليم الإشعارات من سكريبتاتك الفعلية قبل الاعتماد عليها في الإنتاج
- نسيان ضبط ntfy كقناة إشعار في أدوات المراقبة بعد النشر
استكشاف الأخطاء وإصلاحها
- الإشعارات لا تصل للهاتف → تحقق من أن URL الاشتراك يطابق سيرفرك بالضبط بما فيه البروتوكول
- أخطاء مصادقة (401) → تحقق من أن البيانات في server.yml تطابق ما يستخدمه سكريبتك
- التطبيق يقول 'connection refused' → تأكد من أن حاوية ntfy تعمل: docker compose ps
- أخطاء شهادة HTTPS في التطبيق → تأكد من صلاحية شهادة Nginx Proxy Manager
- الرسائل تُنشر لكن لا تصل → تحقق من أن اسم الموضوع يطابق تماماً (حساس للحالة)
- تأخر في الإشعارات → تأكد من أن التطبيق في وضع WebSocket وليس polling في الإعدادات
- التطبيق يعمل على WiFi لكن لا على بيانات الجوال → تأكد من أن المنفذ 443 للسيرفر متاح علناً
البدائل
Gotify هو البديل الأكثر شيوعاً — أبسط ومكوّن من ملف ثنائي واحد، لكنه يتطلب تطبيق Gotify المخصص (لا يوجد تطبيق iOS رسمي). Pushover خدمة سحابية مدفوعة (5 دولارات مرة واحدة) بدعم ممتاز لـ iOS/Android لكن إشعاراتك تمر عبر خوادمهم. Apprise مكتبة Python (وليس سيرفر) ترسل لأكثر من 50 قناة إشعار في آنٍ واحد — مفيدة للتنبيه متعدد الأهداف. روبوتات Telegram شائعة للتنبيهات ذاتية الاستضافة وتعمل عالمياً دون بنية تحتية لكنها تتطلب حساب Telegram.
متى لا تستخدمه
تجنب ntfy إذا كنت بحاجة لتسليم رسائل مضمون مع تأكيد وإعادة محاولة — ntfy من نوع fire-and-forget؛ إذا كان المشترك غير متصل قد تضيع الرسائل حسب ضبط cache. لا تستخدمها كبديل دردشة أو مراسلة فريق — استخدم Mattermost لذلك. إذا كانت مؤسستك تعمل بالفعل على Slack أو Teams مع دعم جيد لـ webhooks، إضافة ntfy يخلق منظومة أخرى للصيانة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل أحتاج حساب Google أو Firebase لاستخدام ntfy على Android؟
لا. تطبيق ntfy على F-Droid يستخدم اتصال WebSocket مباشر بسيرفرك — لا Firebase، لا خدمات Google، لا حساب Google مطلوب. نسخة Play Store تستخدم Firebase للتسليم (لكفاءة البطارية) لكن يمكن تعطيله لكل اشتراك. للخصوصية الكاملة والاستقلالية عن Google، استخدم نسخة F-Droid مع سيرفر ntfy ذاتي الاستضافة.
كيف أرسل إشعاراً من سكريبت bash؟
سطر واحد: curl -d 'اكتملت النسخة الاحتياطية' https://ntfy.yourdomain.com/mytopic. مع المصادقة: curl -u username:password -d 'اكتملت النسخة الاحتياطية' https://ntfy.yourdomain.com/mytopic. مع عنوان وأولوية: curl -H 'Title: نسخة احتياطية' -H 'Priority: high' -d 'تمت النسخة الاحتياطية' https://ntfy.yourdomain.com/mytopic. لا SDK ولا مكتبة مطلوبة.
هل يمكن لأشخاص متعددين الاشتراك في نفس الموضوع؟
نعم. يمكن لأي عدد من الأجهزة والأشخاص الاشتراك في نفس الموضوع — يتلقون جميعاً كل رسالة منشورة فيه. هذا يجعل ntfy مفيداً للتنبيهات على مستوى الفريق حيث يحتاج كل من في حالة standby لنفس الإشعار. أنشئ مواضيع منفصلة لأنواع تنبيهات مختلفة (ops-alerts، personal-scripts، backup-status) لتجنب إغراق الإشعارات.
هل يمكنني إرسال إشعارات ntfy لـ Slack أو البريد أيضاً؟
ntfy نفسها تُسلّم لعملاء ntfy المشتركين فقط. لكن كثيراً من أدوات المراقبة التي تدعم ntfy تدعم أيضاً قنوات أخرى في آنٍ واحد — اضبط كليهما في Uptime Kuma أو Grafana. بالاختيار، شغّل سكريبت يشترك في موضوع ntfy ويعيد توجيه الرسائل لـ Slack/البريد. نقطة نهاية /v1/json stream تجعل استهلاك الرسائل برمجياً وإعادة نشرها في أي مكان أمراً سهلاً.
كم مدة احتفاظ ntfy بتاريخ الرسائل؟
بشكل افتراضي، تحتفظ ntfy بالرسائل في الذاكرة (تضيع عند إعادة التشغيل). لاستمرارية التاريخ، اضبط cache-file في server.yml لمسار SQLite وضبط cache-duration (مثل 24h). المشتركون الذين يعيدون الاتصال بعد فترة يمكنهم جلب الرسائل الفائتة حتى مدة الـ cache. بدون ملف cache، يرى المشتركون فقط الرسائل المرسلة بعد اتصالهم.
هل هناك حد لعدد الإشعارات التي يمكنني إرسالها؟
على نسخة ntfy ذاتية الاستضافة، تتحكم في حدود المعدل عبر إعدادات visitor-request-limit-* في server.yml. بشكل افتراضي توجد حدود سخية لمنع الإساءة على النسخ العامة. على سيرفرك الخاص بمصادقة، يمكنك إزالة الحدود فعلياً للمستخدمين الموثوقين. ntfy.sh (النسخة السحابية العامة) لها حدود صارمة — سبب آخر للاستضافة الذاتية.
كيف أدمج ntfy مع Uptime Kuma؟
في Uptime Kuma، اذهب لـ الإعدادات > Notifications > Add Notification > اختر ntfy. أدخل URL سيرفر ntfy واسم الموضوع والأولوية. إذا كنت تستخدم المصادقة، أدخل اسم المستخدم وكلمة المرور أو الرمز. اختبر الإشعار للتحقق من التسليم. ثم اربط قناة الإشعار هذه بكل مراقب تريد تنبيهاً له. Uptime Kuma ترسل إشعار ntfy عند توقف مراقب أو استعادته.
هل يمكن استخدام ntfy بدون نطاق — بعنوان IP فقط؟
نعم، تعمل ntfy مع عنوان IP. لكن HTTPS على IP العادي يتطلب شهادة ذاتية التوقيع قد يرفضها تطبيق ntfy أو يعرض تحذيراً بشأنها. أسهل طريقة استخدام نطاق مجاني (DuckDNS، nip.io) مع Let's Encrypt للحصول على شهادة HTTPS صالحة، أو الوصول لـ ntfy على الشبكة المحلية فقط حيث تتحكم في ثقة الشهادات. للاستخدام العام عبر الإنترنت، نطاق بشهادة صالحة موصى به بشدة.
