🔔 تثبيت Gotify — سيرفر إشعارات فورية ذاتي الاستضافة
انشر Gotify على Ubuntu — سيرفر بسيط ذاتي الاستضافة لإرسال واستقبال الإشعارات الفورية من سكريبتاتك وتطبيقاتك وسيرفراتك، مع واجهة ويب وتطبيق أندرويد.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/gotify/gotify-ubuntu.sh
chmod +x gotify-ubuntu.sh
sudo bash gotify-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/gotify/gotify-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x gotify-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر، ويسحب صورة gotify/server، ويشغّلها على المنفذ 8146 مع تخزين دائم في ./data. اسم مستخدم المسؤول هو admin وتُنشأ كلمة مرور عشوائية وتُطبع في النهاية.
sudo bash gotify-ubuntu.sh
4 تسجيل الدخول إلى واجهة الويب
افتح المتصفح وانتقل إلى Gotify، ثم سجّل الدخول بـ admin وكلمة المرور المُنشأة:
http://<your-server-ip>:8146
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8146 | Web UI + REST API + WebSocket (host → container 80) |
نظرة عامة
Gotify سيرفر خفيف وذاتي الاستضافة لإرسال واستقبال الإشعارات الفورية، مكتوب بلغة Go. يكشف واجهة REST API بسيطة يمكن لأي سكريبت أو مهمة cron أو أداة مراقبة أو تطبيق استدعاءها بطلب HTTP واحد لتسليم إشعار، يظهر فوراً في واجهة الويب أو تطبيق أندرويد الرسمي عبر اتصال WebSocket دائم. على عكس خدمات الدفع التجارية، يعمل Gotify بالكامل على سيرفرك الخاص، ولا يخزّن بيانات لدى طرف ثالث، ولا يملك حدوداً للرسائل أو رسوم اشتراك. إنه من أبسط الطرق للحصول على تنبيهات فورية من بنيتك التحتية الخاصة.
لماذا تستخدمه
الحصول على إشعار لحظة انتهاء نسخة احتياطية، أو إعادة تشغيل سيرفر، أو فشل سكريبت عادة يعني الاعتماد على البريد الإلكتروني (بطيء ويسهل تفويته) أو خدمة دفع تابعة لطرف ثالث (حساب إضافي، مقايضة خصوصية أخرى، وغالباً محدود المعدل في الفئة المجانية). يحل Gotify هذا بحاوية ذاتية الاستضافة واحدة: أي سكريبت يستطيع إجراء طلب HTTP POST يمكنه دفع إشعار مباشرة لهاتفك أو حاسوبك خلال ثوانٍ. بما أنه ذاتي الاستضافة بالكامل، لا توجد حصة رسائل، ولا شركة خارجية تتعامل مع محتوى تنبيهاتك، ولا اعتماد على خدمة قد تُغلق أو تغيّر تسعيرها.
متى تحتاجه
- تريد إشعارات فورية من السكريبتات ومهام cron وأدوات المراقبة دون الاعتماد على البريد الإلكتروني أو خدمة طرف ثالث
- تحتاج طريقة بسيطة لعدة تطبيقات لإرسال إشعارات لك، كل منها برمز مميز وأيقونة خاصة به
- تريد اتصال WebSocket دائماً حتى تصل الإشعارات فوراً لهاتفك أو حاسوبك، وليس بتأخير
- تُؤتمت نسخاً احتياطية أو عمليات نشر أو فحوصات مراقبة وتريد طبقة تنبيه خفيفة سهلة الاستدعاء من أي لغة
- تريد تحكماً كاملاً في بيانات إشعاراتك بدلاً من توجيهها عبر مزود دفع تجاري
- تحتاج مركز إشعارات يمكن لأدوات ذاتية الاستضافة أخرى (Uptime Kuma، سكريبتات النسخ الاحتياطي، خطوط CI) الإرسال إليه جميعاً
من يحتاجه
- مشغلو المختبرات المنزلية الذين يريدون تنبيهات فورية عند فشل مهمة نسخ احتياطي أو إعادة تشغيل حاوية أو فحص مساحة القرص
- المطورون الذين يريدون نقطة إشعار بسيطة يستدعونها من السكريبتات أو خطوط CI/CD أو مهام cron
- مسؤولو الأنظمة الذين يراقبون عدة سيرفرات ويريدون مكاناً مركزياً واحداً تصل إليه إشعارات جميعها
- المستضيفون الذاتيون الذين يشغّلون Uptime Kuma أو Watchtower أو أدوات أخرى تدعم Gotify كهدف إشعار
- المستخدمون المهتمون بالخصوصية الذين لا يريدون مرور محتوى تنبيهاتهم عبر خدمة دفع تابعة لطرف ثالث
- الفرق الصغيرة التي تريد قناة إشعارات مشتركة لأحداث النشر أو البنية التحتية دون إضافة منصة دردشة ثقيلة
- أي شخص يريد واجهة برمجية بسيطة جداً لـ 'أرسل لي إشعاراً' لمشاريع الأتمتة الشخصية
حالات الاستخدام الشائعة
- الحصول على إشعار لحظة اكتمال أو فشل سكريبت نسخ احتياطي مجدول
- استقبال تنبيه عند تعطل سيرفر أو خدمة مراقَبة، عبر تكامل مع أدوات مثل Uptime Kuma
- دفع إشعار من خط CI/CD عند نجاح أو فشل عملية نشر
- إرسال رسالة لنفسك من سكريبت أتمتة منزلية عند تفعيل حساس أو اكتمال مهمة
- توحيد إشعارات عدة تطبيقات ذاتية الاستضافة في صندوق وارد واحد على هاتفك
- تنبيه نفسك عند انتهاء سكريبت طويل التشغيل أو مهمة معالجة بيانات
الميزات الرئيسية
- واجهة REST API بسيطة — طلب HTTP POST واحد بعنوان ورسالة يُسلّم إشعاراً
- رموز مميزة لكل تطبيق حتى يكون لكل سكريبت أو خدمة هويته وأيقونته وسجل رسائله الخاص
- اتصال WebSocket دائم للتسليم الفوري لواجهة الويب والعملاء المتصلين دون تأخير استطلاع
- تطبيق أندرويد رسمي بإشعارات دفع، بالإضافة إلى واجهة ويب نظيفة يمكن الوصول إليها من أي متصفح
- مستويات أولوية للرسائل تتحكم في ظهور الإشعار وصوته على العميل المستقبِل
- رموز عملاء منفصلة عن رموز التطبيقات، تتيح وصولاً للقراءة فقط للوحات التحكم أو التكاملات
- نظام إضافات لتوسيع الوظائف، مثل الرسائل المجدولة أو تكاملات الخدمات الخارجية
- سيرفر Go خفيف بملف تنفيذي واحد بقاعدة بيانات SQLite أو PostgreSQL صغيرة واستهلاك موارد منخفض
كيفية الاستخدام بعد التثبيت
- سجّل الدخول لواجهة الويب على http://your-server-ip:8146 باسم المستخدم admin وكلمة المرور المُنشأة من مخرجات التثبيت
- غيّر كلمة مرور المسؤول فوراً من إعدادات الحساب بعد أول تسجيل دخول
- أنشئ تطبيقاً لكل سكريبت أو خدمة سترسل إشعارات — هذا يُنشئ رمزاً مميزاً فريداً
- أرسل إشعار اختبار بـ curl باستخدام رمز التطبيق للتأكد أن API يعمل من طرف لطرف
- ثبّت تطبيق Gotify الرسمي لأندرويد وسجّل الدخول برابط سيرفرك ورمز عميل لاستقبال إشعارات الدفع
- ادمج Gotify كهدف إشعار في أدوات مثل Uptime Kuma أو Watchtower أو سكريبتات النسخ الاحتياطي الخاصة بك
- نظّم الإشعارات بإنشاء تطبيق منفصل لكل خدمة حتى يبقى سجل الرسائل سهل التصفح
- أعدّ وكيلاً عكسياً مع HTTPS إذا أردت أن يستقبل تطبيق أندرويد الإشعارات بموثوقية خارج شبكتك المحلية
أفضل ممارسات الأمان
- غيّر كلمة مرور المسؤول المُنشأة تلقائياً فوراً بعد أول تسجيل دخول — لا تترك الافتراضية أبداً
- ضع Gotify خلف وكيل عكسي مع HTTPS لأي وصول خارج شبكتك المحلية، لأن تطبيق أندرويد يتطلب TLS لاتصاله الدائم
- تعامل مع رموز التطبيقات كأسرار — أي شخص يملك رمزاً يستطيع إرسال إشعارات تبدو وكأنها من تطبيقاتك الموثوقة
- استخدم رموز تطبيق منفصلة لكل سكريبت أو خدمة حتى يمكن إلغاء رمز مسرّب دون التأثير على البقية
- قيّد رموز العملاء على تكاملات القراءة فقط حيثما أمكن، لأنها تستطيع الوصول لسجل الرسائل
- حافظ على تحديث صورة Gotify في Docker لتحصل على تصحيحات أمنية وإصلاحات أخطاء
- انسخ احتياطياً دليل ./data بانتظام، لأنه يحتوي حساب المسؤول ورموز التطبيقات وسجل الرسائل
- تجنّب كشف المنفذ 8146 مباشرة للإنترنت دون وكيل عكسي — HTTP العادي يكشف بيانات تسجيل الدخول والرموز
المنافذ وإعدادات جدار الحماية
يستمع Gotify على منفذ المضيف 8146 في هذا النشر، معيّن من المنفذ الداخلي 80 للحاوية، ويخدم واجهة الويب وREST API واتصال WebSocket الدائم جميعها على نفس المنفذ. لأي وصول خارج شبكتك المحلية، ضع Gotify خلف وكيل عكسي يُنهي HTTPS ويمرّر طلبات ترقية WebSocket، لأن تطبيق أندرويد يتطلب شهادة TLS صالحة لعمل اتصاله الدائم بموثوقية. على شبكة محلية موثوقة، HTTP العادي عبر المنفذ 8146 مقبول، لكن قيّده بقواعد جدار ناري إذا كان السيرفر قابلاً للوصول من شبكات غير موثوقة.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً دليل ./data الذي يحتوي قاعدة بيانات SQLite بحساب المسؤول ورموز التطبيقات وسجل الرسائل
- انسخ احتياطياً docker-compose.yml أو أمر التشغيل حتى يمكن إعادة إنشاء تعيين المنفذ وإعداد الحجم بشكل مطابق
- وثّق رموز التطبيقات بشكل منفصل إذا أردت استعادة التكاملات بسرعة دون إعادة توليدها
- اختبر استعادة دليل ./data على نسخة منفصلة دورياً للتأكد أن نسختك الاحتياطية قابلة للاستخدام فعلاً
- إذا رحّلت لسيرفر جديد، انسخ حجم ./data بالكامل بدلاً من ملف قاعدة البيانات فقط للحفاظ على أيقونات التطبيقات المرفوعة
- خزّن النسخ الاحتياطية على قرص مختلف عن دليل البيانات الحي للحماية من عطل القرص
الأخطاء الشائعة
- ترك حساب المسؤول بكلمة المرور المُنشأة تلقائياً بدلاً من تغييرها بعد أول تسجيل دخول
- كشف المنفذ 8146 مباشرة للإنترنت عبر HTTP عادي، مما يرسل بيانات تسجيل الدخول والرموز دون تشفير
- مشاركة رمز تطبيق واحد بين عدة سكريبتات غير مرتبطة، مما يجعل إلغاء الوصول لواحد فقط مستحيلاً
- نسيان أن تطبيق أندرويد يحتاج شهادة HTTPS صالحة لتسليم إشعارات دفع موثوقة في الخلفية
- عدم نسخ حجم ./data احتياطياً، مما يفقد كل رموز التطبيقات وسجل الرسائل إذا أُزيلت الحاوية
- الخلط بين رموز التطبيقات (للإرسال) ورموز العملاء (للقراءة)، مما يسبب فشل طلبات API بأخطاء صلاحيات
- التشغيل بدون restart: unless-stopped، بحيث تُوقف إعادة تشغيل السيرفر تسليم الإشعارات بصمت حتى إعادة التشغيل اليدوية
- إرسال إشعارات مفرطة الإسهاب أو مزعجة من الأتمتة، مما يؤدي لإرهاق التنبيهات وتجاهل الرسائل المهمة
استكشاف الأخطاء وإصلاحها
- الإشعارات لا تصل على أندرويد — تحقق أن التطبيق لديه اتصال WebSocket يعمل وأن HTTPS مُعدّ بشكل صحيح إذا كان الوصول عن بُعد
- طلبات API تُرجع 401 Unauthorized — تأكد من استخدام رمز تطبيق صالح وغير مُلغى في الطلب
- واجهة الويب غير متاحة — تحقق أن الحاوية تعمل باستخدام docker ps وأن المنفذ 8146 معيّن وغير محظور بجدار الحماية
- الإشعارات متأخرة وليست فورية — تحقق أن اتصال WebSocket غير محظور أو مُخزَّن مؤقتاً بسبب سوء إعداد الوكيل العكسي
- نسيت كلمة مرور المسؤول — أعد ضبطها باستخدام واجهة سطر أوامر Gotify داخل الحاوية أو بتعديل قاعدة البيانات مباشرة كملاذ أخير
- اختبار إشعار curl يفشل — تحقق مرتين أن الرمز يُمرّر كمعامل استعلام وأن حقلي الرسالة والعنوان مضبوطان بشكل صحيح
- تطبيق أندرويد لا يستطيع الاتصال — تأكد أن رابط السيرفر قابل للوصول من شبكة الهاتف وأن أي وكيل عكسي يمرّر ترقيات WebSocket
- رسائل مفقودة بعد الاستعادة — تأكد أن دليل ./data بالكامل تمت استعادته، وليس نسخة جزئية من ملف قاعدة البيانات فقط
البدائل
ntfy قائم على المواضيع ولا يحتاج حساباً للنشر، مما يجعله أبسط للإشعارات العامة أو العرضية، بينما Gotify قائم على الحسابات والرموز لمركز خاص موثّق. Pushover وPushbullet خدمات دفع تجارية متطورة بدعم أوسع للمنصات لكنها تتطلب ترخيصاً مدفوعاً أو اشتراكاً وتوجّه محتوى إشعاراتك عبر طرف ثالث. نظام إشعارات Home Assistant المدمج يعمل جيداً إذا كنت تشغّل Home Assistant بالفعل لكنه ليس سيرفر إشعارات عام مستقل. لمركز إشعارات دفع مجاني وذاتي الاستضافة بالكامل وبسيط بواجهة برمجية نظيفة، يبقى Gotify من أكثر الخيارات شعبية في مجتمع الاستضافة الذاتية.
متى لا تستخدمه
إذا كنت لا تمانع إنشاء حساب لدى خدمة طرف ثالث وتريد دعماً أوسع للمنصات جاهزاً، فقد يتطلب Pushover أو Pushbullet إعداداً أقل. إذا كنت تحتاج فقط إشعارات بسيطة قائمة على المواضيع دون حسابات مستخدمين أو مصادقة، فنموذج ntfy للنشر بدون تسجيل دخول أخف وزناً. إذا كنت منغمساً بالفعل في نظام Home Assistant، فقد تغطي تكاملات الإشعارات المدمجة فيه احتياجاتك دون إضافة حاوية أخرى. Gotify هو الأفضل عندما تريد تحديداً مركز إشعارات خاصاً وذاتي الاستضافة وموثّقاً بالرموز يتحكم فيه أنت وسكريبتاتك فقط.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
كيف يختلف Gotify عن ntfy؟
Gotify قائم على الحسابات والرموز: تسجّل الدخول، تنشئ تطبيقات، وترسل الرسائل برمز كل تطبيق لمركز خاص موثّق. ntfy قائم على المواضيع ولا يحتاج حساباً للنشر، وهو أبسط للإشعارات العامة أو العرضية.
كيف أرسل إشعاراً إلى Gotify؟
أنشئ تطبيقاً في واجهة الويب للحصول على رمز، ثم أرسل POST لنقطة نهاية الرسالة، مثلاً curl -X POST 'http://your-server:8146/message?token=APP_TOKEN' -F 'title=Backup' -F 'message=Completed'. أي أداة تستطيع إجراء طلب HTTP يمكنها إرسال رسائل.
ما المنفذ الذي يستخدمه Gotify؟
يعيّن سكريبت التثبيت منفذ المضيف 8146 للمنفذ الداخلي 80 للحاوية، بحيث تصل لواجهة الويب وAPI عبر http://your-server-ip:8146.
ما بيانات تسجيل الدخول الافتراضية؟
اسم المستخدم هو admin وكلمة المرور تُنشأ عشوائياً بواسطة سكريبت التثبيت وتُطبع في نهاية التشغيل، وتظهر أيضاً في docker logs gotify. غيّرها فوراً بعد أول تسجيل دخول.
هل أحتاج HTTPS لتطبيق أندرويد؟
للاستخدام عبر الإنترنت، نعم. يحافظ تطبيق أندرويد على اتصال WebSocket دائم ويتطلب شهادة TLS صالحة، لذا ضع Gotify خلف وكيل عكسي مع HTTPS ومرّر ترقيات WebSocket. على شبكة محلية موثوقة يمكنك استخدام HTTP عادي.