> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# Gotify: سيرفر إشعارات بسيط لسكربتاتك وتطبيقاتك
- URL: https://arabroot.io/articles/gotify-سيرفر-اشعارات-بسيط-لسكربتاتك-وتطبيقاتك/
- Published: 2026-11-20T02:35:04.000Z
- Updated: 2026-11-20T03:32:23.000Z
- Description: كيف تشغل Gotify على سيرفرك فتصل تنبيهات سكربتاتك وأدواتك إلى هاتف Android بتوكن إرسال لا يقرأ، ومعه إضافة Go تنبهك عندما تسكت مهمة مجدولة.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الحوسبة السحابية وبدائلها, التشغيل والنسخ الاحتياطي, DevOps وCI/CD, الاستضافة الذاتية

إذا كان لديك سيرفر أو اثنان، وعليهما سكربتات نسخ احتياطي Backup ليلية، وخط نشر CI يرسل كوداً إلى الإنتاج Production، وأداة مراقبة Monitoring تعرف متى يمتلئ القرص، فأنت تحتاج إلى مكان واحد تصل إليه رسائل كل هذه الأدوات، ثم تصل منه إلى هاتفك. والبريد لا يصلح لذلك لأن الرسالة العاجلة تضيع بين عشرات الرسائل، وروبوتات المحادثة في الخدمات التجارية تنقل أسماء سيرفراتك وأخطاءها إلى طرف ثالث، وقد شرحنا في [إشعارات فورية إلى هاتفك مع ntfy](https://arabroot.io/articles/%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D9%81%D9%88%D8%B1%D9%8A%D8%A9-%D8%A7%D9%84%D9%89-%D9%87%D8%A7%D8%AA%D9%81%D9%83-%D9%85%D8%B9-ntfy/) أداة تحل هذه المشكلة بفكرة المواضيع Topics، أما هذا المقال فعن أداة أقدم وأبسط في فكرتها اسمها [Gotify](https://gotify.net/?ref=arabroot.io).

وGotify سيرفر صغير مكتوب بلغة Go يستقبل الرسائل عبر واجهة برمجية REST API، ويحفظها في قاعدة بيانات Database، ويدفعها فوراً عبر WebSocket إلى تطبيق Android وإلى واجهة الويب WebUI وإلى أي برنامج يفتح الاتصال نفسه، وكل ذلك مع فصل واضح بين من يرسل ومن يستقبل. والمشروع مفتوح المصدر بترخيص MIT على [GitHub](https://github.com/gotify/server?ref=arabroot.io)، ولا يحتاج إلى أي خدمة خارجية حتى يعمل. وسوف نناقش في هذا المقال ما يلي:

- ما هو Gotify، والفرق بين التطبيقات Applications والعملاء Clients والمستخدمين Users، ولماذا لكل منها توكن Token مختلف.
- كيف تمر الرسالة داخل السيرفر، وكيف تتحول الأولوية Priority إلى قنوات إشعار Notification Channels على Android.
- تشغيل Gotify 3.1.1 في Docker بملف إعداد بيئة Environment File، وكلمة مرور المدير من ملف سري Secret File.
- تطبيق Android وواجهة الويب، والإرسال من curl ومن أداة سطر الأوامر CLI، والاستماع إلى WebSocket من سكربت.
- ماذا يستطيع كل توكن أن يفعل، ولماذا لا يقرأ توكن التطبيق الرسائل.
- الإضافات Plugins المكتوبة بلغة Go، وإضافة نبضات Heartbeat كاملة تنبهك عندما تسكت مهمة مجدولة Scheduled Job، ومشكلة في الإعداد تقع فيها بسهولة.
- الإنتاج: ال Reverse Proxy مع WebSocket وHTTPS والدخول الموحد OIDC والنسخ الاحتياطي، ثم مقارنة سريعة مع ntfy وأخطاء شائعة.

وإذا لم تقرأ بعد كيف تصل الرسالة من سيرفر إلى هاتف، ولماذا تمر أغلب الإشعارات عبر Google وApple، فابدأ بمقال [كيف تعمل الإشعارات الفورية Push Notifications](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D8%A7%D9%84%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%81%D9%88%D8%B1%D9%8A%D8%A9-push-notifications/)، لأن تطبيق Gotify على Android يأخذ الطريق الآخر الذي لا يمر على Google أصلاً، كما سوف نرى.

## ما هو Gotify؟ تطبيقات Applications ترسل، وعملاء Clients يستقبلون

أبسط تعريف لGotify أنه صندوق بريد خاص بالتنبيهات: الأدوات تضع فيه رسائل، وأجهزتك تقرأ منه، والسيرفر يتذكر من وضع ماذا ولمن. والمشروع في [موقعه الرسمي](https://gotify.net/?ref=arabroot.io) ثلاثة أجزاء: السيرفر `gotify/server` الذي فيه الواجهة والمنطق كله، وتطبيق Android الذي يشترك في تدفق الرسائل ويعرضها كإشعارات، وأداة سطر الأوامر `gotify/cli` التي تسهل الإرسال من الطرفية Terminal، والتوثيق نفسه يقول إنها ليست ضرورية لأن أي عميل HTTP يكفي.

والمهم في Gotify هو التعريفات الأربعة التي تبدأ بها [مقدمة التوثيق](https://gotify.net/docs/?ref=arabroot.io)، لأن كل شيء بعدها مبني عليها:

- **التطبيق Application:** جهاز أو برنامج يرسل الرسائل فقط، مثل سكربت النسخ الاحتياطي أو خط النشر، وله توكن يبدأ في الإصدار 3 بالبادئة `gtfya.`.
- **العميل Client:** جهاز أو برنامج يستقبل الرسائل ويدير التطبيقات والعملاء والرسائل، مثل هاتفك أو المتصفح، وله توكن يبدأ ب `gtfyc.`، والتوثيق واضح في أن العميل لا يرسل الرسائل بالطريقة العادية.
- **المستخدم User:** الحساب الذي يملك التطبيقات والعملاء، وكل مستخدم يرى ويدير ما أنشأه هو فقط، ومعه رسائل تطبيقاته.
- **الرسالة Message:** محتوى Content وعنوان Title وتاريخ إنشاء ومعرف التطبيق الذي أرسلها وأولوية Priority.

وقد يتساءل البعض: لماذا هذا الفصل بين المرسل والمستقبل، وntfy مثلاً يعطي الحساب صلاحية قراءة وكتابة في موضوع؟ والإجابة أن الفصل في Gotify جزء من التصميم وليس إعداداً تضيفه، فالسكربت الذي على سيرفر الإنتاج يحمل توكناً لا يستطيع إلا الإرسال، فإذا تسرب من ملف أو من سجلات Logs خط النشر فأقصى ما يفعله المهاجم أن يرسل رسائل مزعجة باسم ذلك التطبيق، ولا يقرأ بها تنبيهاتك ولا يعرف أسماء سيرفراتك من رسائل الأدوات الأخرى. والصورة التالية تبين الأطراف كلها ومسار الرسالة بينها:

![على اليسار أربعة مرسلين هي سكربت النسخ الاحتياطي على web-01 وخط النشر CI والمراقبة Alertmanager وإضافة داخل السيرفر، كل منها تطبيق بتوكن gtfya، ترسل أسهماً برتقالية إلى سيرفر Gotify 3.1.1 في الوسط وفيه قاعدة بيانات SQLite والمستخدمون ومجلد الإضافات، وعلى اليمين ثلاثة عملاء هي تطبيق Android وواجهة الويب وسكربت، كل منها بتوكن gtfyc، تصلها أسهم خضراء عبر GET /stream وWebSocket، مع أربع خطوات مرقمة](https://arabroot.io/content/images/2026/11/gotify-01-architecture.webp)

التطبيق يرسل بتوكن، والعميل يستقبل بتوكن آخر عبر WebSocket

ولاحظ أن الرسائل تنتمي إلى المستخدم عبر تطبيقاته، فلا توجد في Gotify مواضيع يشترك فيها أي أحد، وإنما كل عميل يملكه مستخدم يرى رسائل تطبيقات ذلك المستخدم كلها. فإذا كان فريقك ثلاثة أشخاص وتريد أن يصل التنبيه نفسه إلى الثلاثة، فالأبسط حساب واحد للفريق يملك التطبيقات، ولكل شخص عميل خاص على هاتفه يمكن حذفه وحده إذا ضاع الهاتف، أما إذا كانت لكل شخص حسابه فكل مرسل يحتاج تطبيقاً عند كل حساب، وهذا من الفروق المهمة مع ntfy كما سوف نرى في [قسم المقارنة](#vs-ntfy).

## كيف يعمل Gotify من الداخل؟

السيرفر برنامج Go واحد، وداخله ثلاث واجهات تعمل على المنفذ Port نفسه: واجهة REST لإنشاء الرسائل والتطبيقات والعملاء وإدارتها، ومسار WebSocket واحد هو `/stream` للبث المباشر، وواجهة الويب التي هي نفسها عميل يستخدم الواجهتين. وقاعدة البيانات الافتراضية SQLite في ملف واحد `data/gotify.db`، ويدعم أيضاً MySQL وPostgreSQL كما في [صفحة الإعداد](https://gotify.net/docs/config?ref=arabroot.io)، وهما مفيدتان إذا كانت لديك قاعدة بيانات مدارة وتريد أن يبقى السيرفر نفسه دون حالة على القرص.

### ماذا يحدث عندما تصل رسالة؟

عندما يرسل سكربت طلب `POST /message` ومعه توكن التطبيق، يمر الطلب بالخطوات التالية بالترتيب:

1. **المصادقة Authentication:** السيرفر يقبل توكن التطبيق في الترويسة Header `X-Gotify-Key`، أو في الترويسة `Authorization: Bearer`، أو في معامل الرابط `?token=`، بحسب [توثيق الواجهة البرمجية](https://gotify.net/api-docs?ref=arabroot.io). ومن التوكن يعرف التطبيق، فلا تحتاج إلى ذكر رقمه.
2. **الأولوية الافتراضية:** إذا لم تحدد في الرسالة أولوية، يأخذ السيرفر الأولوية الافتراضية للتطبيق التي تحددها عند إنشائه.
3. **الحفظ:** تكتب الرسالة في قاعدة البيانات، وتبقى هناك حتى تحذفها أنت أو يحذفها عميل، فلا يوجد في قائمة الإعدادات أي متغير لمدة الحفظ Retention.
4. **البث:** يدفع السيرفر الرسالة بصيغة JSON إلى كل اتصال WebSocket مفتوح لعميل يملكه صاحب التطبيق، سواء كان هاتفاً أو متصفحاً أو سكربتاً.
5. **العرض:** كل عميل يقرر كيف يعرضها، وتطبيق Android يقرر بالأولوية.

والعميل الذي كان غير متصل لا يفقد شيئاً، لأنه عندما يعود يطلب الرسائل من `GET /message` فيجد كل ما وصل في غيابه، وهذا فرق آخر عن ntfy الذي يحفظ الرسائل 12 ساعة افتراضياً ثم ينساها. والجانب الآخر لهذا الحفظ أن قاعدة البيانات تكبر مع الوقت إذا لم تنظفها، وسوف نعود لذلك في [قسم حفظ الرسائل](#retention).

### لماذا WebSocket وليس الاستعلام المتكرر Polling؟

الطريقة البسيطة أن يسأل الهاتف السيرفر كل دقيقة: هل وصل شيء جديد؟ ومشكلتها أن التنبيه يتأخر حتى دقيقة، وأن الهاتف يستيقظ ويفتح اتصالاً جديداً ستين مرة في الساعة حتى لو لم يصل شيء. أما WebSocket فاتصال واحد يبقى مفتوحاً، والسيرفر يكتب فيه الرسالة لحظة وصولها، ويرسل كل 45 ثانية إطاراً Frame صغيراً من نوع Ping حتى لا يغلق أي جهاز في الطريق الاتصال لأنه يبدو خاملاً، وهذه القيمة هي `GOTIFY_SERVER_STREAM_PINGPERIODSECONDS` في الإعداد. وثمن هذه الطريقة أن التطبيق يجب أن يبقى حياً في الخلفية، وهذا ما يفسر الإشعار الدائم على Android الذي سوف نراه.

### الأولوية Priority: من رقم إلى قناة إشعار

الأولوية رقم في الرسالة، والقيم المعتادة من 0 إلى 10، وكلما ارتفع الرقم كان الإشعار أكثر إزعاجاً. و[صفحة الأولويات](https://gotify.net/docs/priority?ref=arabroot.io) تشرح ما يفعله تطبيق Android بكل مجال: 0 لا إشعار، ومن 1 إلى 3 أيقونة في الشريط، ومن 4 إلى 7 أيقونة مع صوت، ومن 8 إلى 10 أيقونة مع صوت واهتزاز. وبدل أن نكتفي بالجدول، قرأنا من الهاتف نفسه قنوات الإشعار التي ينشئها التطبيق، لأن Android منذ الإصدار 8 لا يترك للتطبيق أن يقرر الصوت والاهتزاز لكل رسالة، وإنما يضع كل إشعار في قناة لها أهمية Importance، والمستخدم يغيرها من الإعدادات:

```bash
adb shell dumpsys notification | grep -o "mId='gotify[^}]*mImportance=[0-9]" | sort -u
```

```text
mId='gotify_foreground', mName=Gotify foreground notification, mDescription=, mImportance=2
mId='gotify_messages_default_importance', mName=Normal priority messages (4–7), mDescription=, mImportance=3
mId='gotify_messages_high_importance', mName=High priority messages (>7), mDescription=, mImportance=4
mId='gotify_messages_low_importance', mName=Low priority messages (1–3), mDescription=, mImportance=2
mId='gotify_messages_min_importance', mName=Min priority messages (<1), mDescription=, mImportance=1
```

في المخرج أعلاه لاحظ التالي:

- أربع قنوات للرسائل بحسب مجال الأولوية، وأهميتها من 1 إلى 4، والأهمية 4 في Android هي التي تجعل الإشعار يظهر فوق الشاشة Heads-up مع الصوت.
- القناة الخامسة `gotify_foreground` ليست للرسائل، وإنما للإشعار الدائم الذي يقول إن التطبيق متصل، وأهميتها 2 حتى لا يصدر صوتاً.
- قناة الأولوية 0 أهميتها 1، أي الأدنى، ولذلك لم تظهر رسالتنا ذات الأولوية 0 في شريط الإشعارات أبداً، ولكنها كانت موجودة في قائمة الرسائل داخل التطبيق.

![جدول من أربعة صفوف: الأولوية 0 ومثالها تقرير يومي تذهب إلى قناة Min priority messages بأهمية 1 ولا تظهر في الشريط، والأولوية من 1 إلى 3 ومثالها نسخة قاعدة البيانات تذهب إلى قناة Low بأهمية 2 فتظهر أيقونة دون صوت، والأولوية من 4 إلى 7 ومثالها نشر v1.8.2 تذهب إلى Normal بأهمية 3 مع صوت، والأولوية من 8 إلى 10 ومثالها القرص ممتلئ تذهب إلى High بأهمية 4 مع صوت واهتزاز وظهور فوق الشاشة، وفي الأسفل قناة gotify_foreground لإشعار Connected](https://arabroot.io/content/images/2026/11/gotify-02-priority-channels.webp)

أربع قنوات للرسائل وخامسة لإشعار الاتصال

وهذا يعطيك قاعدة عملية لتصميم التنبيهات: كل تطبيق جديد أولويته الافتراضية 5، أي صوت لكل رسالة، فإذا تركت كل السكربتات على هذه القيمة تعلم فريقك أن يتجاهل صوت Gotify خلال أسبوع. لذلك اجعل التقارير اليومية ونجاح النسخ الاحتياطي على 0 أو 2، والنشر على 5، واحفظ 8 وما فوقها لما يستحق أن يوقظ أحداً، وقد شرحنا كيف تقرر ذلك في [التنبيهات Alerting: ماذا تنبه عليه](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D9%86%D8%A8%D9%8A%D9%87%D8%A7%D8%AA-alerting-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D9%86%D8%A8%D9%87-%D8%B9%D9%84%D9%8A%D9%87-%D9%88%D9%85%D8%AA%D9%89-%D8%AA%D9%88%D9%82%D8%B8-%D8%A7%D8%AD%D8%AF%D8%A7/).

## التثبيت Installation في Docker بملف إعداد Configuration لGotify 3

الآن سوف نشغل Gotify 3.1.1 في Container، ثم نرسل إليه من Container ثان على Alpine يمثل سيرفر الإنتاج `web-01`، ونستقبل على هاتف Android وفي المتصفح. والتغيير الكبير في الإصدار 3 أن ملف `config.yml` لم يعد مدعوماً، فالإعداد كله متغيرات بيئة Environment Variables يمكن أن تقرأ من ملف، كما في [دليل الانتقال إلى الإصدار 3](https://gotify.net/docs/migrate-to-3?ref=arabroot.io). والسيرفر يبحث عن الملف بالترتيب التالي ويقرأ أول ملف يجده: `gotify-server.env` في مجلد العمل، ثم `$XDG_CONFIG_HOME/gotify/gotify-server.env`، ثم `/etc/gotify/server.env`، إلا إذا حددت المسار بالمتغير `GOTIFY_CONFIG_FILE`.

📌

إذا كان لديك سيرفر Gotify 2 بملف `config.yml`، فالترقية تبدأ بتحويل الملف بالأمر `gotify-server migrate-config config.yml > gotify-server.env`، وانتبه إلى أن صيغة القوائم تغيرت من مصفوفة YAML إلى قيم مفصولة بفواصل مثل `127.0.0.1/32,::1`، وأن التوكنات لم تعد تظهر في طلبات القراءة، فكل سكربت كان يقرأ توكن تطبيق من الواجهة البرمجية سوف يتوقف.

### ملف الإعداد server.env

الملف التالي هو الذي استخدمناه، ويوضع في `/etc/gotify/server.env` داخل ال Container:

```bash
# /etc/gotify/server.env (Gotify 3.x reads its settings from an env file)
GOTIFY_SERVER_PORT=80
GOTIFY_DEFAULTUSER_NAME=admin
GOTIFY_DEFAULTUSER_PASS_FILE=/run/secrets/gotify_admin_pass
GOTIFY_DATABASE_DIALECT=sqlite3
GOTIFY_DATABASE_CONNECTION=data/gotify.db
GOTIFY_PLUGINSDIR=data/plugins
GOTIFY_REGISTRATION=false
GOTIFY_PASSSTRENGTH=12
GOTIFY_SERVER_TRUSTEDPROXIES=127.0.0.1/32
```

في الإعداد أعلاه لاحظ التالي:

- `GOTIFY_DEFAULTUSER_PASS_FILE`: كل متغير في Gotify 3 يقبل اللاحقة `_FILE` فيقرأ قيمته من ملف، وهذا مناسب لأسرار Docker وKubernetes، لأن كلمة المرور لا تظهر في `docker inspect` ولا في ملف البيئة الذي قد يصل إلى Git. وهذا الحساب ينشأ مرة واحدة عند إنشاء قاعدة البيانات، وتغيير المتغير بعدها لا يغير شيئاً.
- القيمة الافتراضية لاسم المدير وكلمة مروره هي `admin` و`admin` كما في [صفحة الدخول الأول](https://gotify.net/docs/first-login?ref=arabroot.io)، فإذا شغلت السيرفر على الإنترنت دون هذا السطر فأول من يصل إليه هو المدير.
- `GOTIFY_REGISTRATION=false` يمنع أي زائر من إنشاء حساب لنفسه، وهي القيمة الافتراضية، ولكن كتابتها صريحة تحميك من نسخة إعداد قديمة غيرتها.
- `GOTIFY_PASSSTRENGTH` هو عامل التكلفة Cost Factor لخوارزمية bcrypt التي تحفظ بها كلمات المرور، والافتراضي 10، ورفعه إلى 12 يجعل تخمين كلمة المرور من قاعدة بيانات مسربة أبطأ.
- `GOTIFY_PLUGINSDIR` مجلد الإضافات، وإذا تركته فارغاً تعطلت الإضافات كلها، وهذا خيار جيد إذا كنت لا تستخدمها.
- `GOTIFY_SERVER_TRUSTEDPROXIES` قائمة العناوين التي يثق السيرفر بترويسة `X-Forwarded-For` منها، وسوف نحتاجها في الإنتاج خلف ال Reverse Proxy.

### تشغيل ال Container

نضع كلمة مرور عشوائية في ملف، ثم نشغل السيرفر على شبكة خاصة بالتجربة، والمنفذ على `127.0.0.1` فقط حتى لا يصل إليه أحد من خارج الجهاز:

```bash
openssl rand -base64 15 | tr -d '\n' > admin_pass
docker network create sc6-net
docker run -d --name sc6-gotify --network sc6-net -p 127.0.0.1:18610:80 \
  -v "$PWD/server.env:/etc/gotify/server.env:ro" \
  -v "$PWD/admin_pass:/run/secrets/gotify_admin_pass:ro" \
  -v sc6-gotify-data:/app/data \
  gotify/server:3.1.1
docker logs sc6-gotify
curl -s http://127.0.0.1:18610/health
```

```text
{"health":"green","database":"green"}
```

وفي سجل التشغيل سطران يهمانك: `Loading file /etc/gotify/server.env` الذي يؤكد أن السيرفر قرأ ملفنا وليس الإعداد الافتراضي، و`Listen address=[::]:80` الذي يبين أنه يستمع على كل العناوين داخل ال Container. ومسار `/health` يفحص السيرفر وقاعدة البيانات معاً، فهو المسار المناسب لأداة فحص التوفر Uptime Check، ومسار `/version` يرد بالإصدار 3.1.1\. وال Volume `sc6-gotify-data` مربوط ب `/app/data`، وفيه بحسب [صفحة التثبيت](https://gotify.net/docs/install?ref=arabroot.io) قاعدة البيانات وصور التطبيقات والشهادات Certificates إذا فعلت Let's Encrypt، والتوثيق يطلب صراحة أن يكون هذا المجلد في نسختك الاحتياطية.

أما الذاكرة RAM فقد قسناها بالأمر `docker stats` والسيرفر خامل:

```text
sc6-gotify 11.84MiB / 31.29GiB 0.00%
sc6-ntfy 26.52MiB / 31.29GiB 0.11%
```

أقل من 12 MiB لسيرفر Gotify، وسيرفر ntfy على الجهاز نفسه 26.52 MiB، وكلاهما رقم صغير يسمح لك بتشغيل السيرفر على أصغر جهاز افتراضي VPS أو على Raspberry Pi. وحجم ال Image نفسه `gotify/server:3.1.1` هو 211 MB، وهو أكبر من ntfy لأنه يحمل بيئة تكفي لتحميل الإضافات كما سوف نرى.

💡

إذا كنت تفضل تشغيل Gotify دون Docker، فالمشروع ينشر ملفاً تنفيذياً لكل منصة في [صفحة الإصدار 3.1.1](https://github.com/gotify/server/releases/tag/v3.1.1?ref=arabroot.io)، ويكفيه ملف `/etc/gotify/server.env` نفسه ووحدة systemd تشغله، وقد شرحنا كتابة الوحدة وقراءة سجلاتها في [الخدمات والسجلات مع systemd](https://arabroot.io/articles/%D8%A7%D9%84%D8%AE%D8%AF%D9%85%D8%A7%D8%AA-services-%D9%88%D8%A7%D9%84%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-logs-%D9%85%D8%B9-systemd-%D9%88-journalctl/).

## إنشاء التطبيقات والعملاء من الواجهة البرمجية API

تستطيع إنشاء التطبيقات من واجهة الويب بضغطة زر، ولكن إنشاءها من الواجهة البرمجية يجعل الإعداد قابلاً للتكرار في سكربت، ويعلمك ما يحدث فعلاً. ونستخدم هنا المصادقة الأساسية Basic Auth بحساب المدير، وننشئ ثلاثة تطبيقات بأسماء عربية، ثم عميلين، واحد للهاتف وآخر للحاسوب:

```bash
AUTH="admin:$(cat admin_pass)"
API=http://127.0.0.1:18610
curl -s -u "$AUTH" -H 'Content-Type: application/json' \
  -d '{"name":"النسخ الاحتياطي","description":"backup jobs on web-01","defaultPriority":5}' $API/application; echo
curl -s -u "$AUTH" -H 'Content-Type: application/json' \
  -d '{"name":"النشر","description":"CI deploys","defaultPriority":5}' $API/application; echo
curl -s -u "$AUTH" -H 'Content-Type: application/json' \
  -d '{"name":"المراقبة","description":"Alertmanager and uptime checks","defaultPriority":8}' $API/application; echo
curl -s -u "$AUTH" -H 'Content-Type: application/json' -d '{"name":"Pixel phone"}' $API/client; echo
curl -s -u "$AUTH" -H 'Content-Type: application/json' -d '{"name":"ops laptop"}' $API/client; echo
```

```text
{"id":1,"token":"gtfya.wG3TYOUIHxDoySxRDFpXM2HOoPQW7rsJlTIbh75KJOQ","name":"النسخ الاحتياطي","description":"backup jobs on web-01","internal":false,"image":"static/defaultapp.png","defaultPriority":5,"createdAt":"2026-11-20T01:28:42.604698267Z","lastUsed":null,"sortKey":"a0"}
{"id":2,"token":"gtfya.7uF4cwKsPtokxId01uU5EPjeBiEDWPzYLP7ErrsxT-I","name":"النشر","description":"CI deploys","internal":false,"image":"static/defaultapp.png","defaultPriority":5,"createdAt":"2026-11-20T01:28:43.098307162Z","lastUsed":null,"sortKey":"a1"}
{"id":3,"token":"gtfya.h_ic7JT3Q7ui8MiPexg7B01rWooTemIIfklf5UQzHH8","name":"المراقبة","description":"Alertmanager and uptime checks","internal":false,"image":"static/defaultapp.png","defaultPriority":8,"createdAt":"2026-11-20T01:28:43.6524704Z","lastUsed":null,"sortKey":"a2"}
{"id":1,"token":"gtfyc.1GW_Oq_QwldtMiPU26h9IFoY4kASh6rcTA9cuAscOKs","name":"Pixel phone","createdAt":"2026-11-20T01:28:43.968098344Z","lastUsed":null,"expiresAfterInactivitySeconds":0}
{"id":2,"token":"gtfyc.fcliNewY_0XBL01XoR9Jz9arimqRwVpxq7RqASMoPwE","name":"ops laptop","createdAt":"2026-11-20T01:28:44.401833765Z","lastUsed":null,"expiresAfterInactivitySeconds":0}
```

في المخرج أعلاه لاحظ التالي:

- البادئة تخبرك بنوع التوكن من أول نظرة: `gtfya.` للتطبيق و`gtfyc.` للعميل، وهذا مفيد جداً عند البحث عن أسرار مسربة Leaked Secrets في الكود أو السجلات، لأن أداة الفحص تستطيع أن تبحث عن البادئة بالضبط. والتوكنات القديمة من الإصدار 2 التي تبدأ ب `A` و`C` تبقى صالحة بعد الترقية.
- الحقل `internal` يساوي `false` لأن هذه تطبيقات أنشأناها نحن، أما التطبيق الذي تنشئه إضافة لنفسها فيكون `true` كما سوف نرى.
- تطبيق المراقبة أولويته الافتراضية 8، فكل رسالة منه دون أولوية صريحة سوف تصل بصوت واهتزاز.
- العميل يحمل الحقل `expiresAfterInactivitySeconds`، وهو عدد الثواني التي يحذف بعدها العميل إذا لم يستخدم، والقيمة 0 تعني أنه لا ينتهي أبداً.
- الحقل `lastUsed` فارغ الآن، وبعد أول استخدام يحمل وقته، وهو أسرع طريقة لتعرف أي توكن ما زال مستخدماً قبل أن تحذف شيئاً.

⚠️

في Gotify 3 يظهر التوكن مرة واحدة فقط عند إنشائه أو تدويره Rotation، كما في [صفحة الإرسال](https://gotify.net/docs/pushmsg?ref=arabroot.io)، ولا تعيده طلبات القراءة ولا الواجهة بعد ذلك. لذلك احفظه فوراً في مدير الأسرار Secrets Manager أو في ملف لا يقرؤه إلا صاحبه، وإذا ضاع فلا تبحث عنه وإنما دوره بالطلب `PUT /application/{id}/security` وحدث السكربت.

## الإرسال من curl ومن السكربتات

نشغل Container صغيراً باسم السيرفر `web-01` على الشبكة نفسها، ونثبت فيه curl، ونضع فيه أربع رسائل كملفات JSON بأولويات مختلفة، كل رسالة من التطبيق الذي يناسبها:

```bash
docker run -d --name sc6-web01 --hostname web-01 --network sc6-net alpine:3.24 sleep infinity
docker exec sc6-web01 apk add --no-cache curl
docker exec -it sc6-web01 sh
```

```json
// /tmp/m0.json
{"title":"تقرير يومي","message":"اكتملت 14 مهمة مجدولة دون أخطاء","priority":0}
// /tmp/m2.json
{"title":"نسخة قاعدة البيانات","message":"اكتملت النسخة الليلية: 1.4 GB في 6 دقائق","priority":2}
// /tmp/m5.json
{"title":"نشر v1.8.2","message":"**team/app** نشره wajdy بنجاح","priority":5,"extras":{"client::display":{"contentType":"text/markdown"},"client::notification":{"click":{"url":"https://git.example.com/team/app/actions/runs/42"}}}}
// /tmp/m8.json
{"title":"web-01: القرص / ممتلئ","message":"المستخدم 93% والحد 85%","priority":8}
```

ثم نرسل الأربع من داخل ال Container، والرسالتان الأوليان بتوكن النسخ الاحتياطي، والثالثة بتوكن النشر، والرابعة بتوكن المراقبة:

```bash
BK=gtfya.wG3TYOUIHxDoySxRDFpXM2HOoPQW7rsJlTIbh75KJOQ
DEP=gtfya.7uF4cwKsPtokxId01uU5EPjeBiEDWPzYLP7ErrsxT-I
MON=gtfya.h_ic7JT3Q7ui8MiPexg7B01rWooTemIIfklf5UQzHH8
send() { curl -s -H "X-Gotify-Key: $1" -H 'Content-Type: application/json' --data-binary @"$2" http://sc6-gotify/message; echo; }
send $BK /tmp/m0.json; send $BK /tmp/m2.json; send $DEP /tmp/m5.json; send $MON /tmp/m8.json
```

```text
{"id":1,"appid":1,"message":"اكتملت 14 مهمة مجدولة دون أخطاء","title":"تقرير يومي","priority":0,"date":"2026-11-20T01:32:23.67817179Z"}
{"id":2,"appid":1,"message":"اكتملت النسخة الليلية: 1.4 GB في 6 دقائق","title":"نسخة قاعدة البيانات","priority":2,"date":"2026-11-20T01:32:26.281880726Z"}
{"id":3,"appid":2,"message":"**team/app** نشره wajdy بنجاح","title":"نشر v1.8.2","priority":5,"extras":{"client::display":{"contentType":"text/markdown"},"client::notification":{"click":{"url":"https://git.example.com/team/app/actions/runs/42"}}},"date":"2026-11-20T01:32:29.361539769Z"}
{"id":4,"appid":3,"message":"المستخدم 93% والحد 85%","title":"web-01: القرص / ممتلئ","priority":8,"date":"2026-11-20T01:32:32.033033322Z"}
```

في المخرج أعلاه لاحظ التالي:

- السيرفر يرد بالرسالة كما حفظها، ومعها رقمها `id` ورقم التطبيق `appid` الذي استنتجه من التوكن، فنحن لم نرسل رقم التطبيق أبداً.
- لا يوجد حقل انتهاء صلاحية كما في ntfy، فالرسالة باقية حتى تحذف.
- الإضافات Extras في الرسالة الثالثة محفوظة كما أرسلناها، والسيرفر لا يفسرها، وإنما يمررها للعملاء الذين يفهمونها.

### الإضافات Extras: Markdown ورابط عند الضغط

الإضافات حقل حر في الرسالة مقسم إلى نطاقات أسماء Namespaces بالشكل `client::display`، وتعمل فقط مع الطلبات بصيغة `application/json`، بحسب [صفحة الإضافات](https://gotify.net/docs/msgextras?ref=arabroot.io). وأهمها اثنان: `client::display` مع `contentType` يساوي `text/markdown` فتعرض الواجهة والتطبيق النص بتنسيق Markdown، ولذلك ظهرت `team/app` بخط عريض في الهاتف، و`client::notification` مع `click.url` فيفتح الضغط على الإشعار رابط تشغيل خط CI بدل فتح تطبيق Gotify. وهناك أيضاً `bigImageUrl` لصورة كبيرة في الإشعار، و`android::action` لفتح رابط تلقائياً عند وصول الرسالة إذا سمحت بذلك في إعدادات التطبيق.

⚠️

لا تفعل Markdown لرسالة نصها يأتي من مصدر لا تتحكم فيه، مثل مخرج أمر أو سطر من سجل أو عنوان طلب HTTP. والسبب في التوثيق نفسه: Markdown يسمح بصورة بالصيغة `![](url)` تنزل تلقائياً عند عرض الرسالة، فمن يستطيع أن يضع نصاً في رسالتك يستطيع أن يعرف متى فتحتها ومن أي عنوان، أو يظهر لك رابطاً مزوراً. لذلك اترك المحتوى `text/plain` وهو الافتراضي لكل ما يأتي من الخارج.

وإذا كنت لا تحتاج إلى الإضافات، فالصيغة الأقصر هي نموذج Form مثل `-F "title=..." -F "message=..." -F "priority=5"`، وهي ما يستخدمه أغلب الناس في سطر واحد داخل Cron. أما سكربت النسخ الاحتياطي الذي يرسل عند الفشل فقط ويعيد رمز الخروج كما هو، فقد كتبناه كاملاً في مقال ntfy، ولا يتغير فيه إلا سطر curl، فاستبدل الترويسات بالترويسة `X-Gotify-Key` والحقول الثلاثة، وقد شرحنا جدولة السكربت نفسه في [المهام المجدولة Cron أم systemd Timers](https://arabroot.io/articles/%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%AC%D8%AF%D9%88%D9%84%D8%A9-cron-%D8%A7%D9%85-systemd-timers/).

## تطبيق Android: الاتصال الدائم والأذونات Permissions

ثبتنا Gotify Android 2.10.1 من [F-Droid](https://f-droid.org/packages/com.github.gotify/?ref=arabroot.io) على محاكي Android 15، والتطبيق متاح أيضاً في Google Play وفي صفحة الإصدارات على [مستودعه](https://github.com/gotify/android?ref=arabroot.io). وعند فتحه يطلب رابط السيرفر، ثم يتصل به ليتأكد من الإصدار، فظهر لنا «Found Gotify 3.1.1»، ومعه أول ملاحظة تستحق الانتباه.

### تحذير HTTP

لأن رابط التجربة كان HTTP، أظهر التطبيق نافذة بالنص «Using HTTP is insecure and it's recommend to use HTTPS instead»، وهذا التحذير في مكانه، فتسجيل الدخول يرسل اسم المستخدم وكلمة المرور، وكل رسالة بعده تمر بنصها على الشبكة، وأي جهاز في الطريق يقرأها أو يأخذ توكن العميل ويقرأ به كل رسائلك. لذلك HTTP مقبول في تجربة على جهازك فقط، وكل استخدام حقيقي يكون خلف HTTPS كما في [قسم الإنتاج](#production).

### تسجيل الدخول ينشئ عميلاً

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

ثم يطلب التطبيق إذنين: إذن الإشعارات المعتاد منذ Android 13، وإذن جدولة المنبهات الدقيقة Exact Alarms بالنص «Gotify requires permission to schedule reconnecting after connection is lost.»، والسبب أن التطبيق إذا انقطع اتصاله بالسيرفر، لأن الشبكة تغيرت مثلاً، يحتاج أن يجدول محاولة إعادة اتصال في وقت محدد، ونظام Android منذ الإصدار 14 لا يعطي هذا الإذن تلقائياً لأغلب التطبيقات كما في [صفحة تغييرات Android 14](https://developer.android.com/about/versions/14/changes/schedule-exact-alarms?ref=arabroot.io). فإذا رفضته فقد يبقى التطبيق منقطعاً بعد تغير الشبكة حتى تفتحه بيدك.

### الإشعار الدائم «Connected» والبطارية

بعد الدخول يظهر في الشريط إشعار دائم صغير يقول «Connected»، وهو من القناة `gotify_foreground` التي رأيناها، لأن Android لا يسمح لتطبيق أن يحفظ اتصالاً مفتوحاً في الخلفية إلا إذا أعلن عن نفسه كخدمة في المقدمة Foreground Service يراها المستخدم. وهذا الإشعار هو ثمن أن تصل الرسالة من سيرفرك إلى هاتفك مباشرة دون أن تمر على Google، وتستطيع أن تخفيه من إعدادات القناة كما يشرح [ملف المستودع](https://github.com/gotify/android?ref=arabroot.io)، ولكن لا تحذفه ولا توقف القناة.

والأهم من ذلك تحسين البطارية Battery Optimization، فالمستودع نفسه يحذر من أن Android يوقف التطبيقات التي تعمل طويلاً، وأن Gotify مع تحسين البطارية سوف يقتل فلا تصلك إشعارات، والحل إيقاف تحسين البطارية لGotify من الإعدادات، وبعض الشركات المصنعة للهواتف لها إعدادات إضافية أشد. وهذا هو الاختبار الذي يجب أن تقوم به على هاتفك الحقيقي قبل أن تعتمد عليه: اترك الهاتف ساعة دون استخدام والشاشة مطفأة، ثم أرسل رسالة بأولوية 8 وانظر هل تصل فوراً.

والصورة التالية من التجربة: على اليسار قائمة الرسائل داخل التطبيق، وفيها الرسائل الأربع بما فيها «تقرير يومي» ذات الأولوية 0، وعلى اليمين شريط الإشعارات:

![لقطتان من هاتف Android: على اليسار تطبيق Gotify وفيه أربع رسائل هي web-01 القرص ممتلئ ونشر v1.8.2 ونسخة قاعدة البيانات وتقرير يومي، وعلى اليمين شريط الإشعارات وفيه إشعار القرص الممتلئ منفصلاً في الأعلى، ثم مجموعة Gotify من ثلاثة إشعارات فيها النشر والنسخة، ثم تحت عنوان Silent الإشعارات الدائمة ومنها إشعار Connected الخاص بGotify](https://arabroot.io/content/images/2026/11/gotify-03-android.webp)

رسالة الأولوية 0 في التطبيق فقط، ورسالة الأولوية 8 منفصلة في الأعلى

لاحظ أن رسالة القرص الممتلئ بأولوية 8 ظهرت وحدها في أعلى الشريط بصوت واهتزاز، وأن رسالة النشر ظهرت بخط عريض لأن Markdown مفعل لها، وأن «تقرير يومي» غير موجودة في الشريط أصلاً. وهذا بالضبط ما تريده من تقرير يومي: تجده عندما تفتح التطبيق، ولا يقاطعك.

📌

لا يوجد تطبيق رسمي لGotify على iPhone. فالموقع الرسمي يذكر تطبيق Android وحده بجانب السيرفر وأداة سطر الأوامر، والسبب الذي شرحناه في [الإشعارات بدون Firebase](https://arabroot.io/articles/%D8%A7%D9%84%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A8%D8%AF%D9%88%D9%86-firebase-%D9%85%D8%A7-%D9%8A%D8%B3%D8%AA%D8%A8%D8%AF%D9%84-%D9%88%D9%85%D8%A7-%D9%84%D8%A7-%D9%8A%D8%B3%D8%AA%D8%A8%D8%AF%D9%84/) أن iOS لا يسمح لتطبيق بحفظ اتصال مفتوح في الخلفية، فالطريق الوحيد إلى iPhone يمر عبر APNs من Apple. فإذا كان في فريقك من يستخدم iPhone فهذه نقطة تحسم الاختيار لصالح ntfy، أو يستخدم ذلك الشخص واجهة الويب فقط.

## واجهة الويب WebUI: عميل لكل جلسة

واجهة الويب هي المكان الذي تدير منه المستخدمين والتطبيقات والعملاء والإضافات، وتقرأ فيه الرسائل مرتبة بحسب التطبيق. وأول ما لاحظناه بعد الدخول من Chrome رسالة صغيرة في أسفل الصفحة: «A client named 'chrome 157.0.0' was created for your session»، أي أن الدخول من المتصفح ينشئ عميلاً جديداً بتوكن، تماماً مثل الهاتف، والصفحة تستخدم هذا التوكن لتفتح WebSocket وتقرأ الرسائل:

![واجهة Gotify 3.1.1 في المتصفح، في الأعلى روابط USERS وAPPS وCLIENTS وPLUGINS وADMIN، وفي القائمة الجانبية التطبيقات الثلاثة النسخ الاحتياطي والنشر والمراقبة، وفي الوسط All Messages وفيها رسالة api: 5xx فوق 5% بعنوان عربي يظهر ترتيبه مختلطاً، ورسالتان بعنوان حالة الخدمة من gotify watch، ورسالة web-01 القرص بمخرج df، وفي الأسفل رسالة A client named chrome 157.0.0 was created for your session](https://arabroot.io/content/images/2026/11/gotify-04-web-ui.webp)

الدخول من المتصفح ينشئ عميلاً بتوكن خاص بالجلسة

وفي الصورة ثلاث ملاحظات عملية:

- **عملاء الجلسات يتراكمون:** كل دخول من متصفح جديد أو بعد مسح ملفات تعريف الارتباط Cookies يضيف عميلاً في صفحة Clients، فراجع القائمة كل فترة واحذف ما لا تعرفه، وانظر إلى حقل آخر استخدام قبل الحذف.
- **العناوين المختلطة:** العنوان «api: 5xx فوق 5%» ظهر بترتيب مختلط، لأن اتجاه السطر يحدده أول حرف قوي، وهو هنا حرف لاتيني، فتنعكس الكلمات العربية والأرقام حولها. والحل أن تبدأ العنوان العربي بكلمة عربية، مثل «الأخطاء 5xx في api فوق 5%»، أو أن تكتبه كله بالإنجليزية إذا كان من أداة مراقبة، وهذا ينطبق على شريط الإشعارات في الهاتف أيضاً.
- **إشعارات المتصفح:** زر «ENABLE NOTIFICATIONS» يجعل الصفحة تظهر إشعاراً من المتصفح لكل رسالة، ويصدر صوتاً للأولوية 4 وما فوقها، ولكن ذلك يعمل والصفحة مفتوحة فقط، لأنها تعتمد على اتصال WebSocket من الصفحة نفسها وليس على Web Push.

## أداة سطر الأوامر gotify-cli

الأداة [gotify-cli](https://github.com/gotify/cli?ref=arabroot.io) ملف تنفيذي واحد، وفائدتها الحقيقية في أمرين: أنها تحفظ الرابط والتوكن في ملف إعداد فلا تكتبهما في كل سكربت، وأنها تقرأ الرسالة من الإدخال القياسي Standard Input فتستطيع أن تمرر إليها مخرج أي أمر. ونزلنا الإصدار 2.4.0 داخل Container `web-01` نفسه، وكتبنا ملف الإعداد بتوكن تطبيق النسخ الاحتياطي:

```bash
wget -qO /usr/local/bin/gotify https://github.com/gotify/cli/releases/download/v2.4.0/gotify-cli-linux-amd64
chmod +x /usr/local/bin/gotify
mkdir -p /etc/gotify
cat > /etc/gotify/cli.json <<'EOF'
{"token":"gtfya.wG3TYOUIHxDoySxRDFpXM2HOoPQW7rsJlTIbh75KJOQ","url":"http://sc6-gotify","defaultPriority":2}
EOF
chmod 600 /etc/gotify/cli.json
gotify config
gotify push -t "نسخة الملفات" "اكتملت نسخة /etc إلى المخزن"; echo exit=$?
df -h / | tail -n 1 | gotify push -t "web-01: القرص" -p 4; echo exit=$?
gotify push --url http://sc6-gotify --token wrongtoken "x"; echo exit=$?
```

```text
Used Config: /etc/gotify/cli.json
URL: http://sc6-gotify
Default Priority: 2
Token: gtfya.wG3TYOUIHxDoySxRDFpXM2HOoPQW7rsJlTIbh75KJOQ
message created
exit=0
message created
exit=0
[POST /message][401] createMessageUnauthorized  &{Error:Unauthorized ErrorCode:401 ErrorDescription:you need to provide a valid access token or user credentials to access this api}
exit=1
```

في المخرج أعلاه لاحظ التالي:

- `gotify config` يطبع التوكن كاملاً بنص واضح، فلا تشغله داخل خط CI ولا تلصق مخرجه في تذكرة دعم Support Ticket، ولهذا السبب أيضاً جعلنا الملف `600` حتى لا يقرأه إلا صاحبه.
- الرسالة الأولى أخذت الأولوية الافتراضية من الملف، أي 2، والثانية أخذت 4 من الخيار `-p`.
- الرسالة الثانية نصها هو سطر `df` نفسه، لأن الأداة قرأته من الإدخال، وهذا يجعل أي أمر مصدراً لرسالة دون سكربت.
- التوكن الخاطئ يعيد 401 ورمز خروج 1، وهذا مهم في السكربتات، لأن السكربت يعرف أن التنبيه نفسه لم يرسل فيستطيع أن يسجل ذلك أو يجرب طريقاً آخر.

والأداة تبحث عن ملف الإعداد في `/etc/gotify/cli.json` ثم في مجلد الإعداد للمستخدم ثم في مجلد العمل، ويمكن تجاوز الملف بالخيارين `--token` و`--url` أو بالمتغير `GOTIFY_TOKEN`.

### مراقبة مخرج أمر: gotify watch

الأمر `watch` يشغل أمراً كل عدد من الثواني، ويرسل رسالة فقط عندما يتغير المخرج عن المرة السابقة، وهذا أبسط مراقب حالة State Monitor يمكن أن تكتبه، لأنه يتذكر الحالة فلا يرسل التنبيه نفسه كل دقيقة كما يفعل سكربت Cron البسيط. وجربناه على ملف حالة يتغير بأيدينا، والحالة في البداية `api: up`، ثم غيرناها إلى انقطاع ثم أعدناها:

```bash
echo "api: up" > /tmp/status
gotify watch -n 3 -t "حالة الخدمة" -p 6 "cat /tmp/status" &
sleep 5; echo "api: down (connection refused)" > /tmp/status
sleep 8; echo "api: up" > /tmp/status
```

```text
command output for "cat /tmp/status" changed:

== BEGIN NEW OUTPUT ==
api: down (connection refused)
== END NEW OUTPUT ==

command output for "cat /tmp/status" changed:

== BEGIN NEW OUTPUT ==
api: up
== END NEW OUTPUT ==
```

رسالتان فقط، واحدة عند الانقطاع وأخرى عند العودة، والتشغيل الأول لا يرسل شيئاً لأنه يحفظ المخرج كأساس للمقارنة. وعندما قرأنا آخر الرسائل من السيرفر بالأمر التالي ظهر كل ما أرسلناه من الأداة، بالترتيب من الأحدث، مع رقم التطبيق والأولوية:

```bash
curl -s -u "$AUTH" "$API/message?limit=4" | jq -r '.messages[] | "\(.id) \(.appid) \(.priority) \(.title|@json) \(.message|@json)"'
```

```text
8 1 6 "حالة الخدمة" "command output for \"cat /tmp/status\" changed:\n\n== BEGIN NEW OUTPUT ==\napi: up\n== END NEW OUTPUT ==\n"
7 1 6 "حالة الخدمة" "command output for \"cat /tmp/status\" changed:\n\n== BEGIN NEW OUTPUT ==\napi: down (connection refused)\n== END NEW OUTPUT ==\n"
6 1 4 "web-01: القرص" "overlay                1006.9G    208.6G    747.0G  22% /\n"
5 1 2 "نسخة الملفات" "اكتملت نسخة /etc إلى المخزن"
```

ولاحظ أن الأمر كله يعمل داخل عملية Process واحدة تبقى حية، فإذا أعيد تشغيل السيرفر الذي عليه توقف المراقب بصمت، لذلك ضعه في وحدة systemd تعيد تشغيله، واجعل الأمر الذي تراقبه سريعاً، لأن الأداة تعتبر الأمر الذي يتجاوز فترة المراقبة متعطلاً فتوقفه وتضيف علامة الخطأ إلى مخرجه. والخيار `-o short` يرسل المخرج الجديد وحده دون السطور التي حوله، وهو أنسب للهاتف.

## الاستماع إلى WebSocket من سكربت

كل عميل في Gotify، سواء كان التطبيق أو الواجهة، يفتح اتصالاً واحداً بالمسار `/stream` ومعه توكن العميل، ويستقبل كل رسالة جديدة كإطار بصيغة JSON. وهذا يعني أنك تستطيع كتابة عميلك الخاص في سطور قليلة، مثل برنامج يشغل ضوءاً في المكتب عند كل رسالة بأولوية 8، أو جسر يمرر الرسائل إلى نظام آخر. والسكربت التالي بلغة JavaScript يعمل على Node.js 22 الذي فيه WebSocket مدمج دون مكتبات:

```javascript
// stream.mjs: a client listens on the WebSocket stream, like the Android app and the web UI
const ws = new WebSocket(`ws://127.0.0.1:18610/stream?token=${process.env.CLIENT}`);
ws.onopen = () => console.log('stream open');
ws.onmessage = (e) => console.log('frame', e.data);
setTimeout(() => process.exit(0), Number(process.env.SECS || 8) * 1000);
```

شغلناه بتوكن العميل `ops laptop`، وأرسلنا أثناء ذلك من `web-01` تنبيهاً بأولوية 10 بتوكن تطبيق المراقبة:

```bash
CLIENT=gtfyc.fcliNewY_0XBL01XoR9Jz9arimqRwVpxq7RqASMoPwE SECS=8 node stream.mjs
```

```text
stream open
frame {"id":9,"appid":3,"message":"HighErrorRate على web-01:8080 منذ 10 دقائق","title":"api: 5xx فوق 5%","priority":10,"date":"2026-11-20T01:35:24.564335969Z"}
```

الإطار هو الرسالة نفسها التي يحفظها السيرفر، بالحقول نفسها التي رأيناها في رد الإرسال، فلا توجد صيغة ثانية تتعلمها. وفي المقارنة التي سوف ننشرها بين الأدوات الثلاث قسنا الزمن من طلب الإرسال إلى وصول الإطار في هذا الاتصال بخمس محاولات، وكان الوسيط Median هو 10 ms، أي أن التأخير الذي تراه على الهاتف هو تأخير الشبكة والهاتف وليس السيرفر.

⚠️

التوكن في رابط `?token=` يظهر في سجلات ال Reverse Proxy وفي سجل المتصفح، لذلك عندما تكتب عميلاً خاصاً يعمل خارج المتصفح ضع التوكن في الترويسة `X-Gotify-Key` أو `Authorization: Bearer` بدل الرابط، والمسار `/stream` يقبل الطرق نفسها، وإذا اضطررت إلى الرابط فامنع تسجيل معاملات الاستعلام في ال Proxy.

## ماذا يستطيع كل توكن أن يفعل؟ صلاحيات التوكنات Token Scopes

جربنا الحدود بين التوكنات بطلبات مقصودة، لأن فهمها هو ما يجعلك تعطي كل أداة التوكن الصحيح. فعندما طلبنا قائمة الرسائل `GET /message` بتوكن تطبيق، رد السيرفر ب 401، أي أن توكن الإرسال لا يقرأ شيئاً، حتى رسائل تطبيقه نفسه. وعندما أرسلنا رسالة بتوكن عميل دون رقم تطبيق، رد السيرفر ب 400 ومعه السبب «appid is required when not authenticating with an application token»، أي أن الإصدار 3 يسمح للعميل أن يرسل، ولكن باسم تطبيق يملكه صاحبه، وعليه أن يذكر رقمه في الحقل `appid`. وهذه الميزة جديدة في الإصدار 3 كما في [دليل الانتقال](https://gotify.net/docs/migrate-to-3?ref=arabroot.io)، وسببها أن التوكنات لم تعد تظهر بعد إنشائها، فالبرنامج الذي معه توكن عميل لم يعد يستطيع أن يقرأ توكن التطبيق ثم يرسل به. والصورة التالية تجمع ما يستطيعه كل نوع:

![جدول صلاحيات: الأعمدة إرسال رسالة وقراءة الرسائل والبث المباشر وحذف عميل أو تطبيق، والصفوف توكن التطبيق gtfya يرسل فقط ويرفض بالقراءة 401، وتوكن العميل gtfyc يرسل مع appid فقط وبدونه 400 ويقرأ ويفتح البث ويحذف بعد رفع الجلسة وإلا 403، واسم المستخدم وكلمة المرور يرسل مع appid ويستطيع كل شيء لأنه مرفوع دائماً، وفي الأسفل أن توكن الإضافة يبدأ ب P لمسارات الإضافة فقط](https://arabroot.io/content/images/2026/11/gotify-05-token-scopes.webp)

أعط كل أداة أضيق توكن يكفيها

وفي الصف الثاني عمود يحتاج شرحاً، وهو رفع الجلسة Session Elevation. فالإصدار 3 يطلب من العميل أن يعيد المصادقة قبل الأفعال الحساسة التي يصعب الرجوع عنها، مثل حذف عميل أو تطبيق أو تغيير كلمة المرور أو إدارة المستخدمين، فإذا طلبها توكن عميل غير مرفوع ردت ب 403، بحسب [صفحة رفع الجلسة](https://gotify.net/docs/session-elevation?ref=arabroot.io). وفي الواجهة يظهر لك طلب كلمة المرور وتكمل، أما السكربت الذي يحذف عملاء قديمة بتوكن عميل فسوف يتوقف بعد الترقية، والحل أن يرفع جلسته أولاً أو يستخدم المصادقة الأساسية، لأن طلبات المصادقة الأساسية مرفوعة دائماً، مع أن هذا يعني أن كلمة المرور نفسها في السكربت.

والقاعدة العملية التي تخرج بها من هذا الجدول:

- كل سكربت أو أداة ترسل فقط تأخذ توكن تطبيق خاصاً بها، ولا تتشارك أداتان توكناً واحداً، حتى تستطيع أن تدور توكناً واحداً دون أن تتوقف الأخرى.
- كل جهاز يقرأ يأخذ عميلاً باسمه، ولا تنسخ توكن الهاتف إلى سكربت.
- كلمة مرور المدير لا توضع في أي سكربت يعمل باستمرار، وإنما تستخدم للإعداد ثم تحفظ في مدير الأسرار، وقد قارنا أدوات حفظ الأسرار في [إدارة الأسرار OpenBao أم Infisical](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-secrets-manager-openbao-%D8%A7%D9%85-infisical/).

## الإضافات Plugins: Gotify يتسع بكود Go

هنا يختلف Gotify عن أغلب سيرفرات الإشعارات، فبدل قوالب Templates أو قواعد في ملف إعداد، تستطيع أن تكتب إضافة بلغة Go تعمل داخل السيرفر نفسه، وتستقبل طلبات HTTP على مسارات خاصة بها، وترسل رسائل كتطبيق، وتحفظ إعداداً يحرره المستخدم من الواجهة بصيغة YAML، وتعرض نصاً متغيراً في صفحتها. و[مقدمة الإضافات](https://gotify.net/docs/plugin?ref=arabroot.io) تذكر استخدامات مثل استقبال Webhooks من GitHub، ومتابعة خلاصات RSS، وتنبيهات الإنذار. وتحذر في أولها من أن الإضافات تعمل على Linux وmacOS فقط بسبب قيد في Go.

### كيف تعمل إضافات Go؟ ولماذا هي حساسة للنسخ؟

الإضافة ملف مكتبة مشتركة Shared Object بامتداد `.so` تبنيه بالأمر `go build -buildmode=plugin`، والسيرفر عند بدء تشغيله يفتح كل ملف في مجلد الإضافات بالحزمة Package القياسية [plugin](https://pkg.go.dev/plugin?ref=arabroot.io)، ويبحث فيه عن دالتين: `GetGotifyPluginInfo` التي تعيد اسم الإضافة ومسار الوحدة Module Path، و`NewGotifyPluginInstance` التي ينشئ بها نسخة من الإضافة لكل مستخدم. وهذا يعني أن الإضافة لا تعمل كبرنامج منفصل، وإنما يحمل كودها داخل عملية السيرفر نفسها، وتشارك السيرفر الذاكرة والمكتبات.

ومن هنا تأتي المشكلة الأشهر مع الإضافات، فتوثيق حزمة plugin في Go يحذر من أن الأعطال وقت التشغيل متوقعة إلا إذا بنيت كل أجزاء البرنامج بنفس نسخة أدوات Go بالضبط ونفس الخيارات، وإلا إذا بنيت كل المكتبات المشتركة بين البرنامج والإضافة من نفس الكود بالضبط. فإذا كان السيرفر مبنياً بمكتبة gin بالإصدار 1.12.0 وإضافتك بالإصدار 1.11، رفض Go تحميلها برسالة تبدأ ب `cannot load plugin` وفيها `was built with another version of package`. والإضافة أيضاً لا يمكن إغلاقها بعد تحميلها، فكل تحديث لها يحتاج إعادة تشغيل السيرفر. و[صفحة البناء والنشر](https://gotify.net/docs/plugin-deploy?ref=arabroot.io) تحل المشكلة بثلاث خطوات تبينها الصورة التالية:

![ثلاثة أعمدة: من السيرفر يأتي ملف GO_VERSION الذي يقول إن gotify/server v3.1.1 مبني ب Go 1.26.0، وملف go.mod للسيرفر بنسخ plugin-api v1.0.0 وgin v1.12.0، ومعها كود الإضافة، ثم في الوسط البناء داخل Docker Image باسم gotify/build:1.26.0-linux-amd64 وأداة gomod-cap توحد النسخ ثم go build -buildmode=plugin ينتج heartbeat-linux-amd64.so بحجم 41,327,976 بايت، وعلى اليسار السيرفر يقرأ data/plugins عند التشغيل فقط فإما يحمل الإضافة أو يظهر خطأ نسخة مختلفة لمكتبة مشتركة](https://arabroot.io/content/images/2026/11/gotify-06-plugin-loading.webp)

نسخة Go ونسخ المكتبات تأتي من السيرفر، لا من إضافتك

1. **نسخة Go:** في مستودع السيرفر ملف اسمه [GO\_VERSION](https://github.com/gotify/server/blob/v3.1.1/GO%5FVERSION?ref=arabroot.io)، وقيمته للإصدار 3.1.1 هي 1.26.0.
2. **بيئة البناء:** المشروع ينشر Docker Image للبناء بالصيغة `gotify/build:{GO_VERSION}-{GOOS}-{GOARCH}`، وهي البيئة نفسها التي يبنى بها السيرفر الرسمي، فاستخدمنا `gotify/build:1.26.0-linux-amd64`. والتوثيق يحذر من أن الإضافة المبنية خارج هذه البيئة لن تعمل غالباً مع الملفات الرسمية.
3. **نسخ المكتبات:** أداة `gomod-cap` من مستودع [plugin-api](https://github.com/gotify/plugin-api?ref=arabroot.io) تقرأ [go.mod للسيرفر](https://github.com/gotify/server/blob/v3.1.1/go.mod?ref=arabroot.io) وتنزل كل مكتبة مشتركة في ملف إضافتك إلى نسخة السيرفر.

وسكربت البناء الذي استخدمناه يجمع الخطوات كلها، ويعمل داخل Image البناء:

```bash
#!/bin/sh
# Builds heartbeat.so against the exact module versions of gotify/server v3.1.1 (run inside gotify/build:1.26.0-linux-amd64)
set -e
cd /proj
go mod init example.com/arabroot/gotify-heartbeat 2>/dev/null || true
wget -qO /tmp/gotify-server.mod https://raw.githubusercontent.com/gotify/server/v3.1.1/go.mod
go install github.com/gotify/plugin-api/cmd/gomod-cap@latest
go get github.com/gotify/plugin-api@v1.0.0 github.com/gin-gonic/gin@v1.12.0
/go/bin/gomod-cap -from /tmp/gotify-server.mod -to go.mod
go mod tidy
go build -a -installsuffix cgo -buildmode=plugin -o build/heartbeat-linux-amd64.so .
ls -la build
```

```bash
docker run --rm -v "$PWD:/proj" gotify/build:1.26.0-linux-amd64 sh /proj/build.sh
docker cp build/heartbeat-linux-amd64.so sc6-gotify:/app/data/plugins/heartbeat.so
docker restart sc6-gotify
```

والناتج ملف حجمه 41,327,976 بايت، أي نحو 41 MB لإضافة من 150 سطراً، لأنها تحمل معها نسخة من كل ما تستخدمه من مكتبات. وبعد إعادة التشغيل ظهر في سجل السيرفر السطر `Loading plugin path=data/plugins/heartbeat.so`، وارتفعت ذاكرة السيرفر إلى 19.93 MiB بعد أن كانت 11.84 MiB. وانتبه إلى أن Image البناء نفسها حجمها 1.22 GB، فاحذفها بعد البناء إذا كانت مساحة القرص محدودة. وإذا كنت جديداً على Go فقد شرحنا الأدوات والوحدات Modules في [Go لمن يعرف البرمجة](https://arabroot.io/articles/go-%D9%84%D9%85%D9%86-%D9%8A%D8%B9%D8%B1%D9%81-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A7%D9%84%D8%A7%D8%AF%D9%88%D8%A7%D8%AA-%D9%88%D8%A7%D9%88%D9%84-%D9%85%D8%B4%D8%B1%D9%88%D8%B9/).

### إضافة النبضات: مفتاح الرجل الميت Dead Man's Switch

اخترنا للإضافة مشكلة حقيقية لا يحلها Gotify وحده: المهمة المجدولة التي تتوقف بصمت. فالسكربت الذي يرسل عند الفشل لا يرسل شيئاً إذا لم يعمل أصلاً، لأن Cron توقف أو حذف سطره أحد أو امتلأ القرص قبل أن يبدأ، وغياب رسالة الفشل يبدو تماماً مثل النجاح. والحل المعروف هو مفتاح الرجل الميت الذي شرحناه في [فحص التوفر Uptime Checks](https://arabroot.io/articles/%D9%81%D8%AD%D8%B5-%D8%A7%D9%84%D8%AA%D9%88%D9%81%D8%B1-uptime-checks-%D9%85%D9%86-%D9%8A%D8%B1%D8%A7%D9%82%D8%A8-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D9%82%D8%A8%D8%A9/#dead-man): المهمة ترسل نبضة «أنا حي» بعد كل نجاح، وجهة أخرى تتوقع النبضة، فإذا تأخرت عن حدها أرسلت تنبيهاً. والإضافة تفعل ذلك داخل Gotify: كل مهمة تطلب رابطاً بعد نجاحها، والإضافة تفحص كل بضع ثوان من تأخر، وترسل رسالة واحدة بأولوية 8 عند السكوت، ورسالة أخرى عند العودة. وهذا الكود كاملاً:

```go
// heartbeat: a dead man's switch for Gotify. Jobs call GET <plugin url>/beat?job=backup after each success;
// when a job stays silent longer than its limit, the plugin sends one high priority message, and one more when it comes back.
package main

import (
	"fmt"
	"net/http"
	"net/url"
	"sort"
	"strings"
	"sync"
	"time"

	"github.com/gin-gonic/gin"
	"github.com/gotify/plugin-api"
)

func GetGotifyPluginInfo() plugin.Info {
	return plugin.Info{
		ModulePath:  "example.com/arabroot/gotify-heartbeat",
		Version:     "0.1.0",
		Author:      "ArabRoot lab",
		Description: "Dead man's switch: alerts when a job stops sending heartbeats",
		License:     "MIT",
		Name:        "heartbeat",
	}
}

// Config is edited in the web UI (Plugins > heartbeat > Configurer) as YAML.
type Config struct {
	CheckEverySeconds int            `yaml:"check_every_seconds"`
	Jobs              map[string]int `yaml:"jobs"` // job name -> allowed silence in seconds
}

type Heartbeat struct {
	mu       sync.Mutex
	cfg      *Config
	msg      plugin.MessageHandler
	last     map[string]time.Time
	down     map[string]bool
	stop     chan struct{}
	basePath string
}

func (h *Heartbeat) DefaultConfig() interface{} {
	return &Config{CheckEverySeconds: 10, Jobs: map[string]int{"backup": 90000}}
}

func (h *Heartbeat) ValidateAndSetConfig(c interface{}) error {
	cfg := c.(*Config)
	if cfg.CheckEverySeconds < 5 {
		return fmt.Errorf("check_every_seconds must be 5 or more")
	}
	h.mu.Lock()
	h.cfg = cfg
	h.mu.Unlock()
	return nil
}

func (h *Heartbeat) SetMessageHandler(m plugin.MessageHandler) { h.msg = m }

func (h *Heartbeat) RegisterWebhook(basePath string, g *gin.RouterGroup) {
	h.basePath = basePath
	g.GET("/beat", func(c *gin.Context) {
		job := c.Query("job")
		h.mu.Lock()
		_, known := h.cfg.Jobs[job]
		if known {
			h.last[job] = time.Now()
			if h.down[job] {
				h.down[job] = false
				go h.msg.SendMessage(plugin.Message{Title: "عاد " + job, Message: "وصلت نبضة جديدة من " + job, Priority: 4})
			}
		}
		h.mu.Unlock()
		if !known {
			c.String(http.StatusNotFound, "unknown job\n")
			return
		}
		c.String(http.StatusOK, "ok\n")
	})
}

func (h *Heartbeat) check() {
	h.mu.Lock()
	defer h.mu.Unlock()
	for job, limit := range h.cfg.Jobs {
		seen, ok := h.last[job]
		if !ok || h.down[job] || time.Since(seen) < time.Duration(limit)*time.Second {
			continue
		}
		h.down[job] = true
		silent := time.Since(seen).Round(time.Second)
		go h.msg.SendMessage(plugin.Message{
			Title:    "توقفت نبضات " + job,
			Message:  fmt.Sprintf("آخر نبضة قبل %s والحد %d ثانية", silent, limit),
			Priority: 8,
		})
	}
}

func (h *Heartbeat) Enable() error {
	h.stop = make(chan struct{})
	go func(stop chan struct{}) {
		for {
			h.mu.Lock()
			every := time.Duration(h.cfg.CheckEverySeconds) * time.Second
			h.mu.Unlock()
			select {
			case <-stop:
				return
			case <-time.After(every):
				h.check()
			}
		}
	}(h.stop)
	return nil
}

func (h *Heartbeat) Disable() error {
	close(h.stop)
	return nil
}

// GetDisplay is the text shown on the plugin page in the web UI.
func (h *Heartbeat) GetDisplay(location *url.URL) string {
	h.mu.Lock()
	defer h.mu.Unlock()
	beat := &url.URL{Path: h.basePath + "beat"}
	if location != nil {
		beat = location.ResolveReference(beat)
	}
	jobs := make([]string, 0, len(h.cfg.Jobs))
	for j := range h.cfg.Jobs {
		jobs = append(jobs, j)
	}
	sort.Strings(jobs)
	var b strings.Builder
	fmt.Fprintf(&b, "Beat URL: %s?job=NAME\n\n", beat)
	for _, j := range jobs {
		state := "waiting for the first beat"
		if t, ok := h.last[j]; ok {
			state = "last beat " + time.Since(t).Round(time.Second).String() + " ago"
			if h.down[j] {
				state += " (DOWN)"
			}
		}
		fmt.Fprintf(&b, "- %s: %s, limit %ds\n", j, state, h.cfg.Jobs[j])
	}
	return b.String()
}

func NewGotifyPluginInstance(ctx plugin.UserContext) plugin.Plugin {
	h := &Heartbeat{last: map[string]time.Time{}, down: map[string]bool{}}
	h.cfg = h.DefaultConfig().(*Config)
	return h
}

func main() { panic("this should be built as go plugin") }
```

في الكود أعلاه لاحظ التالي، وكل نقطة منها واجهة Interface من [صفحة كتابة الإضافات](https://gotify.net/docs/plugin-write?ref=arabroot.io):

- **الإعداد Configurer:** الدالتان `DefaultConfig` و`ValidateAndSetConfig` تجعلان الإعداد YAML يحرر من الواجهة. والسيرفر يتولى تحويل YAML إلى الكلاس Struct، والإضافة تتحقق من القيم فقط، وإذا رفضت الإعداد ترد الواجهة البرمجية بخطأ ولا يحفظ.
- **إرسال الرسائل Messenger:** السيرفر يعطي الإضافة `MessageHandler` عند التهيئة، فترسل به رسائل كأنها تطبيق، ولذلك لا تحتاج الإضافة إلى أي توكن.
- **المسارات الخاصة Webhooker:** `RegisterWebhook` يسجل مسار `/beat` بمكتبة gin تحت رابط أساسي ثابت لكل إضافة، والتوثيق يذكر أن هذه المسارات لا يصل إليها أحد والإضافة معطلة.
- **العرض Displayer:** `GetDisplay` يكتب نصاً يظهر في صفحة الإضافة، ويبني فيه رابط النبضة الكامل من عنوان الطلب، فالمستخدم ينسخ الرابط من الواجهة مباشرة.
- **التفعيل Enable والتعطيل Disable:** التفعيل يشغل Goroutine تفحص كل `check_every_seconds`، والتعطيل يغلق القناة Channel فتنتهي، وقد شرحنا هذا النمط في [التزامن في Go](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B2%D8%A7%D9%85%D9%86-%D9%81%D9%8A-go-goroutines-%D9%88%D8%A7%D9%84%D9%82%D9%86%D9%88%D8%A7%D8%AA-channels/).
- **رسالة واحدة لكل سكوت:** ال Map المسماة `down` تمنع تكرار التنبيه في كل فحص، فلا تصلك رسالة كل خمس ثوان حتى تعود المهمة، وهذا هو الفرق بين تنبيه مفيد وتنبيه يتعلم الفريق تجاهله.
- **القفل Mutex:** الطلبات تصل من Goroutines مختلفة، والفحص يعمل في Goroutine أخرى، وكلها تقرأ ال Maps نفسها، فكل وصول إليها داخل القفل.

### الإعداد والتفعيل Enable من الواجهة البرمجية API

بعد التحميل تظهر الإضافة في صفحة Plugins معطلة، وطلب `GET /plugin` يبين قدراتها الأربع `configurer` و`displayer` و`messenger` و`webhooker` مع الحقل `enabled` يساوي `false`، ومعها توكن خاص بها يبدأ ب `P` يدخل في رابط مساراتها. وكل ذلك يمكن من الواجهة، ولكننا نفعله بالطلبات حتى نرى ما يحدث، فنقرأ الإعداد الافتراضي، ثم نرسل إعدادنا، ثم نجرب إعداداً خاطئاً، ثم نفعل الإضافة:

```yaml
# hb.yml
check_every_seconds: 5
jobs:
  backup-db: 20
  certs-renew: 600
```

```bash
echo "== default config"; curl -s -u "$AUTH" $API/plugin/1/config
echo "== set config"; curl -s -u "$AUTH" -H 'Content-Type: application/x-yaml' --data-binary @hb.yml $API/plugin/1/config; echo
echo "== bad config"; printf 'check_every_seconds: 1\n' |
  curl -s -u "$AUTH" -H 'Content-Type: application/x-yaml' --data-binary @- $API/plugin/1/config; echo
curl -s -u "$AUTH" -X POST $API/plugin/1/enable
```

```text
== default config
check_every_seconds: 10
jobs:
    backup: 90000
== set config

== bad config
{"error":"Bad Request","errorCode":400,"errorDescription":"check_every_seconds must be 5 or more"}
```

الإعداد الافتراضي هو ما تعيده `DefaultConfig` محولاً إلى YAML، وإعدادنا قبل دون أي رد، والإعداد الخاطئ رفض بالرسالة التي كتبناها في `ValidateAndSetConfig` بالضبط، فلا يحفظ ولا يصل إلى الإضافة. والصورة التالية صفحة الإضافة في الواجهة بعد الإعداد، وفيها معلومات الإضافة ورابط مساراتها والإعداد الذي حفظناه:

![صفحة إضافة heartbeat في واجهة Gotify، في الأعلى Plugin Info وفيها الاسم heartbeat والمؤلف ArabRoot lab ومسار الوحدة example.com/arabroot/gotify-heartbeat والترخيص MIT والقدرات configurer وdisplayer وmessenger وwebhooker ورابط Custom Route Prefix، ثم Configurer وفيه محرر YAML بالسطور check_every_seconds: 5 وjobs وbackup-db: 20 وcerts-renew: 600، وفي القائمة الجانبية تطبيق جديد اسمه heartbeat](https://arabroot.io/content/images/2026/11/gotify-07-plugin-page.webp)

الإعداد يحرر من الواجهة، والإضافة أنشأت تطبيقاً باسمها

ولاحظ في القائمة الجانبية تطبيقاً رابعاً اسمه heartbeat لم ننشئه نحن، فالإضافة التي ترسل رسائل يأخذ لها السيرفر تطبيقاً داخلياً، وهذا ما أكدته قائمة التطبيقات:

```bash
curl -s -u "$AUTH" $API/application | jq -r '.[] | "\(.id) \(.name) internal=\(.internal)"'
```

```text
1 النسخ الاحتياطي internal=false
2 النشر internal=false
3 المراقبة internal=false
4 heartbeat internal=true
```

وهذا يعني أن رسائل الإضافة تظهر في الهاتف تحت تطبيق خاص بها، وتستطيع أن تغير أولويته الافتراضية أو صورته مثل أي تطبيق آخر.

### النبضات Heartbeats، والسكوت، والعودة

الآن نرسل نبضتين لوظيفتين Jobs معروفتين، وثالثة لوظيفة غير موجودة، ثم ننتظر ولا نرسل أي نبضة لـ backup-db، ثم نقرأ صفحة العرض، ثم نرسل نبضة جديدة:

```bash
BEAT=http://127.0.0.1:18610/plugin/1/custom/PYeR31R0qtefmyb1nNeEOLm/beat
curl -s "$BEAT?job=backup-db"; curl -s "$BEAT?job=certs-renew"; curl -s "$BEAT?job=nothing"
date +%T; sleep 44; date +%T
curl -s -u "$AUTH" "$API/message?limit=2" | jq -r '.messages[] | "\(.date) \(.appid) \(.priority) \(.title) | \(.message)"'
curl -s -u "$AUTH" $API/application | jq -r '.[] | "\(.id) \(.name) internal=\(.internal)"'
curl -s -u "$AUTH" $API/plugin/1/display
curl -s "$BEAT?job=backup-db"; sleep 1
curl -s -u "$AUTH" "$API/message?limit=1" | jq -r '.messages[] | "\(.date) \(.appid) \(.title) | \(.message)"'
```

```text
ok
ok
unknown job
04:43:56
04:44:40
2026-11-20T01:44:21.46223412Z 4 8 توقفت نبضات backup-db | آخر نبضة قبل 25s والحد 20 ثانية
2026-11-20T01:35:24.564335969Z 3 10 api: 5xx فوق 5% | HighErrorRate على web-01:8080 منذ 10 دقائق
1 النسخ الاحتياطي internal=false
2 النشر internal=false
3 المراقبة internal=false
4 heartbeat internal=true
"Beat URL: http://127.0.0.1:18610/plugin/1/custom/PYeR31R0qtefmyb1nNeEOLm/beat?job=NAME\n\n- backup: waiting for the first beat, limit 90000s\n- backup-db: last beat 45s ago (DOWN), limit 20s\n- certs-renew: last beat 45s ago, limit 600s\n"
ok
2026-11-20T01:44:41.370134661Z 4 عاد backup-db | وصلت نبضة جديدة من backup-db
```

في المخرج أعلاه لاحظ التالي:

- النبضتان الأوليان ردتا `ok`، والنبضة لوظيفة غير معروفة ردت ب 404 و`unknown job`، وهذا يحميك من خطأ إملائي في اسم الوظيفة يجعل نبضاتها تضيع دون أن تعرف.
- آخر نبضة من backup-db كانت عند 04:43:56 بالتوقيت المحلي، والتنبيه وصل عند 01:44:21 بتوقيت UTC، أي 04:44:21 محلياً، بعد 25 ثانية من آخر نبضة والحد 20 ثانية. والسبب أن الفحص يعمل كل 5 ثوان، فأول فحص بعد انتهاء الحد قد يأتي متأخراً حتى فترة فحص كاملة، أي أن أقصى تأخير للتنبيه هو الحد مضافاً إليه فترة الفحص.
- رسالة التنبيه من التطبيق رقم 4، أي التطبيق الداخلي للإضافة، وبأولوية 8 فظهرت على الهاتف بصوت واهتزاز.
- صفحة العرض تقول إن backup-db في حالة DOWN منذ 45 ثانية، وإن certs-renew نبض قبل 45 ثانية أيضاً ولكن حده 600 فهو سليم، ومعها وظيفة ثالثة اسمها backup لم نضعها في إعدادنا، وسوف نعود إليها حالاً.
- النبضة الجديدة بعد 04:44:40 بلحظات أعادت الحالة، فوصلت فوراً رسالة «عاد backup-db» بأولوية 4، أي بصوت دون اهتزاز، لأن خبر العودة يهمك ولكنه لا يستحق أن يوقظك.

![خط زمني أفقي يبدأ عند 0 بآخر نبضة من backup-db عند 04:43:56 وردها ok، ثم منطقة خضراء مسموح فيها بالسكوت 20 ثانية، ثم منطقة حمراء النبضة متأخرة، وعند +25s التنبيه بأولوية 8 عند 04:44:21 بنص توقفت نبضات backup-db، وعند نحو +44s نبضة جديدة عند 04:44:40 ورسالة العودة عند 04:44:41 بأولوية 4، وتحت الخط علامات كل 5 ثوان للفحص، وفي الأسفل شرح لماذا 25 ثانية وليس 20، وأن certs-renew بقي سليماً وأن الاسم غير المعروف يرد 404](https://arabroot.io/content/images/2026/11/gotify-08-heartbeat-timeline.webp)

أقصى تأخير للتنبيه هو الحد مضافاً إليه فترة الفحص

وفي سكربت حقيقي تضيف النبضة في آخر السكربت بعد أن ينجح كل شيء، مثل `pg_dump ... && curl -fsS -m 10 "$BEAT?job=backup-db" > /dev/null`، والخيار `-m 10` يمنع السكربت من الانتظار طويلاً إذا كان Gotify نفسه متوقفاً، والحد في الإعداد يكون أطول من فترة الجدولة بهامش، فالنسخة الليلية التي تعمل كل 24 ساعة يكون حدها 25 أو 26 ساعة، وهذا هو سبب الرقم 90000 في الإعداد الافتراضي. وهذا ما ظهر على الهاتف بعد التنبيه:

![شريط إشعارات Android وفيه مجموعة Gotify من 11 إشعاراً، أولها آخر نبضة قبل 25s والحد 20 ث توقفت نبضات backup-db، ثم تنبيه api 5xx فوق 5%، ثم القرص ممتلئ، ثم عاد backup-db وصلت نبضة جديدة من backup-db](https://arabroot.io/content/images/2026/11/gotify-09-plugin-alert.webp)

تنبيه السكوت ثم خبر العودة على الهاتف

### الإعداد الافتراضي Default Config يندمج مع إعدادك

نعود إلى الوظيفة `backup` التي ظهرت في صفحة العرض بحد 90000 ثانية، مع أن الإعداد الذي حفظناه فيه وظيفتان فقط، وصفحة الإعداد في الواجهة تعرض الوظيفتين فقط كما رأيت في الصورة. فمن أين جاءت الثالثة؟ السبب أن Gotify عندما يحول YAML المحفوظ إلى كلاس، يحوله داخل الكائن الذي تعيده `DefaultConfig`، وهذا مذكور في تعليق الواجهة نفسها: الإعداد الافتراضي يستخدم أيضاً لفك الإعداد Unmarshaling. ومكتبة YAML في Go تستبدل القيم البسيطة مثل `check_every_seconds`، أما ال Map فتضيف إليها المفاتيح الجديدة ولا تحذف القديمة، فتبقى `backup` من الإعداد الافتراضي بجانب وظيفتيك:

![ثلاثة صناديق: الأول ما يعيده DefaultConfig وفيه check_every_seconds 10 وjobs فيها backup 90000، والثاني الإعداد المحفوظ في الواجهة وفيه check_every_seconds 5 وjobs فيها backup-db 20 وcerts-renew 600، والثالث ما تعمل به الإضافة فعلاً وفيه check_every_seconds 5 وثلاث وظائف منها backup 90000 باللون الأحمر، وتحتها شرح أن القيمة البسيطة تستبدل وال Map تضاف مفاتيحها، وحلان: DefaultConfig يعيد Map فارغة، أو ValidateAndSetConfig تبني Map جديدة](https://arabroot.io/content/images/2026/11/gotify-10-yaml-merge.webp)

الواجهة تعرض المحفوظ، والإضافة تعمل بما في الذاكرة

وفي هذه الإضافة كانت النتيجة غير ضارة، لأن الوظيفة التي لم تنبض أبداً تبقى في حالة الانتظار ولا تنبه، ولكن تخيل إضافة أخرى إعدادها قائمة عناوين يراقبها، أو قائمة مستخدمين مسموح لهم، فيبقى العنوان الافتراضي فيها دون أن يراه أحد في الواجهة. ولذلك إذا كان في إعداد إضافتك Map أو قائمة فأمامك حلان:

- اجعل `DefaultConfig` تعيد Map فارغة، وضع المثال في نص صفحة العرض بدل الإعداد الافتراضي.
- أو اجعل `ValidateAndSetConfig` تبني Map جديدة من القيم التي وصلتها، وتتحقق من كل مفتاح فيها، ولا تفترض أن ما وصلها هو ما كتبه المستخدم فقط.

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

⚠️

الإضافة كود يعمل داخل عملية السيرفر بكل صلاحياته، يصل إلى قاعدة البيانات والذاكرة والشبكة، وتوثيق Go نفسه يحذر من أن خللاً في برنامج يحمل الإضافات قد يستغله مهاجم لتحميل مكتبات خطرة. لذلك لا تضع في مجلد الإضافات إلا ملفاً بنيته بنفسك من كود قرأته، واجعل المجلد للقراءة فقط لمن ليس صاحب السيرفر، وإذا كنت لا تستخدم الإضافات فاترك `GOTIFY_PLUGINSDIR` فارغاً.

وانتبه إلى حد هذه الإضافة: هي تراقب مهامك، ولكنها لا تراقب Gotify نفسه، فإذا توقف السيرفر توقفت الإضافة معه ولن يصلك شيء. لذلك يبقى فحص `/health` لسيرفر Gotify من أداة على جهاز آخر ضرورياً، كما شرحنا في [من يراقب سيرفر المراقبة](https://arabroot.io/articles/%D9%81%D8%AD%D8%B5-%D8%A7%D9%84%D8%AA%D9%88%D9%81%D8%B1-uptime-checks-%D9%85%D9%86-%D9%8A%D8%B1%D8%A7%D9%82%D8%A8-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D9%82%D8%A8%D8%A9/).

## قبل الإنتاج: HTTPS وال Reverse Proxy والدخول الموحد

### ال Reverse Proxy مع WebSocket

Gotify يستطيع أن يطلب شهادة من Let's Encrypt بنفسه، ولكن الأشيع أن يعمل خلف Reverse Proxy يتولى الشهادة، والسيرفر يستمع على `127.0.0.1` فقط، والتوثيق يطلب في هذه الحالة أن تترك `GOTIFY_SERVER_SSL_ENABLED=false`. والنقطة التي يخطئ فيها أغلب الناس هي WebSocket، فمثال Nginx في [التوثيق](https://gotify.net/docs/nginx?ref=arabroot.io) يحتاج ثلاثة أشياء: `proxy_http_version 1.1` مع تمرير الترويستين `Upgrade` و`Connection` حتى يتحول الاتصال إلى WebSocket، وتمرير الترويسة `Host` كما هي لأن Gotify يقارن المضيف Host بالأصل Origin في طلبات WebSocket، ومهلة قراءة Read Timeout هي `proxy_read_timeout` مدتها دقيقة، وهي أطول من فترة Ping البالغة 45 ثانية فلا يغلق Nginx الاتصال وهو حي. أما Caddy فيمرر WebSocket وحده كما في [مثاله](https://gotify.net/docs/caddy?ref=arabroot.io)، ويكفيه سطر واحد، ويأخذ الشهادة تلقائياً:

```text
gotify.example.com {
    reverse_proxy 127.0.0.1:8080
}
```

وهذا المثال يفترض أنك نشرت منفذ ال Container على `127.0.0.1:8080` بدل `18610` في التجربة.

ومع ال Proxy غير في ملف البيئة ثلاثة أسطر: `GOTIFY_SERVER_TRUSTEDPROXIES` بعنوان ال Proxy حتى يرى السيرفر عنوان الزائر الحقيقي، و`GOTIFY_SERVER_SECURECOOKIE=true` حتى لا يرسل ملف الجلسة إلا عبر HTTPS، و`GOTIFY_SERVER_STREAM_ALLOWEDORIGINS` إذا كانت صفحة من نطاق آخر تفتح WebSocket على سيرفرك، وإلا فاتركه فارغاً. وقد شرحنا الفكرة العامة في [ما هو Reverse Proxy ولماذا تحتاجه](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-reverse-proxy-%D9%88%D9%84%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%AD%D8%AA%D8%A7%D8%AC%D9%87/)، وتثبيت Caddy في [تثبيت Caddy](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-caddy-reverse-proxy/).

### الدخول الموحد OIDC في الإصدار 3

الإصدار 3 أضاف الدخول الموحد عبر OpenID Connect، فإذا كان لديك مزود هوية Identity Provider مثل Authentik أو Keycloak فالمستخدمون يدخلون بحساباتهم فيه بدل كلمات مرور خاصة بGotify. والإعداد كله متغيرات في الملف نفسه كما في [صفحة OIDC](https://gotify.net/docs/oidc?ref=arabroot.io):

```bash
GOTIFY_OIDC_ENABLED=true
GOTIFY_OIDC_ISSUER=https://auth.example.org/application/o/gotify/
GOTIFY_OIDC_CLIENTID=gotify
GOTIFY_OIDC_CLIENTSECRET_FILE=/run/secrets/gotify_oidc_secret
GOTIFY_OIDC_REDIRECTURL=https://gotify.example.org/auth/oidc/callback
GOTIFY_OIDC_SCOPES=openid,profile,email,groups
GOTIFY_OIDC_GROUPS_CLAIM=groups
GOTIFY_OIDC_GROUPS_USER=gotify-users
GOTIFY_OIDC_GROUPS_ADMIN=gotify-admins
```

في الإعداد أعلاه لاحظ التالي:

- مزود الهوية يجب أن يدعم PKCE، والتوثيق يذكر أن المزودات التي لا تدعمه غير مدعومة.
- رابط العودة ينتهي دائماً ب `/auth/oidc/callback`، وإذا أردت الدخول من تطبيق Android بحساب المزود فأضف عند المزود رابطاً ثانياً هو `gotify://oidc/callback`.
- مع ربط المجموعات Groups يحدد المزود من هو مدير في كل دخول، ويلغي أي تغيير يدوي في Gotify، ومن ليس في المجموعتين لا يدخل أبداً، وهذا ما تريده في فريق.
- التطبيقات وتوكناتها لا تتأثر، فالسكربتات تبقى ترسل كما هي.

وإذا انتقل الجميع إلى OIDC تستطيع إيقاف الدخول المحلي ب `GOTIFY_LOCALAUTH_ENABLED=false`، ولكن انتبه إلى أن هذا يرفض المصادقة الأساسية في الواجهة البرمجية أيضاً، فكل سكربت إدارة يستخدم اسم المستخدم وكلمة المرور سوف يتوقف. وقد شرحنا البروتوكول نفسه في [شرح OAuth وOpenID Connect](https://arabroot.io/articles/%D8%B4%D8%B1%D8%AD-oauth-%D9%88-openid-connect-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)، وتثبيت مزود في [تثبيت Authentik](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-authentik-%D9%84%D9%84%D8%AF%D8%AE%D9%88%D9%84-%D8%A7%D9%84%D9%85%D9%88%D8%AD%D8%AF/).

### حفظ الرسائل Retention: Gotify لا ينسى

كما رأينا، الرسائل تبقى في قاعدة البيانات حتى تحذف، ولا يوجد إعداد يحذف القديم تلقائياً. وهذا مريح لأن الهاتف الذي كان مطفأ أسبوعاً يجد كل شيء، ولكنه يعني أمرين: أن قاعدة البيانات تكبر مع كل رسالة، وأن كل ما أرسلته يوماً، بما فيه سطر خطأ فيه اسم مستخدم داخلي أو عنوان IP، باق على القرص وفي النسخ الاحتياطية. والحل البسيط أن تحذف رسائل التطبيقات كثيرة الكلام دورياً بالطلب `DELETE /application/{id}/message` من مهمة مجدولة بتوكن عميل خاص بها، وهذا الطلب لا يحتاج رفع الجلسة، أما الحذف الجماعي `DELETE /message` فيحذف كل شيء، فلا تستخدمه في مهمة مجدولة.

### النسخ الاحتياطي Backup لمجلد البيانات

كل حالة Gotify في مجلد `/app/data`: قاعدة البيانات `gotify.db` وفيها المستخدمون والتطبيقات والعملاء والرسائل وإعدادات الإضافات، ومجلد صور التطبيقات، ومجلد الإضافات، ومجلد الشهادات إذا فعلت Let's Encrypt. وملف SQLite لا ينسخ بأمان وهو يكتب فيه، فأوقف ال Container ثوان أثناء النسخ، أو انسخ الملف بالأمر `sqlite3 gotify.db ".backup gotify-backup.db"` من الجهاز المضيف Host، وانسخ معه ملف البيئة وملفات الأسرار، لأن قاعدة البيانات دون كلمة مرور المدير أو سر OIDC لا تعيد لك سيرفراً يعمل. وكيف تختبر أن النسخة تستعاد فعلاً مشروح في [النسخ الاحتياطي بقاعدة 3-2-1](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/)، وطرق نسخ ال Volumes في [بيانات ال Containers](https://arabroot.io/articles/%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84-containers-volumes-%D9%88-bind-mounts-%D9%88%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A/).

## Gotify أم ntfy؟

الأداتان تحلان المشكلة نفسها بفلسفتين مختلفتين، وكلاهما شغلناه على الجهاز نفسه، وسوف نقارنهما مع Novu بالتفصيل في مقال المقارنة، أما هنا فالفروق التي تقرر الاختيار عادة:

| المعيار                   | Gotify                                              | ntfy                                                  |
| ------------------------- | --------------------------------------------------- | ----------------------------------------------------- |
| الفكرة                    | تطبيقات ترسل وعملاء يستقبلون، والرسائل ملك المستخدم | مواضيع Topics ينشر فيها ويشترك فيها أي حساب له صلاحية |
| الصلاحيات                 | بالتصميم: توكن التطبيق يرسل فقط                     | قواعد ACL لكل مستخدم وموضوع تكتبها أنت                |
| iPhone                    | لا يوجد تطبيق رسمي                                  | تطبيق iOS عبر السيرفر العام ntfy.sh                   |
| حفظ الرسائل               | حتى تحذفها                                          | 12 ساعة افتراضياً                                     |
| التوسعة                   | إضافات Go داخل السيرفر                              | قوالب للرسائل الواردة من الأدوات                      |
| الذاكرة خاملاً في تجربتنا | 11.84 MiB                                           | 26.52 MiB                                             |
| حجم ال Image              | 211 MB                                              | 125 MB                                                |

- **نقاط القوة في Gotify:** الفصل بين المرسل والمستقبل دون إعداد، والرسائل محفوظة دائماً فلا يضيع شيء على هاتف كان مطفأ، وواجهة تجمع الرسائل بحسب التطبيق، والإضافات حين تحتاج منطقاً لا يكفيه سكربت.
- **نقاط الضعف في Gotify:** لا يوجد iPhone، ومشاركة التنبيه نفسه بين عدة حسابات تحتاج تطبيقاً عند كل حساب، والإضافات حساسة لنسخة Go وتحتاج إعادة تشغيل، والرسائل لا تحذف وحدها.

فإذا كان فريقك كله على Android، وتريد أداة صغيرة لا تحتاج قواعد صلاحيات، فGotify مناسب جداً، أما إذا كان فيه iPhone أو تحتاج أن يشترك عدة أشخاص في مواضيع مختلفة بحسابات مختلفة، فntfy هو الأنسب، وقد شرحنا تشغيله الخاص في [دليل ntfy](https://arabroot.io/articles/%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D9%81%D9%88%D8%B1%D9%8A%D8%A9-%D8%A7%D9%84%D9%89-%D9%87%D8%A7%D8%AA%D9%81%D9%83-%D9%85%D8%B9-ntfy/).

## أخطاء شائعة Common Mistakes

- **ترك كلمة مرور المدير الافتراضية:** القيمة الافتراضية `admin`، وتستخدم مرة واحدة عند إنشاء قاعدة البيانات، فإذا شغلت السيرفر أول مرة دون `GOTIFY_DEFAULTUSER_PASS_FILE` فغيرها من الواجهة فوراً، لأن تغيير المتغير بعدها لا يفعل شيئاً.
- **توكن واحد لكل السكربتات:** إذا تسرب لا تعرف من أي سكربت، وإذا دورته توقفت كلها معاً، فاجعل لكل أداة تطبيقاً.
- **توكن عميل في سكربت إرسال:** توكن العميل يقرأ كل رسائلك ويدير التطبيقات، فلا تضعه حيث يكفي توكن تطبيق.
- **كل التطبيقات على الأولوية 5:** صوت لكل رسالة يعني أن الفريق سوف يكتم Gotify خلال أيام، فأنزل التقارير إلى 0 أو 2.
- **Reverse Proxy دون WebSocket:** الواجهة تفتح وتظهر الرسائل بعد تحديث الصفحة فقط، والتطبيق ينقطع كل دقيقة، والسبب ترويستا `Upgrade` و`Connection` أو الترويسة `Host` أو مهلة قراءة قصيرة.
- **تحسين البطارية مفعل على الهاتف:** تصل الرسائل عندما تفتح التطبيق فقط، فأوقفه لGotify وجرب بعد ساعة والشاشة مطفأة.
- **Markdown لنص من الخارج:** صورة في نص رسالة تنزل تلقائياً وتكشف متى فتحتها، فاترك المحتوى نصاً عادياً لكل ما لا تكتبه بيدك.
- **عنوان عربي يبدأ بكلمة لاتينية:** يظهر بترتيب مختلط في الواجهة والهاتف، فابدأه بكلمة عربية.
- **إضافة مبنية خارج `gotify/build`:** ترفض برسالة `was built with another version of package`، فابنها بالبيئة نفسها ونسخة Go من `GO_VERSION` ووحد المكتبات ب `gomod-cap`، وأعد بناءها مع كل ترقية للسيرفر.
- **Map في الإعداد الافتراضي لإضافة:** تندمج مع إعداد المستخدم ولا تستبدل، فاجعلها فارغة أو ابنها من جديد عند التحقق.
- **لا أحد يراقب Gotify:** الإضافة التي تراقب مهامك تتوقف مع السيرفر، فافحص `/health` من جهاز آخر.
- **قاعدة بيانات لا تنظف:** الرسائل لا تحذف وحدها، فاحذف رسائل التطبيقات كثيرة الكلام دورياً.

## قائمة تحقق Checklist قبل أن تعتمد على Gotify

| البند                                        | كيف تتحقق منه                                                                   |
| -------------------------------------------- | ------------------------------------------------------------------------------- |
| كلمة مرور المدير ليست الافتراضية ومن ملف سري | GOTIFY\_DEFAULTUSER\_PASS\_FILE في ملف البيئة، والدخول ب admin:admin يفشل       |
| التسجيل مغلق                                 | GOTIFY\_REGISTRATION=false                                                      |
| HTTPS فقط، وملف الجلسة آمن                   | الرابط في التطبيق يبدأ ب https، وGOTIFY\_SERVER\_SECURECOOKIE=true              |
| WebSocket يعمل خلف ال Proxy                  | رسالة تظهر في الواجهة دون تحديث الصفحة، والتطبيق يبقى Connected أكثر من دقيقتين |
| تطبيق لكل أداة مرسلة                         | صفحة Apps فيها تطبيق باسم كل أداة، وحقل آخر استخدام لكل منها                    |
| عميل لكل جهاز بالاسم                         | صفحة Clients لا تحتوي عملاء لا تعرفهم                                           |
| الأولويات مقصودة                             | التقارير على 0 إلى 3، والعاجل فقط على 8 وما فوقها                               |
| الهاتف يستقبل والشاشة مطفأة                  | رسالة بأولوية 8 بعد ساعة دون استخدام تصل فوراً                                  |
| نسخة احتياطية مستعادة                        | /app/data وملف البيئة والأسرار، واستعادة تجريبية على Container آخر              |
| الإضافات مبنية للإصدار الحالي                | سطر Loading plugin في السجل بعد كل ترقية                                        |
| من يراقب Gotify                              | فحص /health من جهاز آخر يرسل عبر قناة ثانية                                     |

## تدريب عملي Practice

1. أنشئ تطبيقين بأولويتين افتراضيتين مختلفتين، 2 و8، وأرسل من كل واحد رسالة دون أولوية، ثم انظر في الهاتف أي قناة استقبلت كل رسالة، وغير من إعدادات Android صوت قناة الأولوية العالية.
2. عدل إضافة النبضات حتى تحل مشكلة اندماج الإعداد بأحد الحلين، ثم ابنها من جديد وتأكد أن صفحة العرض لم تعد تعرض الوظيفة `backup`.

## الخلاصة Summary

وصلنا لنهاية الموضوع، وأهم ما فيه:

- Gotify سيرفر Go صغير يستقبل الرسائل عبر REST ويحفظها ويدفعها عبر WebSocket، والتطبيقات ترسل بتوكن `gtfya.` والعملاء يستقبلون بتوكن `gtfyc.`، فالتوكن الذي في سكربتك لا يقرأ شيئاً.
- الأولوية تختار قناة إشعار Android: 0 في التطبيق فقط، ومن 1 إلى 3 دون صوت، ومن 4 إلى 7 بصوت، ومن 8 إلى 10 بصوت واهتزاز وفوق الشاشة، فصمم أولوياتك قبل أن تصمم رسائلك.
- الإصدار 3 يقرأ ملف بيئة بدل `config.yml`، وكل متغير يقبل `_FILE` للأسرار، والتوكنات تظهر مرة واحدة، والأفعال الحساسة تحتاج رفع الجلسة.
- تطبيق Android يصل إلى سيرفرك مباشرة دون Google بثمن إشعار دائم وإذن المنبهات الدقيقة وإيقاف تحسين البطارية، ولا يوجد تطبيق iPhone.
- الإضافات كود Go داخل السيرفر يبنى بنفس نسخة Go ونفس المكتبات، وبها بنينا مراقب نبضات ينبه عند سكوت المهام، مع الانتباه إلى اندماج الإعداد الافتراضي.
- في الإنتاج: HTTPS وWebSocket عبر ال Proxy، وOIDC للفريق، ونسخ `/app/data`، وحذف الرسائل القديمة، وجهاز آخر يراقب Gotify نفسه.

[![](https://arabroot.io/content/images/2026/11/ntfy-cover-cover.webp)دليلإشعارات فورية من سيرفرك إلى هاتفك مع ntfyكيف تشغل سيرفر ntfy خاصاً، وتصلك على هاتفك رسالة عندما يمتلئ القرص أو تفشل النسخة الاحتياطية أو ينتهي النشر.](https://arabroot.io/articles/%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D9%81%D9%88%D8%B1%D9%8A%D8%A9-%D8%A7%D9%84%D9%89-%D9%87%D8%A7%D8%AA%D9%81%D9%83-%D9%85%D8%B9-ntfy/)[![](https://arabroot.io/content/images/2026/11/ntfy-gotify-novu-cover-cover.webp)دليلntfy أم Gotify أم Novu؟ مقارنة على تنبيه واحدأرسلنا تنبيه فشل النسخة الاحتياطية نفسه إلى ntfy وGotify وNovu، وقسنا زمن وصوله وذاكرة كل أداة وقرصها، لتعرف أيها لتنبيهات فريقك وأيها لإشعارات عملائك.](https://arabroot.io/articles/ntfy-%D8%A7%D9%85-gotify-%D8%A7%D9%85-novu-%D9%85%D9%82%D8%A7%D8%B1%D9%86%D8%A9-%D8%B9%D9%84%D9%89-%D8%AA%D9%86%D8%A8%D9%8A%D9%87-%D9%88%D8%A7%D8%AD%D8%AF/)[![](https://arabroot.io/content/images/2026/11/apprise-cover-cover.webp)دليلApprise: إرسال التنبيه إلى أي قناة من مكان واحدملف إعداد واحد بوسوم يوصل تنبيه أي سكربت إلى الهاتف وغرفة المحادثة والبريد وأي API داخلي، مع تجربة حقيقية لخمس قنوات وما يكشفه Apprise API بإعداداته الافتراضية.](https://arabroot.io/articles/apprise-%D8%A7%D8%B1%D8%B3%D8%A7%D9%84-%D8%A7%D9%84%D8%AA%D9%86%D8%A8%D9%8A%D9%87-%D8%A7%D9%84%D9%89-%D8%A7%D9%8A-%D9%82%D9%86%D8%A7%D8%A9/)[![](https://arabroot.io/content/images/2026/11/novu-cover-cover.webp)دليلNovu: إشعارات تطبيقك Push وEmail وIn-App من سيرفرككيف تشغل Novu على سيرفرك ليرسل تطبيقك إشعاراته داخل التطبيق وبالبريد وPush من طلب واحد، مع التجميع والتفضيلات وصندوق الإشعارات، وما الذي يجب أن تعدله قبل أن يعمل.](https://arabroot.io/articles/novu-%D8%A8%D9%86%D9%8A%D8%A9-%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D9%83%D8%A7%D9%85%D9%84%D8%A9-%D9%84%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D9%83/)[![](https://arabroot.io/content/images/2026/11/unifiedpush-cover-cover.webp)دليلUnifiedPush: إشعارات Android دون Googleكيف يصل إشعار تطبيقك إلى هاتف Android عبر موزع وسيرفر تختارهما أنت، بتجربة على هاتف حقيقي مع ntfy وما الذي يوقف الإشعارات في الخلفية.](https://arabroot.io/articles/unifiedpush-%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-android-%D8%AF%D9%88%D9%86-google/)[![](https://arabroot.io/content/images/2026/11/web-push-vapid-cover-cover.webp)دليلإشعارات المتصفح Web Push وVAPID دون خدمة خارجيةكيف تطلب إذن الإشعارات في اللحظة الصحيحة، وتشفر الرسالة وتوقعها بيدك بحسب RFC 8291 وRFC 8292، وتعرف متى يموت الاشتراك حتى حين ترد الخدمة بالقبول.](https://arabroot.io/articles/%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AA%D8%B5%D9%81%D8%AD-web-push-%D9%88-vapid-%D8%AF%D9%88%D9%86-%D8%AE%D8%AF%D9%85%D8%A9-%D8%AE%D8%A7%D8%B1%D8%AC%D9%8A%D8%A9/)[![](https://arabroot.io/content/images/2026/11/push-basics-cover-cover.webp)دليلكيف تعمل الإشعارات الفورية Push Notifications؟كيف يصل الإشعار إلى تطبيق مغلق عبر خدمات Apple وGoogle، وما الذي تراه هذه الخدمات من بيانات مستخدميك.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D8%A7%D9%84%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%81%D9%88%D8%B1%D9%8A%D8%A9-push-notifications/)[![](https://arabroot.io/content/images/2026/11/push-without-firebase-cover-cover.webp)دليلإشعارات Push بدون Firebase: ما يستبدل وما يبقى عند Appleما الذي تستطيع أن تخرج منه Firebase في إشعارات الويب وAndroid وiPhone، مع مختبر يرسل Web Push بمفاتيحك وUnifiedPush عبر ntfy على سيرفرك.](https://arabroot.io/articles/%D8%A7%D9%84%D8%A7%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A8%D8%AF%D9%88%D9%86-firebase-%D9%85%D8%A7-%D9%8A%D8%B3%D8%AA%D8%A8%D8%AF%D9%84-%D9%88%D9%85%D8%A7-%D9%84%D8%A7-%D9%8A%D8%B3%D8%AA%D8%A8%D8%AF%D9%84/)[![](https://arabroot.io/content/images/2026/11/uptime-checks-cover-cover-1.webp)دليلفحص التوفر Uptime Checks: من يراقب سيرفر المراقبة؟نفحص الموقع والشهادة وRedis من الخارج مع Blackbox Exporter وUptime Kuma، ونكشف النسخ الاحتياطي الذي توقف بصمت، ونتأكد أن أحداً يراقب سيرفر المراقبة نفسه.](https://arabroot.io/articles/%D9%81%D8%AD%D8%B5-%D8%A7%D9%84%D8%AA%D9%88%D9%81%D8%B1-uptime-checks-%D9%85%D9%86-%D9%8A%D8%B1%D8%A7%D9%82%D8%A8-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D9%82%D8%A8%D8%A9/)[![](https://arabroot.io/content/images/2026/11/alerting-basics-cover-cover-1.webp)دليلالتنبيهات Alerting: ماذا تنبه عليه ومتى توقظ أحداً؟نبني مع Alertmanager تنبيهات تصل فيها المشكلة الواحدة في رسالة واحدة، والعاجل فوراً والروتيني في ملخص صباحي، ونجرب كل قرار بالثواني.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D9%86%D8%A8%D9%8A%D9%87%D8%A7%D8%AA-alerting-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D9%86%D8%A8%D9%87-%D8%B9%D9%84%D9%8A%D9%87-%D9%88%D9%85%D8%AA%D9%89-%D8%AA%D9%88%D9%82%D8%B8-%D8%A7%D8%AD%D8%AF%D8%A7/)

## سجل التحديثات Changelog

- 20 نوفمبر 2026: كتابة المقال، وتنفيذ تجربة Gotify 3.1.1 في Docker بملف بيئة وكلمة مرور من ملف سري، والإرسال من Container على Alpine 3.24 مع curl 8.23.0 ومن gotify-cli 2.4.0، والاستقبال على Gotify Android 2.10.1 في Android 15 وفي واجهة الويب وعبر WebSocket من Node.js، وبناء إضافة نبضات في gotify/build:1.26.0-linux-amd64 مع plugin-api v1.0.0.