💬 تثبيت Apprise API — بوابة واحدة لأكثر من 100 خدمة إشعارات

انشر Apprise API على Ubuntu بـ Docker — بوابة إشعارات واحدة تُوصّل لـ Telegram وDiscord والبريد الإلكتروني وntfy وSlack وأكثر من 100 خدمة أخرى عبر واجهة برمجة بسيطة واحدة، على المنفذ 8189.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Apprise API على المنفذ 8189. أرسل لأكثر من 100 خدمة (Telegram وDiscord والبريد الإلكتروني وntfy...) عبر نقطة نهاية موحدة واحدة.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/apprise/apprise-ubuntu.sh
chmod +x apprise-ubuntu.sh
sudo bash apprise-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/apprise/apprise-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x apprise-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم الأمر ويُشغّل Apprise API على المنفذ 8189، مع تخزين إعداداته ومرفقاته في أحجام مُركَّبة. بعدها تُعرّف أهداف الإشعارات وترسل إليها عبر نقطة نهاية HTTP واحدة.

sudo bash apprise-ubuntu.sh

4 إرسال إشعار تجريبي

Apprise واجهة برمجة — تستدعيها من سكريبتاتك وتطبيقاتك. أرسل إشعاراً تجريبياً لهدف مُعدّ عبر نقطة النهاية:

curl -X POST -d '{"urls":"ntfy://...","body":"Hello"}' http://<your-server-ip>:8189/notify

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

المنفذالغرض
8189Notification API (host → container 8000)
./configNotification definitions and channel tokens
100+ servicesTelegram, Discord, Slack, email, ntfy, Pushover, and more

نظرة عامة

Apprise API هي غلاف HTTP ذاتي الاستضافة حول مكتبة Apprise للإشعارات، يمنحك نقطة نهاية موحدة واحدة تستطيع توصيل رسالة لأكثر من 100 خدمة إشعارات مختلفة — Telegram وDiscord وSlack والبريد الإلكتروني وntfy وPushover وMatrix وغيرها الكثير — كل واحدة يُشار إليها برابط بسيط خاص بالخدمة. بدلاً من كتابة وصيانة كود تكامل منفصل لكل قناة إشعارات تحتاج سكريبتاتك أو أدوات المراقبة أو تطبيقاتك التنبيه من خلالها، تُرسل طلب HTTP واحد لنسختك من Apprise وهي تتولى ترجمته لاستدعاء API الصحيح لكل خدمة وجهة.

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

كل أداة مراقبة وسكريبت نسخ احتياطي وإعداد أتمتة منزلية يحتاج في النهاية تنبيه أحد ما، وبدون Apprise هذا يعني عادة بناء تكامل بوت Telegram يدوياً هنا، وعميل SMTP للبريد هناك، وwebhook لـ Discord في مكان آخر — كل واحد بخصائصه وأنماط فشله الخاصة. يختصر Apprise كل هذا في استدعاء HTTP واحد بصيغة طلب موحدة، والتبديل أو إضافة قناة إشعارات يعني تغيير رابط إعداد بدلاً من إعادة كتابة كود التكامل. استضافته ذاتياً تعني أنك تتحكم أيضاً في خط أنابيب الإشعارات نفسه بدلاً من الاعتماد على موجّه إشعارات SaaS طرف ثالث.

متى تحتاجه

  • لديك عدة سكريبتات أو أدوات مراقبة أو أتمتة يحتاج كل منها إرسال إشعارات عبر قنوات مختلفة
  • تريد إضافة أو تبديل قنوات الإشعارات (Telegram، البريد، Discord، ntfy) بتغيير رابط إعداد بدلاً من إعادة كتابة كود التكامل
  • سئمت من صيانة كود تكامل إشعارات منفصل لكل خدمة تستخدمها
  • تريد واجهة برمجة HTTP واحدة وموحدة يستطيع أي سكريبت أو أداة بأي لغة استدعاءها لإرسال إشعار
  • تبني بنية تحتية للمراقبة أو التنبيه أو الأتمتة المنزلية وتحتاج خلفية إشعارات مرنة
  • تريد مركزة رموز وبيانات اعتماد قنوات الإشعارات في مكان واحد بدلاً من تشتيتها عبر سكريبتات كثيرة

