Ntfy
Свой сервер уведомлений, который принимает обычный curl и превращает его в пуш на телефон. Без Pushover, без Pushbullet, без Firebase. Приемник алертов для Uptime Kuma, Beszel и любых скриптов. Разбираем версию 2.29.0; замеры и скриншоты сняты на версии 2.28.0, 23 сентября 2026.
Вердикт
- нужен один приемник алертов на весь стек: Uptime Kuma, Beszel, cron, CI
- хочется слать пуш простым curl-ом, а текст алертов не выпускать за свой контур
- нужен пуш на Android без сервисов Google - через UnifiedPush
- нужен инцидент-менеджмент с эскалацией и дежурствами - это PagerDuty или Opsgenie
- нужны мгновенные пуши на iPhone при полной изоляции от внешних сервисов
- нужны пуши конечным пользователям вашего мобильного приложения - это FCM
Что это и какую задачу решает
Ntfy - сервер уведомлений, работающий по модели pub-sub поверх обычного HTTP. Вы придумываете имя топика, публикуете в него запросом curl -d "текст" https://домен/топик и подписываетесь с любого устройства.
Ни регистрации, ни SDK, ни токенов приложения: топик создается сам, в момент первой публикации. Подписаться можно из веб-интерфейса, мобильных приложений, командной строки или по SSE и WebSocket.
Задача, которую он закрывает, звучит просто: чтобы сервер, скрипт или система мониторинга достучались до человека. Это личный и командный канал алертов, а не рассылка конечным пользователям.
Что изменилось в 2.29.0
Релиз от 7 октября 2026 обновляет опубликованную здесь версию 2.28.0. Установка и видимый интерфейс прежние.
В 2.29.0 исправлены запись кэша при пакетной обработке и штатная остановка сервера. Наш конфиг пакетную запись не включает: эти изменения не означают, что старые замеры памяти или скорости стали лучше.
Для отложенного сообщения можно передать часовой пояс через X-Timezone: Europe/Moscow или указать время в формате RFC 3339 со смещением +03:00. При публикации через веб-интерфейс сервер теперь получает зону браузера.
Также исправлены гонка при обновлении токена, распознавание Markdown с параметрами Content-Type и шаблон Alertmanager. Улучшения PostgreSQL не меняют наш стек с SQLite; экспериментальные параметры кластера пока не дают работающей кластеризации.
Ограничения заголовков и тегов из 2.28.0 сохранились: длинный текст переносите в тело сообщения.
Причина. С версии 2.28.0 заголовок ограничен 1 КБ, а все теги вместе - 512 байтами. Код 40058 означает то же самое про теги.
Решение. Длинный текст переносите в тело сообщения, в заголовке оставляйте короткую суть. Проверено на нашем стенде: заголовок в 1100 символов отбивается, обычный проходит.
Чем отличается от Pushover, Pushbullet и Gotify
Сравнение по тому, что реально влияет на выбор, включая деньги.
| Параметр | ntfy self-hosted | Платные сервисы |
|---|---|---|
| Где текст алертов | на вашем сервере | на чужом |
| Цена для одного | сервер от 500 руб/мес | Pushover - 4.99 доллара разово |
| Цена для команды из десяти | те же 500 руб/мес на всех | Pushover Teams - 50 долларов в месяц |
| Лимиты на сообщения | только ваш диск и канал | 250 в день у бесплатного ntfy.sh |
| Публикация | curl -d в топик | свой API и токены |
| Пуш без сервисов Google | да, UnifiedPush на Android | обычно через Firebase |
Одному человеку self-host не выгоден: Pushover за 4.99 доллара навсегда дешевле любого сервера, и мы это признаем. Выигрыш начинается на команде и на данных.
Против Gotify - ближайшего self-hosted аналога - ntfy берет готовыми приложениями под обе платформы и публикацией без регистрации приложений. Gotify проще в первой настройке, но это другой разговор.
Тех-стек и архитектура
Ntfy написан на Go и представляет собой один статически слинкованный бинарь: сервер, REST-эндпоинт публикации и веб-интерфейс в одном процессе. Состояние лежит в SQLite - кеш сообщений и отдельная база пользователей.
Отдельную СУБД поднимать не нужно. PostgreSQL поддерживается и с версии 2.27.0 перестал быть экспериментальным, но для одиночной установки он избыточен.
На стенде 2.28.0 мы развернули стек в два контейнера: binwiederhier/ntfy:v2.28.0 слушает только localhost хоста, а caddy:2 перед ним выпускает сертификат Let's Encrypt и отдает сервис по HTTPS. Наружу торчат только порты 80 и 443.
Пуши на телефон: где self-hosting неполный
Это самое важное место разбора, и в большинстве инструкций его пропускают.
На Android цепочка короткая: приложение держит соединение с вашим сервером напрямую, а через UnifiedPush работает даже на телефоне без сервисов Google. Ничего чужого в цепочке нет.
На iPhone иначе. iOS не дает приложению держать фоновое соединение, поэтому мгновенный пуш без центрального сервера технически невозможен. Ваш сервер обязан переслать запрос на ntfy.sh, а тот протолкнет его через Apple.
Включается это параметром upstream-base-url. Наружу при этом уходит хеш адреса топика и идентификатор опроса - не текст сообщения: его приложение забирает уже с вашего сервера.
Выбор, которого не избежать. Не задать upstream-base-url - уведомления на iPhone будут приходить с задержкой до нескольких часов, о чем документация прямо предупреждает. Задать - получить мгновенную доставку ценой метаданных, уходящих на чужой сервер. Третьего варианта нет, и знать об этом лучше до внедрения, а не после.
Минимальная конфигурация
Требований к железу апстрим не публикует, и это соответствует природе продукта.
| Официальный минимум | не заявлен, один Go-бинарь |
| Реально в простое, ntfy | 12.3 MiB |
| Реально в простое, стек с Caddy | 24.4 MiB |
| Вся машина вместе с ОС | 500 МБ из 3915 |
| Рекомендуем тариф | CPU2-RAM4-DISK50 |
Тариф берется не под ntfy. Продукт упирается не в ресурсы, а в нижнюю границу сетки: по памяти CPU2-RAM4-DISK50 взят с запасом в сотни раз. Реально растет только диск - кеш сообщений и вложения, у обоих настраиваемый срок хранения.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий ntfy на своем домене, валидный TLS и файл с доступами.
Рекомендуемая конфигурация: CPU2-RAM4-DISK50
Развертывание на Fatmetal
Cloud Server, Ubuntu 24.04, Docker, ntfy за Caddy с автоматическим TLS.
Создать сервер
Тариф CPU2-RAM4-DISK50, Ubuntu 24.04. Домен направьте на адрес машины заранее - Caddy выпустит сертификат сам.
Подготовить конфиг и compose
Ntfy слушает только localhost хоста. Внутри контейнера
listen-httpдолжен быть:2586, а не127.0.0.1:2586, иначе проброс порта до сервиса не достучится.mkdir -p /opt/ntfy/etc /opt/ntfy/cache /opt/ntfy/lib && cd /opt/ntfy cat > etc/server.yml <<'YML' base-url: "https://ВАШ-ДОМЕН" listen-http: ":2586" cache-file: "/var/cache/ntfy/cache.db" auth-file: "/var/lib/ntfy/user.db" auth-default-access: "read-write" behind-proxy: true enable-login: true YML cat > docker-compose.yml <<'YML' name: ntfy services: ntfy: image: binwiederhier/ntfy:v2.29.0 container_name: ntfy command: serve restart: unless-stopped volumes: - ./etc/server.yml:/etc/ntfy/server.yml - ./cache:/var/cache/ntfy - ./lib:/var/lib/ntfy ports: ["127.0.0.1:2586:2586"] YMLПоднять ntfy и Caddy
docker compose pull && docker compose up -d docker run -d --name nt-caddy --restart unless-stopped --network host \ -v /opt/caddy/Caddyfile:/etc/caddy/Caddyfile -v caddy_data:/data caddy:2На нашем стенде сертификат выпустился за 20 секунд после старта Caddy. Откройте домен в браузере - увидите веб-интерфейс.
Опубликовать первое уведомление
Придумайте имя топика и шлите в него curl-ом. Подпишитесь на топик в веб-интерфейсе или мобильном приложении - уведомление придет туда.
curl -H "Title: Деплой прошел" -H "Priority: 4" -H "Tags: rocket" \ -d "backend v1.4.2 на проде" https://ВАШ-ДОМЕН/server-alerts
Что измерили после запуска
Цифры с живого стенда: docker stats тремя срезами, тайминги, отклик.
| RAM: ntfy | 12.3 MiB |
| RAM: caddy | 12.1 MiB |
| RAM: оба контейнера | 24.4 MiB |
| Образ ntfy / caddy | 120 МБ / 88.8 МБ |
| Отклик: health локально | 1.9 мс |
| Отклик: публикация локально | 11 мс |
| Холодный перезапуск до готовности | 983 мс |
| Вся установка с чистой машины | ~7 минут |
Из семи минут установки шесть занимает скачивание образов - сам продукт стартует за секунду. Публикация медленнее health в пять раз, потому что пишет сообщение в SQLite.
Главное: 24.4 MiB на весь стек - это самый легкий продукт из всех, что мы мерили. Холодный перезапуск укладывается в секунду, данные после него на месте.
Проверено на версии 2.28.0, сентябрь 2026, тариф CPU2-RAM4-DISK50. На других версиях результаты могут отличаться.
Где может сломаться
Все перечисленное мы поймали на своем стенде, а не вычитали.
Топики по умолчанию открыты. При auth-default-access: read-write имя топика и есть пароль: кто его знает, тот читает и пишет. Как закрыть - ниже, в разделе про безопасность.
base-url и behind-proxy обязательны за прокси. Без них ломаются ссылки и подписка из приложений, а ограничение частоты считает всех клиентов за одного - по адресу прокси.
Причина. Внутри контейнера listen-http задан как 127.0.0.1:2586. Loopback контейнера - это не loopback хоста, проброс порта до сервиса не достает, прокси отдает 502.
Решение. Поставьте listen-http: ":2586" и перезапустите контейнер.
Причина. Вы поправили server.yml и выполнили docker compose up -d. Compose видит, что описание сервиса не менялось, и контейнер не трогает - конфиг примонтирован файлом. Настройка не применилась, но выглядит примененной.
Решение. После правки server.yml всегда docker restart ntfy. Особенно важно, когда вы закрываете доступ: иначе сервер остается открытым, а вы считаете, что закрыли его.
Письмо может не уйти при коде 200. Публикация с заголовком Email: возвращает 200, даже если отправка письма провалилась. Результат виден только в журнале контейнера. Отключить проверку TLS-сертификата почтового сервера в ntfy нельзя - с самоподписанным сертификатом придется добавлять его в доверенные.
Безопасность и обновления
Обновление - подтянуть свежий образ и пересоздать контейнер:
docker compose pull && docker compose up -d
Закрыть открытые топики - завести пользователя, переключить доступ по умолчанию и перезапустить контейнер явно:
docker exec -it ntfy ntfy user add --role=admin admin
# в etc/server.yml: auth-default-access: "deny-all"
docker restart ntfy
Проверить, что получилось, стоит сразу: анонимный запрос к топику должен отдавать 403, а запрос с учетными данными - 200. На нашем стенде после такого перезапуска так и вышло.
Что закрыть перед продом: сервис только за HTTPS и не наружу напрямую, base-url и behind-proxy прописаны, приватные топики закрыты через ACL, заведен пользователь с сильным паролем, настроен бэкап каталогов с SQLite.
Связь с другими стеками
Ntfy отвечает на вопрос «как доставить алерт человеку». Кто этот алерт породит - решают соседние стеки:
- Uptime Kuma - аптайм и сертификаты снаружи; шлет в ntfy, когда сервис упал.
- Beszel - метрики серверов и контейнеров изнутри; сообщает о перегрузе и нехватке диска.
- Wazuh - аудит безопасности; ntfy становится каналом доставки его событий.
- Caddy - обратный прокси с автоматическим TLS, в этом стеке уже используется.
Когда это НЕ ваш выбор
Нужен инцидент-менеджмент
Эскалация, дежурства и разбор инцидентов - не про ntfy. Он доставляет уведомление, но не ведет инцидент. Это к PagerDuty или Opsgenie.
Команда сидит на iPhone и не готова к компромиссу
Либо задержка до нескольких часов, либо метаданные через ntfy.sh. Если не подходит ни то ни другое, продукт задачу не закроет.
Нужны пуши пользователям вашего приложения
Ntfy - канал для своих серверов и своей команды. Для уведомлений клиентам мобильного продукта нужны FCM или OneSignal.
Частые вопросы
Есть ли мобильные приложения?
Да, для Android и iOS, плюс сборка в F-Droid и UnifiedPush для телефонов без сервисов Google.
Как закрыть открытые топики?
Завести пользователя через ntfy user add, поставить auth-default-access: deny-all и обязательно выполнить docker restart ntfy.
Хватит ли 2 ГБ памяти?
С огромным запасом. Весь стек в простое занимает 24.4 MiB, и упирается он в размер диска под историю, а не в память.
Можно слать из Zabbix, Grafana или скрипта?
Да. Любой скрипт шлет curl-ом, а Uptime Kuma, Beszel, Grafana и вебхуки умеют слать в ntfy напрямую.
Что бэкапить?
Два файла SQLite - кеш сообщений и базу пользователей - плюс каталог вложений. Это десятки килобайт на старте.
Нужен ли Firebase?
На Android - нет, доставка идет напрямую или через UnifiedPush. На iPhone мгновенная доставка требует пересылки запроса через ntfy.sh.
Какая лицензия?
Apache-2.0 и GPL-2.0 одновременно. Использование свободное, включая коммерческое.
Итог
Ntfy - самый легкий способ завести свой приемник алертов: 24.4 MiB на весь стек, перезапуск меньше секунды, публикация обычным curl-ом. Версия 2.28.0 стала легче предыдущей, но ввела лимиты на заголовки и теги - старые скрипты стоит проверить. Одному человеку self-host не про экономию, а про данные и отсутствие лимитов; команде от пяти человек он дешевле любого командного тарифа. Главное, что стоит решить до внедрения: как вы относитесь к компромиссу с пушами на iPhone.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.