استضافة ntfy ذاتياً لإشعارات الخادم الفورية
شغّل ntfy على VPS خلف TLS باستخدام Docker Compose، واحمِ الموضوعات بالمستخدمين وACL، ثم أرسل تنبيهات cron ووحدات systemd OnFailure بأمان.
ما الذي يفعله خادم ntfy المستضاف ذاتياً
يحوّل خادم ntfy المستضاف ذاتياً طلب HTTP POST إلى إشعار فوري على هاتفك. تنشر الرسالة باستخدام curl، ثم تصل إلى تطبيق Android أو تطبيق iOS أو علامة تبويب في المتصفح أو أي جهة أخرى يمكنها إبقاء اتصال HTTP مفتوحاً. لا تحتاج إلى تثبيت مكتبة للعميل أو تشغيل وسيط رسائل.
يعنون ntfy الرسائل باستخدام الموضوع. الموضوع هو اسم في مسار URL، مثل https://ntfy.example.com/alerts، ويُنشأ فور نشر أي شخص رسالة عليه. في التثبيت الافتراضي، يمكن لأي شخص يعرف هذا الاسم قراءة الموضوع والكتابة إليه، ولذلك تقارن وثائق المشروع نفسها اسم الموضوع بكلمة مرور. يناسب هذا النموذج خدمة ntfy.sh العامة. لكنه لا يناسب خادماً ينقل إشعارات فشل النسخ الاحتياطي لديك، لذلك يفعّل هذا الدليل المصادقة قبل إرسال أول رسالة.
ما تحتاج إليه قبل البدء
تحتاج إلى VPS يعمل بنظام Ubuntu 24.04 أو Debian 13، مع Docker Engine وCompose plugin، واسم نطاق، وذاكرة RAM قليلة جداً. أنشئ سجل A في DNS (نظام أسماء النطاقات) يوجّه ntfy.example.com إلى عنوان IP العام للخادم، ثم تأكد من أنه يُحلّ قبل تنفيذ أي خطوة أخرى.
dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw statusيجب أن يطبع dig عنوان IP الخاص بالخادم. يتطلب إصدار الشهادة أن يُحل اسم المضيف علناً إلى الخادم عبر سجل A أو AAAA. اترك المنفذ 80 مفتوحاً لأن ACME (بيئة إدارة الشهادات التلقائية)، وهو البروتوكول الذي تستخدمه Let's Encrypt، يستعمله لتنفيذ تحدي HTTP. لا تحصل حاوية ntfy نفسها على منفذ عام.
إنشاء ملف إعدادات ntfy
لا تتضمن صورة Docker ملف إعدادات، لذلك عليك إنشاءه. تقرأ كل الأوامر اللاحقة في هذا الدليل منه. اعثر أولاً على معرّف المستخدم ومعرّف المجموعة اللذين ستعمل الحاوية بهما.
id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.ymlbase-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: falseتحمل أربعة أسطر من هذه الأسطر المسؤولية الأساسية. يجب أن تكون base-url هي العناوين العامة الدقيقة عبر HTTPS، لأن ntfy يستخدمها لإنشاء روابط المرفقات وإشعارات الدفع إلى iOS المستضاف ذاتياً. تربط listen-http: ":2586" الخدمة بجميع الواجهات داخل الحاوية، وقد يبدو ذلك غير حذر لكنه صحيح: للحاوية مساحة أسماء شبكة خاصة بها، ولذلك فإن الربط مع 127.0.0.1 داخلها سيجعل المنفذ غير قابل للوصول من المضيف، ولن يتصل منفذ Docker المنشور أبداً. تحدد auth-default-access: "deny-all" وضع الأمان بالكامل، لأنها ترفض القراءة والكتابة من أي مستخدم لا يملك تفويضاً صريحاً. تخبر behind-proxy: true خدمة ntfy بأخذ عنوان العميل من الترويسة X-Forwarded-For، بحيث تحسب حدود المعدل عدد الزوار الفعليين بدلاً من اعتبار الـreverse proxy عميلاً واحداً كثير النشاط.
تتيح enable-login: true للمستخدمين تسجيل الدخول عبر تطبيق الويب أو API. وتبقى enable-signup بالقيمة false، لأن إنشاء الحسابات ذاتياً على خادم خاص يفتح منفذاً غير ضروري للوصول.
sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.ymlشغّل ntfy باستخدام Docker Compose
ضع هذا في /opt/ntfy/compose.yaml، مع استبدال 1000:1000 بالرقمين id -u وid -g المطبوعين أعلاه.
services:
ntfy:
image: binwiederhier/ntfy:v2.36.0
container_name: ntfy
command: serve
user: "1000:1000"
environment:
- TZ=UTC
volumes:
- /etc/ntfy:/etc/ntfy
- /var/cache/ntfy:/var/cache/ntfy
- /var/lib/ntfy:/var/lib/ntfy
ports:
- "127.0.0.1:2586:2586"
restart: unless-stoppedcd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/healthيستجيب الخادم السليم بـ{"healthy":true,"role":"active"}. هناك تفصيلان مقصودان في ملف Compose هذا. ثبّت الصورة على v2.36.0، وهو الإصدار المستقر الحالي في 1 نوفمبر 2026، بدلاً من latest، لأن latest ينزّل في المرة التالية docker compose pull الصورة الحالية، ثم يعيد docker compose up -d إنشاء الحاوية باستخدامها؛ سحب الصورة وحده لا يغيّر إصدار الخادم قيد التشغيل. ويظل تثبيت الإصدار بحاجة إلى تحديث. فقد شهد أكتوبر 2026 وحده عشرة إصدارات: v2.29.0 في 7 أكتوبر، وv2.30.0 في 12 أكتوبر، وv2.31.0 وv2.31.1 في 16 أكتوبر، وv2.32.0 في 18 أكتوبر، وv2.33.0 وv2.33.1 في 23 أكتوبر، وv2.34.0 في 24 أكتوبر، وv2.35.0 في 30 أكتوبر، وv2.36.0 في 31 أكتوبر. يصلح v2.31.0 الرسائل التي فُقدت عندما أعاد العميل الاتصال قبل وصولها إلى ذاكرة التخزين المؤقت للرسائل، لكنه مع عمليات إعادة الاتصال التي تستخدم since=<message ID> يقرأ كل رسالة في الموضوع من قاعدة البيانات، ولذلك أعاد ntfy.sh الإصدار إلى نسخة سابقة. يصلح v2.31.1 هذا الحمل باستخدام فهرس جديد، ويصلح v2.34.0 احتفاظ المستخدمين المسحوبة صلاحياتهم أو المحذوفين ببعض الاشتراكات. يصلح v2.35.0 الطلبات المتزامنة التي تتعامل مع بيانات الاعتماد الصالحة باعتبارها مجهولة، كما يصلح تجاوز تفويض بوابة دفع Matrix على SQLite، لذا انقل التثبيتات الأقدم إلى v2.36.0. يُنشر المنفذ على 127.0.0.1:2586:2586، ولذلك لا يمكن الوصول إلى الحاوية إلا من عنوان loopback المحلي للخادم. اكتب 2586:2586 بدلاً منه، وسيُدرج Docker قواعد جدار الحماية الخاصة به قبل قواعدك، ما يعني أن المنفذ سيستجيب من الإنترنت رغم أن ufw status يقول إن المنفذ مغلق. وينطبق كلا الأسلوبين على الحاوية التالية التي تضيفها: مرحل RustDesk مستضاف ذاتياً يثبّت وسم صورته بالطريقة نفسها، لكنه لا يستطيع الاختباء خلف loopback لأن منافذ الإشارة والترحيل فيه يجب أن تستجيب من الإنترنت.
إذا طبع curl القيمة Connection refused، فاقرأ سجل الحاوية. يعني خطأ الصلاحيات على /var/lib/ntfy/user.db أن السطر user: لا يطابق مالك تلك الأدلة، ولذلك لا تستطيع العملية إنشاء قاعدة بياناتها الخاصة وتنتهي. يشرح دليل أساسيات Docker Compose لخادم VPS ملكية وحدات التخزين وسياسات إعادة التشغيل بمزيد من التفصيل.
إضافة TLS أمام الخادم باستخدام Caddy
يطلب Caddy الشهادة ويجددها تلقائياً، وهذا أقصر طريق لتشغيل TLS (أمان طبقة النقل).
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddyاستبدل محتويات /etc/caddy/Caddyfile بثلاثة أسطر.
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/healthيعني استخدام {"healthy":true,"role":"active"} نفسه عبر HTTPS أن المسار بأكمله يعمل. تشير 502 من Caddy عادةً إلى أن ntfy لا يستمع: تحقق باستخدام sudo ss -lntp | grep 2586. إذا كان ntfy يستمع واستمر 502، فسيسجل Caddy خطأ الخدمة الخلفية الذي واجهه، مثل إعادة ضبط الاتصال. يعني خطأ الشهادة عادةً أن سجل DNS غير صحيح أو أن التحقق من الشهادة لا يستطيع الوصول إلى الخادم على المنفذ 80 أو 443؛ افحص sudo journalctl -u caddy -n 50 لمعرفة خطأ التحقق. تتطلب إضافة خدمة أخرى لاحقاً كتلة اسم مضيف إضافية في ملف Caddyfile نفسه، وبهذه الطريقة ينتهي شيء مثل Halcyon، واجهة متجر فيديو من حقبة التسعينيات لمكتبة Jellyfin على نطاق فرعي ثانٍ على الخادم نفسه.
إذا كنت تشغّل nginx بالفعل، فانقل إعدادات الوكيل التي يوثّقها ntfy: proxy_http_version 1.1 وproxy_buffering off وproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for، واضبط مهلات القراءة والإرسال على ثلاث دقائق على الأقل. يحتفظ المشترك باتصال HTTP واحد مفتوحاً طوال مدة الاستماع. تحسب قيمة proxy_read_timeout الافتراضية في nginx، ومدتها 60 ثانية، الوقت بين عمليتي قراءة فقط، ويرسل ntfy رسالة keepalive كل 45 ثانية افتراضياً (keepalive-interval) تحديداً لمنع الوسطاء من إغلاق الاتصال بسبب عدم النشاط. لذلك يظل المشترك الهادئ متصلاً حتى خلف إعداد nginx الافتراضي، وتوفر المهلات الأطول هامشاً إضافياً، لكنها ليست ما يبقي الاتصال قائماً. إذا رفعت قيمة keepalive-interval، فأبقها أقل من مهلة القراءة في الوكيل.
إنشاء المستخدمين وتقييد الوصول إلى الموضوعات
تم تفعيل المصادقة، ولا يملك أي مستخدم صلاحية الوصول إلى أي شيء بعد، وهذا هو الهدف. أنشئ حساب مسؤول واحداً لك، وحساب آلة واحداً للبرامج النصية. تقرأ هذه الأوامر /etc/ntfy/server.yml من داخل الحاوية، ولذلك فإن ملف الإعداد مركّب كـvolume.
sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user listيطالب كل أمر user add بإدخال كلمة مرور. يتجاوز المسؤول قائمة التحكم، ويمكنه قراءة كل موضوع والكتابة إليه، لذلك احتفظ بهذا الحساب لك ولتطبيق الهاتف. أما robot فهو مستخدم عادي لا يملك أي صلاحية إلى أن تمنحه بعضها.
sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy accessإدخال ACL هو مستخدم وموضوع وصلاحية. يمكن أن يكون الموضوع اسماً حرفياً أو pattern، حيث يطابق * أي قيمة. لذلك يغطي alerts_* كلاً من alerts_backup وalerts_db من دون أمر مستقل لكل مضيف. تعني الصلاحية write النشر فقط، ولذلك لا يمكن لرمز مميز مسروق من cron job الاشتراك وقراءة ما أرسله. يحدد اسم المستخدم الخاص everyone ما يمكن لزائر غير موثّق فعله. باستخدام deny-all كإعداد افتراضي، ستستخدمه غالباً لفتح شيء عام عن قصد، مثل ntfy access everyone status read. كما يقبل deny عندما تريد قاعدة صريحة تمنع الزوار المجهولين من الوصول إلى موضوع.
يجب أن تحمل البرامج النصية رمزاً مميزاً، لا كلمة مرورك.
sudo docker compose exec ntfy ntfy token add robotيطبع الأمر رمزاً مميزاً يبدأ بـ tk_. يرث الرمز المميز صلاحيات المستخدم الذي ينتمي إليه بالكامل، ولذلك يمكن لهذا الرمز النشر إلى الموضوعات alerts ولا يمكنه فعل أي شيء آخر. يعرض ntfy token list ما هو موجود، ويلغي ntfy token remove رمزاً واحداً من دون تغيير كلمة مرور المستخدم.
إرسال رسالتك الأولى وإثبات عمل القفل
ابدأ بالتحقق من أن الباب مغلق.
curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alertsيطبع ذلك 403، و403 هي الإجابة الصحيحة: يرفض auth-default-access: "deny-all" النشر المجهول. أرسل الآن رسالة فعلية.
curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
-H "Title: Nightly backup finished" \
-H "Priority: default" \
-H "Tags: white_check_mark" \
-d "42 GB copied in 11 minutes" \
https://ntfy.example.com/alertsيرد الخادم بالرسالة المخزنة بتنسيق JSON، وهذا يثبت قبولها بدلاً من تجاهلها. تمثل Title السطر الأول العريض. تتراوح Priority من 1 إلى 5، أو حسب الاسم من min إلى urgent، وهي تحدد ما إذا كان الهاتف سيصدر صوتاً. تتحول Tags إلى رموز emoji في الإشعار عندما يطابق الاسم رمزاً مختصراً معروفاً لـemoji، وتبقى نصاً عادياً عندما لا يطابقه.
لمراقبة موضوع من الطرفية، ابثه:
curl -s -u admin https://ntfy.example.com/alerts/rawيطالبك curl بكلمة المرور. تصل كل رسالة في سطر واحد، أما الأسطر الفارغة التي تظهر من حين إلى آخر فهي رسائل إبقاء الاتصال حياً. يتيح فتح https://ntfy.example.com في متصفح وتسجيل الدخول بالحساب نفسه استخدام إصدار تطبيق الويب من البث نفسه.
اضبط حدود المعدل حتى لا يتمكن نص برمجي واحد من إغراق الخادم
يحصل كل زائر افتراضياً على حصة تبلغ 60 طلباً، وتُعاد تعبئتها بمعدل طلب واحد كل 5 ثوانٍ. هذا سخاء زائد لخادم خاص، وسيستهلكه نص برمجي عالق في حلقة إعادة المحاولة بالكامل. أضف الحدود إلى server.yml.
visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500sudo docker compose restart ntfyيحصل الزائر الذي يتجاوز الحد على HTTP 429 بدلاً من تسليم الرسالة. يُحتسب الحد لكل عنوان زائر، ولهذا السبب يمثل behind-proxy: true أهمية كبيرة: من دونه لا يرى ntfy إلا عنوان Caddy، ويُحتسب كل عميل باعتباره الزائر نفسه، ويستنفد نص برمجي صاخب الحصة التي يشترك فيها هاتفك وخوادمك الأخرى. ابتداءً من v2.36.0، تبقى العدادات اليومية محفوظة بعد إعادة التشغيل في قاعدة بيانات المستخدمين، وتُعاد حصة كل زائر في دورة 24 ساعة خاصة به بدلاً من إعادة ضبطها عند منتصف الليل وفق UTC.
تنبيه من مهمة cron تفشل
أبقِ الرمز خارج سطر الأوامر. يعرض ps aux سطر الأوامر الكامل لكل عملية قيد التشغيل لكل مستخدم على الخادم، لذلك يمكن لأي حساب محلي قراءة الرمز الممرر باستخدام -H طوال مدة تشغيل curl. يتجنب ملف إعدادات curl ذلك.
sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrcغلّف المهمة الآن. احفظ هذا الملف باسم /usr/local/bin/backup-with-alert.sh ثم نفّذ chmod 750 عليه.
#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: backup.sh failed with exit $code" \
-H "Priority: high" \
-H "Tags: warning" \
--data-binary @- \
https://ntfy.example.com/alerts
fi
exit "$code"17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1يُلتقط $? في السطر الذي يلي الأمر مباشرة، لأن تشغيل الأمر التالي سيستبدل قيمته. يمر الإخراج عبر tail -c 1000 لأن ntfy يفرض حداً أقصى لحجم الرسالة، ولأن الإشعار ليس عارضاً للسجلات. يحافظ exit "$code" الختامي على حالة الخروج الأصلية، لذلك ستظل أي جهة أخرى تراقب هذه المهمة ترى أنها فشلت. اختبر العملية كاملة بتوجيه البرنامج النصي إلى /bin/false لتشغيل واحد.
يكون فرع الفشل الذي لا يُنفَّذ أسوأ من عدم وجود تنبيهات، لأنه يوحي بأن الصمت يعني النجاح. تمنح cron مهمتك بيئة شبه فارغة وPATH أقصر بكثير من بيئة shell الخاصة بتسجيل الدخول، لذلك قد يتوقف البرنامج النصي الذي يعمل عند تشغيله يدوياً قبل أن يصل إلى سطر curl. يشرح الدليل الذي يوضح سبب عدم تشغيل مهمة cron هذه المشكلات المتعلقة بالبيئة. استخدم المسارات المطلقة في كل المواضع، واقرأ ملف السجل بعد أول تشغيل مجدول بدلاً من الافتراض.
التنبيه عند فشل وحدة systemd
يغطي Cron المهام المجدولة. تحتاج الخدمات طويلة التشغيل إلى OnFailure=، الذي يشغّله systemd كلما دخلت وحدة في حالة failed. أنشئ وحدة قالب واحدة وأعد استخدامها لكل خدمة على الخادم. احفظها باسم /etc/systemd/system/ntfy-unit-failed@.service.
[Unit]
Description=Send an ntfy alert because %i failed
[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %iثم /usr/local/bin/ntfy-unit-failed، بالوضع 750:
#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: $unit failed on $(hostname -s)" \
-H "Priority: urgent" \
-H "Tags: rotating_light" \
--data-binary @- \
https://ntfy.example.com/alertsاربطها بخدمة باستخدام drop-in، حتى لا تتمكن ترقية الحزمة من استبدال تعديلاتك.
sudo systemctl edit myapp.service[Unit]
OnFailure=ntfy-unit-failed@%n.serviceيتوسع %n إلى اسم الوحدة الكامل، لذلك تصبح الوحدة المُنشأة ntfy-unit-failed@myapp.service.service، بينما يمرر %i داخل القالب myapp.service إلى البرنامج النصي باعتباره الوسيط الأول. يتيح ذلك لقالب واحد خدمة كل وحدة. اختبر عمله باستخدام وحدة تفشل عمداً، واحفظها باسم /etc/systemd/system/ntfy-selftest.service.
[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service
[Service]
Type=oneshot
ExecStart=/bin/falsesudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.serviceينتهي أمر البدء برمز غير صفري ويطبع Job for ntfy-selftest.service failed because the control process exited with error code، ومن المفترض أن يهتز الهاتف بعد نحو ثانية. احذف وحدة الاختبار بعد ذلك.
تستحق إحدى الحالات الانتباه. يعمل OnFailure= فقط عندما تصل الوحدة إلى الحالة failed، بينما يتجاوز RestartMode=direct هذه الحالة أثناء عمليات إعادة التشغيل التلقائية، ولذلك يتجاوز معالج الفشل أيضاً. مع الإعداد الافتراضي RestartMode=normal، تمر عمليات إعادة التشغيل التلقائية بالحالة الفاشلة. يتحكم StartLimitBurst وStartLimitIntervalSec في وقت رفض عمليات البدء المتكررة؛ اضبطهما بحيث تتوقف حلقة التعطل في النهاية. تُعد المؤقتات بديلاً أنظف لنمط Cron السابق، لأن وحدة الخدمة الخاصة بالمؤقت تدعم OnFailure= drop-in نفسه، ويوضح الدليل إلى خدمات systemd والمؤقتات على VPS كيفية تحويل أحدها.
اربط مراقب وقت التشغيل بالموضوع نفسه
Uptime Kuma، وهو مراقب حالة مستضاف ذاتياً، يتضمن نوعاً لإشعارات ntfy. افتح Settings، ثم Notifications، ثم Setup Notification، واختر Ntfy، واضبط عنوان الخادم على https://ntfy.example.com والموضوع على alerts، واختر مستوى أولوية، والصق رمز الوصول robot. أرسل إشعار الاختبار قبل الحفظ، لأن اسم الموضوع الخاطئ يعيد خطأً عند منح write لا يشمله.
الحد الفعلي لهذا الترتيب هو أن المراقب الذي يعمل على VPS نفسه لا يستطيع إبلاغك بأن VPS متوقف، كما أن ntfy لا يستطيع إيصال خبر توقف ntfy. شغّل المراقب على جهاز مختلف، وامنحه قناة إشعار ثانية، مثل البريد الإلكتروني، لمراقب يتابع ntfy نفسه. يغطي نوع Push monitor في Uptime Kuma نقطة الضعف الأخرى: يستدعي cron job عنوان push بعد نجاح التشغيل، وينبّه Kuma عندما تتوقف هذه الاستدعاءات عن الوصول. لا يتفعّل مسار الفشل إلا عند تشغيل المهمة، لذلك لا يخبرك بشيء عن المهمة التي لم تبدأ قط.
هل يعمل ntfy المستضاف ذاتياً على Android وiPhone؟
على Android، نعم، من دون قيود. ثبّت التطبيق من Google Play أو F-Droid، وافتح Settings، واضبط الخادم الافتراضي على https://ntfy.example.com، وأضف حسابك من شاشة إدارة المستخدمين، ثم اشترك في alerts. يحافظ التسليم الفوري على تشغيل foreground service حتى تصل الرسائل عندما يكون الهاتف في وضع doze، والإشعار الدائم المصاحب له هو متطلب في Android لخدمات foreground service، وليس خطأً. لا يحتوي إصدار F-Droid على أي كود Firebase، لذلك تستخدم كل الاشتراكات التسليم الفوري. ويمكن لـntfy أيضاً أن يعمل كموزّع UnifiedPush، وهو بديل مفتوح لخدمة Google للإشعارات، وبذلك تستطيع التطبيقات الأخرى التي تدعم UnifiedPush التسليم عبر خادمك أيضاً.
في تطبيق iOS الرسمي، يعمل ntfy مع اعتماد واحد لا يمكنك إزالته. يعلّق iOS التطبيق الموجود في الخلفية، كما أن أوضاع الخلفية التي تسمح بها Apple، مثل تشغيل الصوت وتلقي تحديثات الموقع ومعالجة المهام المجدولة، لا تتيح للتطبيق الانتظار لتلقي رسالة من خادمك. لذلك يجب أن تأتي عملية الإيقاظ السريع عبر APNs (Apple push notification service). ولا يستطيع إرسال الإشعار إلى التطبيق إلا مزوّد يملك بيانات اعتماد مخوّلة له، لذلك لا يستطيع خادمك الوصول إلى التطبيق الرسمي مباشرة. يحل ntfy هذه المشكلة باستخدام relay: يرسل خادمك poll_request يتضمن معرّف الرسالة إلى ntfy.sh، الذي يمرّرها عبر Firebase وAPNs لإيقاظ التطبيق، ثم يجلب التطبيق نص الرسالة من خادمك.
upstream-base-url: "https://ntfy.sh"كن واضحاً بشأن تكلفة ذلك. يبقى محتوى الرسالة على خادمك، لكن حقيقة وصول رسالة ومعرّفها يمران عبر بنية تحتية لا تديرها. من دون هذا الإعداد، تصل الإشعارات على iPhone من خادم مستضاف ذاتياً في النهاية، لكن مستندات ntfy تحذّر من أن التأخير قد يستمر ساعات، لأن شيئاً لا يوقظ التطبيق بسرعة. لاستخدام تطبيق iOS أصلي من دون relay الخاص بـntfy.sh، أنشئ التطبيق وأصدره بنفسك باستخدام حساب Apple للمطورين خاص بك ومفاتيح APNs الخاصة بك. يتطلب ذلك رسماً سنوياً وإعادة بناء التطبيق مع كل تحديث. وهناك خيار آخر هو PWA الخاص بـntfy على iOS 16.4 أو أحدث: أضفه إلى الشاشة الرئيسية واضبط Web Push على خادمك. يتجنب ذلك relay الخاص بـntfy.sh، لكنه يظل يستخدم بنية الإشعارات الفورية الخاصة بالمتصفح. إذا كان relay غير مقبول لاستخدامك، فاحصر التنبيهات في Android أو في تطبيق الويب على سطح المكتب.
النسخ الاحتياطية والترقيات وتثبيت الصورة
لا يمكن إعادة إنشاء المسارين /etc/ntfy/server.yml و/var/lib/ntfy/user.db. يحتوي الثاني على كل مستخدم، وتجزئة كلمة المرور، وإدخال ACL، ورمز مميز، لذا تعامل معه مثل مفتاح خاص.
sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgzانسخ هذا الملف إلى خارج الخادم. يحتوي cache.db على الرسائل الحديثة، أي رسائل 12 ساعة باستخدام cache-duration أعلاه، إضافة إلى أي رسالة مجدولة للتسليم لاحقاً، وتبقى هذه الرسالة حتى 12 ساعة بعد تسليمها. ما لم تكن تجدول الرسائل مسبقاً، فلن يسبب فقدانه خسارة تستحق الحماية. تعني الترقية تعديل الوسم في ملف Compose، وسحب الصورة، وإعادة إنشاء الحاوية.
sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/healthاقرأ ملاحظات الإصدار أولاً. تُرحّل قواعد بيانات SQLite عند البدء، لذا فإن الرجوع إلى وسم أقدم بعد تغيير المخطط ليس آمناً. نقل v2.31.1، مثلاً، ذاكرة تخزين الرسائل المؤقتة إلى إصدار المخطط 17، وتذكر ملاحظات ترقيته أن الرجوع إلى v2.31.0 أو إصدار أقدم يتطلب إعادة ذلك الإصدار يدوياً إلى 16. تؤدي الترقية إلى v2.36.0 إلى تصفير العدادات اليومية الحالية للجميع مرة واحدة. احتفظ بالنسخة الاحتياطية التي أنشأتها للتو حتى يعمل الإصدار الجديد يوماً كاملاً. وتشير الملاحظات أيضاً إلى تغييرات السلوك. ابتداءً من v2.31.0، يتلقى العميل الذي يعيد الاتصال باستخدام since=<message ID> أيضاً الرسائل المنشورة في الثانية نفسها، ولذلك قد يرى رسالة مكررة. تتخلص تطبيقات ntfy وتطبيق الويب من التكرارات باستخدام معرّف الرسالة، لكن على نص برمجي تكتبه بنفسك ويعيد تشغيل موضوع أن يفعل الشيء نفسه. لكل خدمة على الخادم قائمة قصيرة خاصة بها من المسارات التي لا يمكن إعادة إنشائها، ويحدد مقارنة PhotoPrism وImmich هذه القائمة وأوامر النسخ الاحتياطي المرتبطة بها لمكتبة صور على النوع نفسه من خوادم VPS.
Gotify وApprise
Gotify هو الخيار الأصغر: ملف ثنائي واحد مع واجهة ويب وتطبيق Android، وتُنظَّم الرسائل حسب التطبيق. يناسب ذلك خادماً خاصاً يكون Android فيه الوجهة الوحيدة.
Apprise هي مكتبة Python وأداة سطر أوامر، ويتوفر لها خادم Apprise API مستقل. وتوزّع رسالة واحدة على أكثر من مئة خدمة، بما في ذلك ntfy. يناسب ذلك برنامجاً نصياً يجب أن يرسل التنبيه إلى عدة وجهات في الوقت نفسه.
أما ntfy فهو الخيار الذي يوفّر خادماً وواجهة HTTP API وتطبيقات على منصتي الأجهزة المحمولة. لذلك فهو الإجابة المعتادة لإرسال التنبيهات من خادم مستأجر.
FAQ
لماذا يعيد النشر إلى خادم ntfy لدي استجابة 403؟
عند تفعيل auth-default-access: "deny-all" في server.yml، يُرفض النشر المجهول، وهذا هو السلوك المقصود. أرسل بيانات الاعتماد باستخدام -u user:pass أو -H "Authorization: Bearer tk_...". إذا كنت ترسل رمزاً مميزاً بالفعل وما زلت تتلقى 403، فتحقق مما إذا كان مستخدمه يملك إدخالاً في ACL يسمح بالكتابة إلى الموضوع: يؤدي عدم وجود إدخال مطابق، أو read-only أو deny، إلى رفض النشر. في v2.34.0، كان من الممكن أن تجعل الطلبات المتزامنة من عنوان IP نفسه بيانات الاعتماد الصحيحة تُعامل كأنها مجهولة؛ ويصلح v2.35.0 هذا الخلل، لذا حدّث البرنامج قبل اعتبار 403 المتقطع دليلاً على وجود مشكلة في ACL. شغّل ntfy access لطباعة القائمة الكاملة. تذكّر أن منح write لا يسمح بالاشتراك، لذلك سيُرفض الحساب الذي ينشر بنجاح عندما يحاول قراءة الموضوع نفسه.
هل تعمل الإشعارات على iPhone مع خادم ntfy مستضاف ذاتياً؟
تعمل عبر مرحّل عند استخدام تطبيق iOS الرسمي. يجب أن يصل إيقاظ تطبيق iPhone المعلّق بسرعة عبر APNs (خدمة Apple للإشعارات الفورية)، ويتطلب الإرسال إلى التطبيق الرسمي بيانات اعتماد الدفع الخاصة بالناشر، لذلك يرسل ntfy رسالة poll_request تتضمن معرّف الرسالة إلى ntfy.sh، الذي يمررها إلى الجهاز. عيّن upstream-base-url: "https://ntfy.sh" في server.yml ثم أعد تشغيل الحاوية. ويُجلب نص الرسالة نفسه من خادمك. من دون هذا الإعداد، تصل إشعارات iOS في النهاية، لكن تحذّر وثائق ntfy من أن التأخير قد يمتد إلى ساعات. ويوفر PWA مساراً آخر على iOS 16.4 أو الإصدارات الأحدث عند إعداد Web Push على خادمك.
لماذا لم يصل تنبيه ntfy من مهمة cron؟
شغّل سطر curl بمفرده أولاً للتأكد من صحة الرمز المميز والموضوع. إذا نجح يدوياً لكنه لم ينجح من cron، فالعطل يسبق التنبيه: تشغّل cron المهام ببيئة محدودة وبـPATH قصير، لذلك قد يتوقف البرنامج النصي الذي يستدعي أمراً باسمه المجرد قبل الوصول إلى سطر curl. استخدم مسارات مطلقة، ووجّه مخرجات المهمة إلى ملف سجل، ثم اقرأ ذلك الملف بعد التشغيل التالي. تعني استجابة 429 بدلاً من التسليم أن حداً ما رفض الطلب. عادةً يعيد البرنامج النصي المحاولة بسرعة كبيرة، لكن يُرفض الزائر الذي استنفد حصة يومية، مثل حد الرسائل المحدد أعلاه، بالطريقة نفسها حتى عند إرسال طلب واحد.
هل ينبغي إتاحة ntfy على الإنترنت العام؟
تحتاج تطبيقات الهاتف إلى الوصول إليه من شبكات الهاتف المحمول، لذلك يُعدّ توفير نقطة نهاية HTTPS عامة مع auth-default-access: "deny-all" وACLs منفصلة لكل موضوع الإعداد المعتاد، ويكون آمناً ما دام لا يمكن قراءة أي موضوع بواسطة everyone. ويكون تشغيل نسخة لا تصل إليها إلا عبر VPN مناسباً عندما يكون كل مشترك جهازاً تتحكم فيه. لكنه غير مناسب للهواتف، لأن التطبيق لا يستقبل إلا أثناء اتصال النفق، ولذلك تتراكم التنبيهات إلى أن يعيد الهاتف الاتصال.