Як розгорнути self-hosted ntfy для push-сповіщень
Розгорніть ntfy на VPS через Docker Compose і TLS, захистіть topic користувачами та ACL, а сповіщення запускайте з cron і systemd OnFailure.
Що робить self-hosted ntfy-сервер
Self-hosted ntfy-сервер перетворює HTTP POST на push-сповіщення на телефоні. Ви публікуєте повідомлення за допомогою curl, і воно надходить у застосунок для Android, застосунок для iOS, вкладку браузера або будь-який інший клієнт, який може підтримувати відкрите HTTP-з’єднання. Не потрібно встановлювати клієнтську бібліотеку або запускати брокер повідомлень.
ntfy адресує повідомлення за topic. Topic — це ім’я в частині URL зі шляхом, наприклад https://ntfy.example.com/alerts. Він створюється в момент першої публікації повідомлення. У типовій інсталяції будь-хто, хто знає це ім’я, може читати topic і публікувати в нього повідомлення. Саме тому в документації проєкту назву topic порівнюють із паролем. Така модель підходить для публічного сервісу ntfy.sh. Вона не підходить для сервера, який передає повідомлення про помилки резервного копіювання. Тому в цьому посібнику автентифікацію буде ввімкнено до надсилання першого повідомлення.
Що потрібно підготувати
Потрібен VPS під керуванням Ubuntu 24.04 або Debian 13 із Docker Engine і Compose plugin, доменне ім’я та мінімальний обсяг RAM. Створіть DNS-запис типу A (domain name system), який спрямовує ntfy.example.com на публічну IP-адресу сервера, і перевірте розв’язання імені, перш ніж виконувати будь-які інші дії.
dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw statusdig має вивести IP-адресу вашого сервера. Для випуску сертифіката ім’я хоста має публічно розв’язуватися в IP-адресу сервера через запис A або AAAA. Порт 80 має залишатися відкритим, оскільки ACME (automatic certificate management environment) — протокол, який використовує 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 використовує її для згенерованих посилань на вкладення та self-hosted push-сповіщень iOS. listen-http: ":2586" прив’язує сервіс до всіх інтерфейсів усередині контейнера. Це виглядає необережно, але є правильним рішенням: контейнер має власний network namespace, тому прив’язка до 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 — поточному стабільному релізі станом на November 1, 2026, — замість latest, оскільки з latest наступна команда docker compose pull завантажує поточний образ, а подальша команда docker compose up -d відтворює з ним контейнер; саме завантаження не змінює версію запущеного сервера. Зафіксовану версію все одно потрібно оновлювати. Лише October 2026 приніс десять релізів: v2.29.0 on October 7, v2.30.0 on October 12, v2.31.0 і v2.31.1 on October 16, v2.32.0 on October 18, v2.33.0 і v2.33.1 on October 23, v2.34.0 on October 24, v2.35.0 on October 30 та v2.36.0 on October 31. v2.31.0 виправляє втрату повідомлень, коли клієнт повторно підключався до того, як повідомлення потрапляли в кеш, але під час повторного підключення з since=<message ID> читає з бази даних кожне повідомлення в topic, і ntfy.sh відкотився з цієї версії. v2.31.1 усуває це навантаження за допомогою нового індексу, а v2.34.0 виправляє проблему, через яку відкликані або видалені користувачі зберігали деякі підписки. v2.35.0 виправляє обробку одночасних запитів, які визначали дійсні облікові дані як анонімні, а також обхід авторизації Matrix push gateway у SQLite, тому старіші зафіксовані версії слід оновити до v2.36.0. Порт опубліковано як 127.0.0.1:2586:2586, тому контейнер доступний лише з loopback-адреси хоста. Якщо вказати 2586:2586, Docker вставить власні правила firewall перед вашими. У результаті порт відповідатиме з інтернету, навіть якщо ufw status повідомляє, що порт закритий. Обидва підходи застосовні й до наступного контейнера: self-hosted relay RustDesk так само фіксує тег образу, але його не можна сховати за loopback, оскільки його signal і relay порти мають бути доступними з інтернету.
Якщо curl виводить Connection refused, перегляньте журнал контейнера. Помилка доступу до /var/lib/ntfy/user.db означає, що рядок user: не відповідає власнику цих каталогів. Через це процес не може створити власну базу даних і завершує роботу. Посібник з основ Docker Compose для VPS докладніше описує власників volume і політики перезапуску.
Налаштуйте 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 записує помилку upstream, з якою він зіткнувся, наприклад скидання з’єднання. Помилка сертифіката зазвичай означає, що DNS-запис неправильний або перевірка сертифіката не може дістатися сервера через порт 80 чи 443; перегляньте sudo journalctl -u caddy -n 50, щоб знайти помилку перевірки. Щоб додати інший сервіс, достатньо додати ще один блок hostname у той самий Caddyfile. Саме так, наприклад, Halcyon, відеовітрина 90-х для вашої бібліотеки 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 mount.
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 (списку контролю доступу) містить користувача, топік і дозвіл. Топік може бути точним ім’ям або шаблоном, у якому * відповідає будь-якому значенню. Тому 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, і залишаються звичайним текстом, якщо відповідності немає.
Щоб переглядати topic із термінала, передавайте його потоком:
curl -s -u admin https://ntfy.example.com/alerts/rawcurl запитує пароль. Кожне повідомлення надходить в одному рядку, а порожні рядки, які час від часу з’являються, є keepalive-повідомленнями. Відкрийте https://ntfy.example.com у браузері та ввійдіть із тим самим обліковим записом, щоб отримати вебверсію того самого потоку.
Налаштування rate limits, щоб один скрипт не перевантажив сервер
За замовчуванням кожен відвідувач отримує bucket на 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, усі клієнти вважаються одним відвідувачем, а один гучний скрипт вичерпує bucket, спільний для вашого телефона та інших серверів. Починаючи з v2.36.0, добові лічильники зберігаються в user database після перезапусків, а ліміт кожного відвідувача скидається за власним 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, ніж у вашій login shell, тому скрипт, який працює під час ручного запуску, може завершитися ще до виконання рядка з curl. У посібнику про те, чому cron-завдання не запускається описано ці проблеми із середовищем. Усюди використовуйте абсолютні шляхи та після першого запланованого запуску прочитайте файл журналу, а не покладайтеся на припущення.
Сповіщення про помилку unit systemd
Cron охоплює заплановані завдання. Для довготривалих сервісів потрібен OnFailure=, який systemd запускає щоразу, коли unit переходить у стан failed. Створіть один шаблонний unit і повторно використовуйте його для кожного сервісу на сервері. Збережіть його як /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 розгортається в повне ім’я unit, тому інстанційований unit стає ntfy-unit-failed@myapp.service.service, а %i у шаблоні передає myapp.service скрипту як перший аргумент. Завдяки цьому один шаблон можна використовувати для будь-якого unit. Перевірте його роботу за допомогою unit, який навмисно завершується з помилкою. Збережіть його як /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, а телефон має подати сигнал приблизно через секунду. Після цього видаліть тестовий unit.
Окремо зверніть увагу на одну особливість. OnFailure= запускається лише тоді, коли unit переходить у стан failed, а RestartMode=direct пропускає цей стан під час автоматичних перезапусків, тому обробник помилки також не запускається. За замовчуванням RestartMode=normal автоматичні перезапуски проходять через стан failed. StartLimitBurst і StartLimitIntervalSec визначають, коли повторні запуски буде заборонено; налаштуйте їх так, щоб цикл падінь зрештою зупинявся. Таймери є кращою заміною наведеного вище шаблону з Cron, оскільки service unit таймера підтримує такий самий OnFailure= drop-in, а у посібнику про сервіси й таймери systemd на VPS описано перетворення такого налаштування.
Підключіть моніторинг доступності до тієї самої topic
Uptime Kuma, self-hosted монітор доступності, має тип сповіщень ntfy. Відкрийте Settings, потім Notifications, потім Setup Notification, виберіть Ntfy, укажіть URL сервера https://ntfy.example.com і topic alerts, виберіть пріоритет і вставте access token robot. Надішліть тестове сповіщення перед збереженням, оскільки неправильна назва topic спричиняє помилку через grant write, який не надає доступу до нього.
Є важливе обмеження цієї схеми: монітор, запущений на тому самому VPS, не повідомить, що VPS недоступний, а ntfy не зможе доставити повідомлення про недоступність самого ntfy. Запустіть монітор на іншій машині та додайте для нього другий канал сповіщень, наприклад email, щоб контролювати сам ntfy. Тип монітора Push в Uptime Kuma закриває іншу прогалину: cron job викликає push URL після успішного виконання, а Kuma надсилає сповіщення, коли ці виклики перестають надходити. Гілка помилки спрацьовує лише тоді, коли job запущено, тому вона нічого не повідомляє про job, який взагалі не стартував.
Чи працює self-hosted ntfy на Android та iPhone?
На Android — так, без обмежень. Установіть застосунок із Google Play або F-Droid, відкрийте Settings, установіть сервер за замовчуванням `https://ntfy.example.com, додайте свій обліковий запис у розділі керування користувачами, а потім підпишіться на alerts`. Режим миттєвої доставки підтримує запущену у foreground service службу, тому повідомлення надходять навіть коли телефон перебуває в режимі doze. Постійне сповіщення, яке відображається разом із цією службою, є вимогою Android для foreground services, а не помилкою. Збірка з F-Droid взагалі не містить коду Firebase, тому всі підписки використовують режим миттєвої доставки. ntfy також може працювати як UnifiedPush distributor — відкрита заміна push-сервісу Google. Тому інші застосунки з підтримкою UnifiedPush також можуть доставляти повідомлення через ваш сервер.
В офіційному застосунку для iOS це працює з однією залежністю, яку неможливо усунути. iOS призупиняє застосунок, переведений у background, а дозволені Apple фонові режими — відтворення аудіо, отримання оновлень місцезнаходження та обробка запланованих завдань — не дають застосунку постійно очікувати на повідомлення від вашого сервера. Тому для швидкого пробудження потрібен APNs (Apple push notification service). Надсилати повідомлення до застосунку може лише постачальник із обліковими даними, авторизованими для цього застосунку. Отже, ваш сервер не може напряму звернутися до офіційного застосунку. ntfy вирішує це за допомогою relay: ваш сервер надсилає до ntfy.sh `poll_request` з ідентифікатором повідомлення, а ntfy.sh передає його через Firebase і APNs, щоб пробудити застосунок. Після цього застосунок отримує текст повідомлення з вашого сервера.
upstream-base-url: "https://ntfy.sh"Чітко врахуйте, які дані передаються через relay. Вміст повідомлення залишається на вашому сервері, але факт надходження повідомлення та його ID проходять через інфраструктуру, якою ви не керуєте. Без цього налаштування сповіщення на iPhone із self-hosted сервера все одно зрештою надходять, але документація ntfy попереджає, що затримка може становити кілька годин, оскільки ніщо не пробуджує застосунок своєчасно. Щоб використовувати native iOS застосунок без relay ntfy.sh, самостійно зберіть і опублікуйте застосунок за допомогою власного Apple developer account і власних ключів APNs. Це передбачає щорічну плату та повторну збірку для кожного оновлення. Інший варіант — PWA ntfy на iOS 16.4 або новішої версії: додайте його на home screen і налаштуйте Web Push на своєму сервері. Це усуває relay ntfy.sh, але все одно використовує push-інфраструктуру браузера. Якщо relay неприйнятний для вашого сценарію, використовуйте сповіщення на Android або в desktop web app.
Резервні копії, оновлення та фіксація версії образу
Два шляхи неможливо відтворити: /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 містить недавні повідомлення — за умови cache-duration, наведеного вище, за 12 годин — а також усі повідомлення, заплановані на пізніше доставлення. Вони зберігаються до 12 годин після доставки. Якщо ви не плануєте повідомлення заздалегідь, втрата цього файлу не призведе до втрати даних, які потрібно захищати. Оновлення полягає в редагуванні тегу в compose-файлі, завантаженні образу та відтворенні контейнера.
sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/healthСпочатку прочитайте release notes. Бази даних SQLite мігрують під час запуску, тому повернення до старішого тегу після зміни схеми небезпечне. Наприклад, v2.31.1 перенесла кеш повідомлень до schema version 17, а в примітках до оновлення зазначено, що для downgrade до v2.31.0 або старішої версії цю версію потрібно вручну повернути до 16. Оновлення до v2.36.0 один раз скидає поточні добові лічильники всіх користувачів. Зберігайте щойно створену резервну копію, доки нова версія не пропрацює один день. У примітках також зазначені зміни поведінки. Починаючи з v2.31.0, клієнт, який повторно підключається з since=<message ID>, також отримує повідомлення, опубліковані в ту саму секунду, тому може побачити дубль. Застосунки ntfy та web app відкидають дублікати за ID повідомлення, але власний скрипт, який повторно відтворює topic, має робити те саме. Кожен сервіс на сервері має власний короткий список шляхів, які неможливо відтворити. Порівняння PhotoPrism та Immich визначає такий список і команди резервного копіювання для фототеки на VPS такого самого типу.
Gotify і Apprise
Gotify — компактніший варіант: один бінарний файл із вебінтерфейсом і Android-застосунок. Повідомлення впорядковуються за застосунками. Це зручно для приватного сервера, де Android є єдиною цільовою платформою. Apprise — це Python-бібліотека та інструмент командного рядка. Також доступний окремий Apprise API server. Він надсилає одне повідомлення до понад ста сервісів, зокрема ntfy. Це зручно для скрипта, який має одночасно надсилати повідомлення в кілька місць. ntfy надає server, 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 із self-hosted сервером ntfy?
Вони працюють через relay під час використання офіційного застосунку iOS. Щоб призупинений застосунок iPhone швидко прокинувся, сповіщення має надійти через APNs (Apple push notification service), а надсилання до офіційного застосунку потребує push-облікових даних його видавця. Тому ntfy пересилає до ntfy.sh poll_request, що містить ID повідомлення, а ntfy.sh передає його на пристрій. Установіть upstream-base-url: "https://ntfy.sh" у server.yml і перезапустіть контейнер. Сам текст повідомлення й далі отримується з вашого сервера. Без цього параметра сповіщення iOS усе одно зрештою надходять, але документація ntfy попереджає, що затримка може сягати кількох годин. PWA є іншим варіантом для iOS 16.4 або новішої версії, якщо на сервері налаштовано Web Push.
Чому сповіщення ntfy від мого cron job так і не надійшло?
Спочатку виконайте рядок curl окремо, щоб перевірити правильність токена й топіка. Якщо вручну все працює, але з cron — ні, помилка виникає до надсилання сповіщення: cron запускає завдання з мінімальним середовищем і коротким PATH, тому скрипт, який викликає команду за коротким ім’ям, може завершитися до виконання рядка curl. Використовуйте абсолютні шляхи, перенаправте вивід завдання до файлу журналу та прочитайте цей файл після наступного запуску. Відповідь 429 замість доставки означає, що ліміт відхилив запит. Зазвичай скрипт повторює спроби надто швидко, але користувач, який вичерпав денну квоту, наприклад установлений вище ліміт повідомлень, так само отримує відмову навіть для одного запиту.
Чи варто відкривати ntfy у публічному інтернеті?
Застосункам на телефонах потрібно підключатися до нього через мобільні мережі, тому публічна HTTPS-адреса з auth-default-access: "deny-all" і ACL для окремих топіків є стандартною конфігурацією. Вона безпечна, якщо жоден топік не доступний для читання через everyone. Екземпляр, доступний лише через VPN, є доцільним, коли кожен підписник — це машина під вашим контролем. Для телефонів такий варіант незручний, оскільки застосунок отримує повідомлення лише під час активного VPN-тунелю, а сповіщення накопичуються до повторного підключення телефона.