ntfy
ntfy - сервер уведомлений для доставки алертов мониторинга, бэкапов и скриптов на телефон. Развернули 2.37.2 на Fatmetal Cloud Server, замерили потребление и проверили вход, отправку и получение сообщения в браузере.
Вердикт
- Администратору, который собирает результаты бэкапов, cron и CI в одном приемнике
- Владельцу домашнего сервера, которому нужны отдельные темы для дисков, обновлений и аварий
- Дежурной службе, которая выбирает систему назначения ответственных и эскалации инцидентов
- Тем, кому нужен мгновенный push на iPhone без внешних сервисов
- Разработчику, который ищет готовую платформу рассылок пользователям своего приложения
Что такое ntfy и зачем он нужен
События от разных источников собраны по темам, история хранится на вашем сервере. Штатному iOS-клиенту для своевременной доставки нужен внешний upstream; собственный сервер эту зависимость не снимает.
Ночной бэкап завершился, сборка упала, сертификат скоро истечет. Вместо трех разных способов доставки скрипты отправляют обычный HTTP-запрос на один адрес, а вы подписываетесь на нужные темы.
Тема - именованный канал вроде prod-alerts. Сообщение появляется у подписчиков и остается в истории на заданное время; перезагрузка вкладки не требует повторной отправки.
Система разделяет отправителя и получателя. Скрипт знает адрес темы и свои права; получатель выбирает темы в интерфейсе. Уведомления можно читать отдельно от чата, в котором обсуждают работу.
Что изменилось с прошлого разбора
Предыдущая статья разбирала 2.30.0. В 2.37.2 сохранился прежний одиночный стек, но обновление затрагивает доступ, интерфейс и формат баз.
| Изменение | Что получает пользователь |
|---|---|
| 2.31.1: предупреждения и боковая панель | Предупреждение об уведомлениях можно закрыть; выбор сохраняется после перезагрузки |
| 2.33.0-2.35.0: исправления безопасности | Закрыты Range DoS, неполный отзыв подписок и обход публикации через Matrix/SQLite; подробности исправлений |
| 2.36.0: экран аккаунта | Видны пояснение статистики и время следующего сброса суточных лимитов |
| Миграции SQLite | Возврат к 2.30.0 требует старой копии данных вместе со старым образом |
Закрепленный тег меняем с v2.30.0 на v2.37.2, чтобы получить эти исправления. Один docker compose pull при прежнем теге новую версию не установит.
Чем отличается от Pushover и облака ntfy
Свой приемник выбирают ради управления темами, доступом и хранением событий. Цена отдельного сервера не делает его автоматически выгоднее личной лицензии готового приложения.
| Продукт | Цена | За что платите |
|---|---|---|
| ntfy на своем сервере | Софт бесплатно; сервер от 500 руб/мес | Хостинг в РФ, свои настройки и самостоятельное обслуживание |
| ntfy.sh Free / Supporter | Бесплатно / $6 в месяц | 250 / 2500 сообщений в сутки; размещение обслуживает вендор |
| Pushover Individual | $4.99 разово за платформу | Личная лицензия; отдельный VPS не нужен |
| Pushover Teams | $5 за пользователя в месяц | Централизованное управление командой |
Цены сверены 8 ноября 2026 по тарифам ntfy и прайсу Pushover. У собственного сервера отдельно остается время на обновления и копии.
Для российского читателя свой VPS дает оплату хостинга в рублях. Веб-интерфейс ntfy поддерживает русский язык; новые пояснения аккаунта и отдельные настройки пока переведены частично.
Как устроены сервер и хранилище
В одном процессе Go работают HTTP API и веб-интерфейс. SQLite хранит сообщения и учетные записи в отдельных файлах; вложения лежат рядом с кешем сообщений.
Контейнер ntfy принимает соединения только через локальный порт сервера. Caddy стоит перед ним, выпускает сертификат и передает запросы браузера, включая постоянное соединение для новых сообщений.
Снаружи нужны порты 80 и 443, для администрирования - SSH. Порт приложения 2586 наружу не публикуется. PostgreSQL, Redis и отдельная очередь для этого варианта не нужны.
Какой сервер выбрать
Для одиночного приемника выбираем CPU2-RAM4-DISK50: 2 vCPU, 4 ГБ памяти и 50 ГБ диска. На нем проверен весь путь с защищенными темами и вложением.
Здесь память не определяет стоимость сервера. Весь работающий сервер вместе с ОС занимал 519 МиБ; тариф оставляет запас для обслуживания системы и хранения событий.
Следите прежде всего за сроком хранения и размером файлов. В конфигурации ниже сообщения сохраняются 12 часов, вложения - 3 часа по умолчанию; ntfy не заменяет архив бэкапов.
Практический выбор. Сохраняйте сообщения о результате резервного копирования, а не сами архивы. Тогда уведомления не конкурируют с резервными копиями за свободное место на сервере.
Создайте сервер с Ubuntu 24.04 LTS. Направьте A-запись своего домена на его публичный IPv4, откройте 80/443 и подключитесь по SSH; дальнейшие команды выполняйте от root через sudo -i.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe от 585 ₽/мес
Развертывание на Fatmetal Cloud Server
Установите Docker из официального репозитория
Docker и Compose установились за 46 секунд.
apt-get update && apt-get install -y ca-certificates curl openssl install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable' > /etc/apt/sources.list.d/docker.list apt-get update && apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginЗакройте анонимный доступ и включите хранение
Замените
ваш-домен;deny-allзакрывает доступ анонимам.mkdir -p /opt/ntfy/{etc,cache,lib} && cd /opt/ntfy cat > etc/server.yml <<'YML' base-url: "https://ваш-домен" listen-http: ":2586" cache-file: "/var/cache/ntfy/cache.db" cache-duration: "12h" auth-file: "/var/lib/ntfy/user.db" auth-default-access: "deny-all" attachment-cache-dir: "/var/cache/ntfy/attachments" behind-proxy: true enable-login: true enable-signup: false YMLЗакрепите образ и сохраните данные вне контейнера
Тег закреплен; базы переживают пересоздание контейнера.
cat > docker-compose.yml <<'YML' name: ntfy services: ntfy: image: binwiederhier/ntfy:v2.37.2 container_name: ntfy command: serve restart: unless-stopped volumes: - ./etc/server.yml:/etc/ntfy/server.yml:ro - ./cache:/var/cache/ntfy - ./lib:/var/lib/ntfy ports: ["127.0.0.1:2586:2586"] YML docker compose pull && docker compose up -dСоздайте администратора
Пароль хранится в файле с правами root.
ADMIN_PASSWORD=$(openssl rand -hex 24) docker exec -e NTFY_PASSWORD="$ADMIN_PASSWORD" ntfy ntfy user add --role=admin admin umask 077 printf 'URL: https://ваш-домен\nLogin: admin\nPassword: %s\n' "$ADMIN_PASSWORD" > /root/ntfy-credentials.txtПоднимите HTTPS перед приложением
Создайте конфиг до контейнера; Caddy выпустит сертификат.
mkdir -p /opt/caddy cat > /opt/caddy/Caddyfile <<'CADDY' ваш-домен { reverse_proxy 127.0.0.1:2586 } CADDY docker run -d --name nt-caddy --restart unless-stopped --network host \ -v /opt/caddy/Caddyfile:/etc/caddy/Caddyfile:ro \ -v caddy_data:/data -v caddy_config:/config caddy:2.11.9
Проверьте готовность: ожидается поле "healthy":true. Если сертификат еще выпускается, посмотрите docker logs --tail 30 nt-caddy и повторите запрос.
curl -fsS https://ваш-домен/v1/health
Войдите, подпишитесь и отправьте сообщение
Прочитайте sudo cat /root/ntfy-credentials.txt, откройте указанный HTTPS-адрес и нажмите «Войти». Введите логин и пароль из файла; переключите язык в настройках на русский.
Нажмите «Подписаться на тему», оставьте свой сервер и введите prod-alerts латинскими буквами. Откройте тему, нажмите кнопку публикации и отправьте текст «Проверка бэкапа завершена».
Сообщение появится в списке. Откройте эту же тему во второй авторизованной вкладке: новая публикация приходит без перезагрузки; после обновления страницы остается история.
curl -u admin -H 'Title: Backup complete' -H 'Priority: 4' \
-d 'Резервная копия создана' https://ваш-домен/prod-alerts
Для скрипта это тот же адрес: curl -u admin запросит пароль. Для автоматической отправки создайте отдельного пользователя с правами только на нужную тему, как показано ниже.
Сколько ресурсов занимает ntfy 2.37.2
Стенд работал на CPU2-RAM4-DISK50 с Ubuntu 24.04.4 LTS. Два контейнера занимали в простое 24,2 МиБ оперативной памяти, из них 13,1 МиБ приходилось на ntfy.
Память контейнеров учтена по полю anon в cgroup - счетчиках ресурсов Linux. Память ОС и файловый кеш в эту цифру не входят.
| Пик RAM при 50 сообщениях и вложении 5 МиБ | 27,8 МиБ у двух контейнеров |
| Образы ntfy и Caddy на диске | 216 МБ по счетчику Docker |
| Скачивание двух образов | 8 секунд |
| Перезапуск до ответа HTTPS health | 0,75 секунды с готовыми данными и сертификатом |
| HTTPS health снаружи | 49 мс |
| Публикация с токеном / паролем снаружи | 64 / 195 мс |
| Каталог приложения после сообщений и файла | 5,2 МиБ |
Пароль проверяется при каждом запросе, поэтому частая отправка с ним дороже по CPU. Для постоянного отправителя используйте токен; его можно отозвать отдельно от пароля учетной записи.
В истории сохранились все 50 сообщений и запись о вложении, скачанный файл совпал с отправленным. Этот сценарий показывает расход обычной отправки, а не число одновременных пользователей.
Проверено на версии v2.37.2, 8 ноября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. При deny-all анонимный запрос запрещен. У обычного пользователя дополнительно должны быть права на тему.
Решение. Войдите в интерфейс или передайте учетные данные через curl -u admin; права проверьте командой docker exec ntfy ntfy access.
Причина. Заголовок превышает 1 КиБ. Для совокупности тегов предел составляет 512 байт; русский текст расходует несколько байтов на символ.
Решение. Оставьте короткий заголовок, подробности передайте телом запроса:
curl -u admin -d @report.txt https://ваш-домен/prod-alertsПричина. Старый ntfy 2.30.0 открывает базу после миграции новой версией. Смена тега обратно не меняет формат файлов.
Решение. Восстановите согласованную копию каталогов cache и lib вместе с прежним compose-файлом по инструкции отката ниже.
Как разделить доступ к темам
Администратор видит все темы. Для отправителя бэкапов создайте отдельную учетную запись и разрешите только запись в prod-alerts; чтение чужих событий ему не требуется.
docker exec -it ntfy ntfy user add backup
docker exec ntfy ntfy access backup prod-alerts wo
Первая команда предложит задать пароль. Для отдельного читателя аналогично выдайте ro, для чтения и записи - rw. Список правил показывает docker exec ntfy ntfy access.
Создайте токен для пользователя командой docker exec ntfy ntfy token add backup. Сохраните выданный секрет в защищенном файле настроек отправителя, а не в репозитории.
curl -H 'Authorization: Bearer ваш-токен' \
-d 'Бэкап завершен' https://ваш-домен/prod-alerts
Для удаления пользователя выполните docker exec ntfy ntfy user del backup. В 2.37.2 удаление прервало обе его открытые подписки, а подписка другого пользователя продолжила получать сообщения.
Не публикуйте журналы сервера целиком: ошибки WebSocket могут включать параметры авторизации в URL. Перед передачей логов удаляйте значения auth и токенов.
Уязвимости прошлых версий
Инструкция устанавливает исправленную 2.37.2. Если у вас осталась 2.30.0 или более ранняя версия, сделайте копию данных и обновитесь по следующему разделу.
| Идентификатор и серьезность | Затронуто | Исправлено | Что это значит |
|---|---|---|---|
| CVE-2026-39087, Critical | ntfy до 2.22.0 | 2.22.0 | Исполнение кода через parseActions; исторический дефект, уже закрытый в 2.30.0 |
| CVE-2026-78667, High | Go до 1.26.9 / ветка 1.27 до 1.27.2; 2.30.0 объявляет Go 1.27.1 | Первый исправленный ntfy 2.33.0 | Range-запросы к файловому HTTP-серверу могут вызвать отказ в обслуживании |
| Без опубликованных CVE и severity | Старые версии; 2.30.0 затронута | 2.34.0 | Отзыв доступа отключал только первую подписку пользователя, оставляя другие открытыми |
| Без опубликованных CVE и severity | Старые версии с SQLite; 2.30.0 затронута | 2.35.0 | Невалидный Matrix push key позволял записать сообщение в защищенную тему |
Также в 2.33.0 убрано многократное воспроизведение кеша через повтор темы в подписке, а в 2.35.0 исправлена гонка авторизации запросов одного IP. Описание - в релизах вендора.
Как обновиться с 2.30.0 и сохранить возможность отката
Команды ниже рассчитаны на установку с администратором. Если раньше использовали открытые темы, сначала создайте администратора по шагу установки и замените в настройках auth-default-access на deny-all.
Перед переходом остановите ntfy, чтобы обе базы попали в согласованную копию. Сохраните конфигурацию, пользователей, сообщения и вложения; Caddy продолжит работать во время остановки приложения.
cd /opt/ntfy
umask 077
docker compose stop ntfy
tar -czf /root/ntfy-before-2.37.2.tgz etc docker-compose.yml cache lib
sed -i 's|binwiederhier/ntfy:v2.30.0|binwiederhier/ntfy:v2.37.2|' docker-compose.yml
docker compose pull && docker compose up -d
Проверьте docker exec ntfy ntfy --version, вход прежним паролем, старое сообщение и новую публикацию. Изменяя base-url, проверьте весь файл настроек: новая версия повторно валидирует связанную конфигурацию.
При переходе кеш мигрировал со схемы 16 на 17, база пользователей - с 9 на 11. Пароль, права, токен и старое сообщение сохранились.
cd /opt/ntfy
docker compose stop ntfy
mv cache cache.after-update
mv lib lib.after-update
tar -xzf /root/ntfy-before-2.37.2.tgz
docker compose up -d
Это откат вместе с прежним compose-файлом и тегом. Он вернет состояние на момент копии; сообщения и изменения после нее останутся только в отложенных каталогах. Скопируйте архив за пределы сервера.
Как использовать рядом с другими инструментами
- Uptime Kuma - проверяет доступность сервисов. ntfy служит получателем событий; настройте отдельную тему для аварий, чтобы не смешивать их с успешными заданиями.
- Beszel - показывает состояние серверов. Разделите темы по назначению: ресурсы, резервные копии и результаты развертывания.
- Gotify - соседний сервер уведомлений. Сравнивайте способ организации отправителей и получателей, если уже строите доступ вокруг учетных записей и приложений.
Когда это НЕ ваш выбор
Нужна подтвержденная реакция дежурного
ntfy передает сообщения и хранит историю. Назначение ответственного, расписание дежурств и эскалации требуют системы управления инцидентами; само появление события в теме не подтверждает, что человек его прочел.
Нужен полностью автономный мгновенный push на iPhone
Штатному iOS-клиенту для своевременного push нужен внешний upstream ntfy.sh и цепочка FCM/APNS; браузерные системные уведомления тоже зависят от разрешений и провайдера браузера. Свой сервер не устраняет эти зависимости.
Нужны только несколько личных уведомлений
Разовая лицензия Pushover или бесплатное облако могут обойтись дешевле отдельного VPS. Свой приемник имеет смысл, когда вам нужны именно собственное хранение, темы и правила доступа.
Частые вопросы
Нужно заранее создавать каждую тему?
Нет. Подпишитесь на имя темы в интерфейсе и отправьте сообщение по тому же адресу. Для обычного пользователя сначала задайте правило доступа к этому имени.
Где найти настройки и базы?
В этой установке все лежит в /opt/ntfy: настройки в etc/server.yml, сообщения в cache/cache.db, пользователи в lib/user.db.
Как посмотреть причину ошибки запуска?
Выполните docker logs --tail 50 ntfy. Для ошибок сертификата отдельно смотрите журнал контейнера nt-caddy.
Как применить правки server.yml?
Выполните docker restart ntfy. Команда docker compose up -d без пересоздания контейнера файл настроек не перечитывает.
Как сменить пароль администратора?
Команда ниже запросит новый пароль. Обновите сохраненный файл доступов и настройки отправителей.
docker exec -it ntfy ntfy user change-pass admin
Можно использовать ntfy в компании бесплатно?
Сервер распространяется под двойной лицензией Apache-2.0 OR GPL-2.0. Плата за учетные записи в этом варианте не требуется; сервер и его обслуживание оплачиваются отдельно.
Итог
ntfy подходит, когда скриптам нужен общий приемник событий, а человеку - подписка на выбранные темы. Начните с одной закрытой темы, проверьте сообщение во второй вкладке и только потом подключайте рабочие источники.
Рекомендуемая конфигурация для установки:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe
Не хотите устанавливать вручную?
Запустите ntfy на этой конфигурации автоматически - от 585 ₽/мес.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.