Как развернуть свой сервер ntfy через Docker Compose
Узнайте, как поднять собственный сервер ntfy на VPS с поддержкой TLS. Настройте аутентификацию, ACL и интеграцию с cron или systemd для получения уведомлений об ошибках системы.
Зачем нужен self-hosted сервер ntfy
Self-hosted сервер ntfy преобразует HTTP POST-запрос в push-уведомление на вашем телефоне. Вы публикуете сообщение с помощью curl, и оно доставляется в приложение для Android, iOS, вкладку браузера или любое другое устройство, способное поддерживать открытое HTTP-соединение. Вам не нужно устанавливать клиентские библиотеки или запускать брокер сообщений.
В ntfy адресация сообщений происходит по topic (теме). Тема — это имя в пути URL, например https://ntfy.example.com/alerts, которое создается в момент первой публикации сообщения. В стандартной конфигурации любой, кто знает это имя, может читать и записывать сообщения в тему, поэтому в документации проекта имя темы сравнивается с паролем. Такая модель подходит для публичного сервиса ntfy.sh. Она не подходит для сервера, через который передаются уведомления об ошибках резервного копирования, поэтому в данном руководстве мы включим аутентификацию до отправки первого сообщения.
Что необходимо перед началом работы
Вам потребуется VPS с установленной ОС Ubuntu 24.04 или Debian 13, Docker Engine с плагином Compose, доменное имя и небольшой объем оперативной памяти. Создайте DNS-запись типа A, указывающую 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-образе отсутствует конфигурационный файл, поэтому его необходимо создать самостоятельно. Все последующие команды в этом руководстве используют его для работы. Сначала определите идентификатор пользователя (UID) и идентификатор группы (GID), от имени которых будет запущен контейнер.
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 использует его для генерации ссылок на вложения и работы push-уведомлений iOS при self-hosted установке. listen-http: ":2586" привязывается ко всем интерфейсам внутри контейнера, что выглядит небезопасно, но является верным решением: у контейнера собственное сетевое пространство имен, поэтому привязка к 127.0.0.1 сделала бы порт недоступным с хоста, и опубликованный порт Docker не смог бы установить соединение. auth-default-access: "deny-all" определяет всю политику безопасности, так как запрещает чтение и запись всем пользователям без явного разрешения. behind-proxy: true указывает ntfy получать адрес клиента из заголовка X-Forwarded-For, чтобы лимиты запросов (rate limits) учитывали реальных посетителей, а не считали 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 пересоздает контейнер с ним; простое скачивание (pull) не меняет версию работающего сервера. Фиксацию версии всё равно нужно обновлять. Только октябрь 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 исправляет ошибку, из-за которой параллельные запросы обрабатывали действительные учетные данные как анонимные, а также обход авторизации шлюза push-уведомлений 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 (transport layer security).
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, интерфейс в стиле видеопрокатов 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 изнутри контейнера, поэтому файл конфигурации подключен как том.
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-задачи, не позволит подписаться и прочитать отправленные данные. Специальное имя пользователя 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 превращаются в эмодзи в уведомлении, если имя соответствует известному короткому коду эмодзи, и остаются обычным текстом, если нет.
Чтобы следить за темой из терминала, используйте потоковую передачу:
curl -s -u admin https://ntfy.example.com/alerts/rawcurl запрашивает пароль. Каждое сообщение приходит в виде одной строки, а пустые строки, которые появляются время от времени, являются сигналами поддержания соединения (keepalives). Открытие 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, чем ваша интерактивная оболочка, поэтому скрипт, работающий при ручном запуске, может завершиться до того, как дойдет до строки с 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, описанному выше, так как сервис таймера поддерживает тот же drop-in OnFailure=, а руководство по systemd сервисам и таймерам на VPS подробно описывает процесс такой конвертации.
Интеграция мониторинга доступности в тот же топик
Uptime Kuma, self-hosted система мониторинга статуса, поддерживает уведомления через ntfy. Откройте Settings, затем Notifications, выберите Setup Notification, укажите Ntfy, введите URL сервера https://ntfy.example.com и топик alerts, выберите приоритет и вставьте токен доступа robot. Перед сохранением отправьте тестовое уведомление: неверное имя топика вызывает ошибку при использовании прав write, которые не охватывают данный топик.
Реальное ограничение такой схемы: монитор, запущенный на том же VPS, не сообщит о недоступности самого VPS, а ntfy не сможет доставить уведомление о том, что ntfy не работает. Запускайте монитор на другом устройстве и настройте для него второй канал уведомлений, например email, для мониторинга самого ntfy. Тип монитора Push в Uptime Kuma закрывает другую «слепую зону»: ваш cron-задание обращается к push URL после успешного выполнения, а Kuma отправляет оповещение, если эти вызовы перестают поступать. Ветка сбоя срабатывает только при запуске задания, поэтому она не дает информации о задании, которое не запустилось вовсе.
Работает ли self-hosted ntfy на Android и iPhone?
На Android — да, без ограничений. Установите приложение из Google Play или F-Droid, откройте настройки, укажите сервер по умолчанию https://ntfy.example.com, добавьте свою учетную запись в разделе управления пользователями и подпишитесь на alerts. Для мгновенной доставки приложение поддерживает работу фонового сервиса, поэтому сообщения приходят даже в режиме энергосбережения (doze mode). Постоянное уведомление, которое при этом отображается, является требованием Android для фоновых сервисов, а не ошибкой. Сборка из F-Droid не содержит кода Firebase, поэтому все подписки используют мгновенную доставку. ntfy также может выступать в роли дистрибьютора UnifiedPush — открытой замены push-сервиса Google, что позволяет другим приложениям с поддержкой UnifiedPush доставлять уведомления через ваш сервер.
В официальном приложении для iOS работа возможна при наличии одной зависимости, которую нельзя исключить. iOS приостанавливает работу приложений в фоновом режиме, а разрешенные Apple фоновые задачи (воспроизведение аудио, обновление геолокации, выполнение запланированных задач) не позволяют приложению ожидать сообщения от вашего сервера. Поэтому для быстрого пробуждения необходимо использовать APNs (Apple push notification service). Отправлять уведомления может только провайдер с авторизованными учетными данными, поэтому ваш сервер не может напрямую связаться с официальным приложением. ntfy решает эту задачу через ретранслятор: ваш сервер отправляет poll_request с идентификатором сообщения на ntfy.sh, который пересылает его через Firebase и APNs для пробуждения приложения, после чего приложение запрашивает тело сообщения с вашего сервера.
upstream-base-url: "https://ntfy.sh"Четко осознавайте стоимость этого решения. Содержимое сообщения остается на вашем сервере, но факт доставки и идентификатор сообщения проходят через инфраструктуру, которой вы не управляете. Без этой настройки уведомления на iPhone от self-hosted сервера все равно будут приходить, но документация ntfy предупреждает, что задержка может достигать нескольких часов, так как ничто не пробуждает приложение принудительно. Чтобы использовать нативное приложение для iOS без ретранслятора ntfy.sh, соберите и распространяйте приложение самостоятельно, используя собственную учетную запись разработчика Apple и свои ключи APNs. Это потребует ежегодной оплаты и пересборки приложения при каждом обновлении. Другой вариант — использование PWA от ntfy на iOS 16.4 или новее: добавьте его на главный экран и настройте Web Push на своем сервере. Это позволит избежать использования ретранслятора ntfy.sh, но все равно задействует инфраструктуру push-уведомлений браузера. Если использование ретранслятора для вас неприемлемо, используйте оповещения на 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 и веб-приложение отбрасывают дубликаты по ID сообщения, но ваш собственный скрипт, который воспроизводит топик, должен делать то же самое. У каждого сервиса на сервере есть свой короткий список путей, которые нельзя восстановить, и сравнение 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 push notification service). Отправка уведомлений на официальное приложение требует учетных данных его издателя, поэтому 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" и ACL для каждого топика — это стандартная конфигурация. Это безопасно, пока ни один топик не доступен для чтения пользователю everyone. Экземпляр, доступный только через VPN, оправдан, если все подписчики — это подконтрольные вам машины. Это плохо подходит для телефонов, так как приложение получает сообщения только при активном туннеле, из-за чего оповещения встают в очередь до момента повторного подключения телефона.