من يحتاجه

  • عشاق المختبر المنزلي والاستضافة الذاتية الذين يريدون خلفية إشعارات واحدة لكل سكريبتات المراقبة والأتمتة لديهم
  • مسؤولو الأنظمة الذين يربطون تنبيهات من مهام النسخ الاحتياطي ومراقبات الجاهزية وسكريبتات cron بـ Telegram أو البريد أو منصة محادثة
  • المطورون الذين يريدون واجهة برمجة بسيطة وموحدة للإشعارات الصادرة بدلاً من تعلّم SDK كل خدمة على حدة
  • مستخدمو الأتمتة المنزلية (Home Assistant، Node-RED) الذين يحتاجون توصيل إشعارات مرن متعدد القنوات
  • الفرق التي توحّد كيفية تنبيه أدواتها وسكريبتاتها الداخلية على الأعطال أو عمليات النشر أو الأحداث عبر قنوات متعددة
  • أي شخص يستبدل مجموعة متفرقة من سكريبتات webhook لمرة واحدة ببوابة إشعارات واحدة مُصانة

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

  • إرسال تنبيهات مراقبة السيرفر والجاهزية إلى Telegram والبريد وقناة Discord في نفس الوقت من استدعاء API واحد
  • تنبيه هاتف عبر ntfy أو Pushover عند اكتمال أو فشل مهمة نسخ احتياطي أو معالجة دفعية طويلة
  • ربط أحداث الأتمتة المنزلية (Home Assistant، Node-RED) بأي خدمة محادثة أو إشعار دفع تفضّلها
  • مركزة بيانات اعتماد الإشعارات لفريق بحيث لا تحتاج السكريبتات الفردية تخزين رموز البوت أو كلمات مرور SMTP مباشرة أبداً
  • إرسال تحديثات حالة النشر أو خط أنابيب CI/CD لقناة Slack أو Mattermost عبر استدعاء webhook واحد
  • اختبار وتبديل قنوات الإشعارات دون لمس كود التطبيق — فقط حدّث إعداد رابط Apprise

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

  • دعم أكثر من 100 خدمة إشعارات عبر روابط خدمة بسيطة وموحدة (مثل tgram://‏ وdiscord://‏ وmailto://)
  • نقطة نهاية /notify/ عديمة الحالة للإشعارات الفردية ونقاط نهاية ذات حالة /add و/get و/del و/notify/{KEY} للإعدادات المحفوظة
  • تخزين إعدادات دائم بحيث لا تحتاج أهداف الإشعارات لإعادة تحديد في كل طلب
  • دعم مرفقات الملفات للإشعارات التي تتضمن صوراً أو سجلات أو مستندات
  • واجهة برمجة HTTP موحدة واحدة بغض النظر عن الخدمة الأساسية التي تستقبل الإشعار فعلياً
  • قابل للإعداد عبر متغيرات بيئة بسيطة مثل APPRISE_STATEFUL_MODE وAPPRISE_CONFIG_LOCK
  • يعمل مع أي لغة برمجة نصية أو أداة قادرة على إجراء طلب HTTP POST
  • مبني على مكتبة Apprise بايثون مفتوحة المصدر، مستفيداً من قائمتها المُصانة بنشاط للخدمات المدعومة

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

  • افتح http://your-server-ip:8189 للتأكد أن الواجهة البرمجية تعمل واستكشف واجهتها الأساسية عبر الويب
  • أضف هدف إشعارك الأول باستخدام /add/{KEY} برابط خدمة (مثل tgram://bottoken/ChatID) لحفظه لإعادة الاستخدام
  • أرسل إشعاراً تجريبياً لهدفك المحفوظ باستخدام /notify/{KEY} للتأكد أن التسليم يعمل فعلياً من طرف إلى طرف
  • للإشعارات الفردية دون حفظ إعداد، استخدم نقطة النهاية عديمة الحالة /notify/ برابط الخدمة مباشرة في الطلب
  • اضبط APPRISE_STATEFUL_MODE بشكل مناسب (simple أو hash) حسب رغبتك في إعدادات دائمة عبر إعادة التشغيل
  • اربط أدوات المراقبة أو سكريبتات النسخ الاحتياطي أو منصات الأتمتة لديك لاستدعاء نقطة نهاية Apprise بدلاً من منطق الإشعار الخاص بها
  • إذا كنت ترسل مرفقات (صور، سجلات)، تأكد أن حجم ./attachments مُركَّب وأن APPRISE_ATTACH_SIZE مضبوط بشكل مناسب
  • وثّق أي مفاتيح تُطابق أي أهداف إشعارات إذا كان عدة سكريبتات أو أعضاء فريق سيستخدمون نفس النسخة

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

  • لا تكشف المنفذ 8189 مباشرة للإنترنت العام دون وكيل عكسي ومصادقة، فهو يحمل بيانات اعتماد كل قناة مُعدّة
  • اضبط APPRISE_CONFIG_LOCK لمنع تغييرات غير مصرح بها لإعدادات الإشعارات المحفوظة إذا كانت الواجهة البرمجية قابلة للوصول من أكثر منك أنت
  • قيّد الوصول الشبكي لـ Apprise بقاعدة جدار حماية أو VPN، فأي شخص يستطيع الوصول إليه يستطيع التنبيه نيابة عنك عبر كل قناة مُعدّة
  • دوّر رموز البوت وروابط webhook وبيانات اعتماد SMTP دورياً، وحدّث إعداد Apprise المطابق عند فعل ذلك
  • حافظ على تحديث صورة Docker لتلقي إصلاحات مع تغيّر واجهات برمجة خدمات الإشعارات وصدور إصلاحات أمان
  • تجنّب تخزين أهداف إشعارات حساسة جداً (مثل المرتبطة بتنبيهات بنية تحتية حرجة) على نسخة قابلة للوصول من شبكات غير موثوقة
  • استخدم مفاتيح فريدة يصعب تخمينها للإعدادات ذات الحالة بدلاً من أسماء متوقعة إذا كانت نقطة نهاية الواجهة قابلة للوصول أبعد من سكريبتاتك الخاصة

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

يستمع Apprise API على المنفذ 8189 على المضيف، المُعيَّن من المنفذ الداخلي 8000 في الحاوية. ولأن حجم الإعداد يخزّن بيانات اعتماد (رموز بوت، كلمات مرور SMTP، أسرار webhook) لكل قناة إشعارات أعددتها، يجب ألا يُكشف هذا المنفذ مباشرة للإنترنت العام أبداً — أي شخص يصل إليه يستطيع تشغيل إشعارات عبر كل قناة أعددتها. أبقه على شبكتك المحلية، خلف VPN مثل WireGuard، أو خلف وكيل عكسي بمصادقة إذا كان الوصول عن بُعد ضرورياً فعلاً، واحجب الوصول الوارد المباشر للمنفذ 8189 في الجدار الناري من أي جهة عدا شبكتك الموثوقة أو الوكيل.

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

  • انسخ حجم ./config احتياطياً — يحمل كل تعريف هدف إشعار محفوظ وبيانات الاعتماد اللازمة للوصول لكل خدمة
  • وثّق أي قنوات إشعارات مُعدّة تحت أي مفاتيح، في حال احتجت إعادة بناء ملف الإعداد الخام يدوياً
  • انسخ docker-compose.yml وأي إعداد متغيرات بيئة (APPRISE_STATEFUL_MODE وغيرها) احتياطياً مع البيانات
  • إذا كنت تستخدم مرفقات ملفات، انسخ حجم ./attachments احتياطياً أيضاً إذا كان يحمل ما تحتاج الاحتفاظ به
  • احفظ النسخ الاحتياطية خارج السيرفر، فهذه النسخة تحمل بيانات اعتماد حية لخدمات خارجية محتملة كثيرة
  • اختبر استعادة دورياً: شغّل حاوية جديدة، استعد حجم الإعداد، وتأكد أن أهداف الإشعارات المحفوظة لا تزال تعمل بشكل صحيح

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

  • كشف المنفذ 8189 للإنترنت دون مصادقة، ما يتيح لأي شخص يجده إرسال إشعارات عبر كل قنواتك المُعدّة
  • فقدان حجم ./config دون نسخة احتياطية، ما يتطلب إعادة إعداد كل هدف إشعار يدوياً من الصفر
  • ترميز روابط خدمة برموز مباشرة في سكريبتات منفصلة كثيرة بدلاً من مركزتها كإعدادات Apprise محفوظة
  • عدم ضبط APPRISE_CONFIG_LOCK على نسخة مشتركة أو قابلة للوصول خارجياً، ما يسمح بتغيير الإعداد بشكل غير متوقع
  • نسيان تحديث إعداد Apprise بعد تدوير رمز بوت أو رابط webhook، ما يسبب أعطال إشعارات صامتة
  • عدم اختبار تسليم الإشعارات من طرف إلى طرف بعد الإعداد الأولي، واكتشاف قناة مُعدّة بشكل خاطئ فقط عندما يفشل تنبيه حقيقي في الوصول

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

  • الإشعار لا يُسلَّم ← تحقق أن صيغة رابط الخدمة صحيحة لتلك الخدمة تحديداً (الرموز ومعرفات المحادثة والصيغ تختلف بين الخدمات)
  • الإعداد المحفوظ غير موجود ← تأكد أن المفتاح المستخدَم في /notify/{KEY} يطابق تماماً ما استُخدم عند إضافة الهدف بـ /add/{KEY}
  • الإعداد لا يستمر عبر إعادة التشغيل ← تحقق أن APPRISE_STATEFUL_MODE مضبوط على simple أو hash، وليس معطّلاً
  • الواجهة البرمجية تُعيد خطأ صلاحية أو قفل ← تحقق ما إذا كان APPRISE_CONFIG_LOCK مفعّلاً ويحجب تغييرات الإعداد كما هو متوقع
  • المرفق يفشل في الإرسال ← تحقق أن حجم ./attachments مُركَّب وتحقق أن APPRISE_ATTACH_SIZE ليس أصغر من الملف المُرسَل
  • واجهة الويب أو الواجهة البرمجية غير متاحة ← تأكد أن الحاوية تعمل وأنك تتصفح المنفذ 8189 على المضيف، وليس المنفذ الداخلي 8000 للحاوية
  • الإشعار يعمل عبر curl لكن ليس من سكريبتك ← تحقق مرتين من تطابق طريقة HTTP والترويسات وصيغة جسم JSON مع ما تتوقعه نقطة النهاية

البدائل

ntfy وGotify خدمتا إشعارات دفع ذاتيتا الاستضافة بتطبيقَي هاتف مخصصَين — عادة ما تكونان وجهة تُنبّهها، لا بوابة لخدمات أخرى، ويستطيع Apprise فعلياً التوصيل لكليهما. يستطيع n8n وNode-RED إرسال إشعارات كجزء من أتمتة سير عمل أوسع، وهذا أقوى لكنه أثقل بكثير إذا كان كل ما تحتاجه هو تتابع إشعارات بسيط. أدوات مراقبة بأسلوب Healthchecks.io لديها بعض تكاملات الإشعارات المدمجة، لكنها عادة محدودة بتلك الأداة تحديداً بدلاً من كونها قابلة للاستخدام من أي سكريبت. لبوابة خفيفة ومخصصة وذاتية الاستضافة تتحدث مع أكثر من 100 خدمة إشعارات عبر واجهة برمجة بسيطة واحدة، يبقى Apprise الخيار الأكثر مباشرة وتوافقاً واسعاً.

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

إذا كنت تحتاج التنبيه عبر قناة واحدة فقط دائماً (لنقل Telegram فقط)، فدمج واجهة برمجة تلك الخدمة الواحدة مباشرة في سكريبتك قد يكون أبسط من إعداد وصيانة نسخة Apprise منفصلة. إذا كنت تحتاج إشعارات غنية وتفاعلية بأزرار أو سير عمل أو سلاسل موافقة متعددة الخطوات، فمنصة أتمتة كاملة مثل n8n خيار أنسب من نموذج الإرسال البسيط لـ Apprise. تجنّب كشف Apprise لشبكات غير موثوقة إذا لم تكن مستعداً لتأمينه بشكل صحيح، فنسخة مخترَقة تستطيع التنبيه نيابة عنك عبر كل قناة مُعدّة. للفرق التي تمتلك بالفعل منصة تنبيه مخصصة (PagerDuty، Opsgenie) بتوجيه مناوبة وسياسات تصعيد، فتكاملات تلك الأداة الأصلية على الأرجح أنسب من توجيه كل شيء عبر Apprise.

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

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

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

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

ما هو Apprise API؟

إنه بوابة إشعارات شاملة. بدلاً من البرمجة ضد واجهة كل خدمة الخاصة بها، ترسل طلب HTTP واحد لـ Apprise وهو يُوصّل رسالتك لأي من أكثر من 100 خدمة أعددتها — Telegram وDiscord وSlack والبريد الإلكتروني وntfy وPushover وغيرها الكثير — كل واحدة يُشار إليها برابط بسيط.

ما المنفذ الذي يستخدمه؟

تعمل الواجهة البرمجية على المنفذ 8189 على المضيف، المُعيَّن من المنفذ الداخلي 8000 للحاوية. ترسل طلبات HTTP إليها هناك. ولأنها تخزّن رموز كل قنوات إشعاراتك، أبقِ المنفذ 8189 على شبكتك المحلية أو خلف وكيل عكسي مُصادَق عليه بدلاً من كشفه مباشرة للإنترنت.

كيف أرسل إشعاراً؟

تُجري طلب HTTP للواجهة البرمجية لـ Apprise، مُشيراً إما لرابط Apprise الخاص بالهدف مباشرة عبر نقطة النهاية عديمة الحالة /notify/، أو إعداد مُسمّى حفظته سابقاً بـ /add/{KEY} ثم تشغّله بـ /notify/{KEY}.

كيف يختلف عن ntfy أو Gotify؟

ntfy وGotify خدمتا إشعارات دفع ذاتيتا الاستضافة بتطبيقَي هاتف خاصَين بهما — عادة ما تكونان وجهة. Apprise بوابة تُوصّل لخدمات كثيرة، بما فيها ntfy وGotify، بدلاً من كونه خدمة إشعارات بحد ذاته.

هل يخزّن رموز قنواتي؟

نعم — عند إعداد قنوات، تُخزَّن بيانات اعتمادها (رموز بوت، كلمات مرور SMTP، أسرار webhook) في حجم الإعداد حتى يستطيع Apprise التسليم نيابة عنك. هذا يجعل النسخة حساسة: أي شخص يصل للواجهة البرمجية يستطيع التنبيه نيابة عنك عبر كل قناة.