Хостването на ntfy на Managed VPS означава да изпращате push известия с обикновена HTTP заявка, PUT или POST, от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. ntfy е свободен софтуер с двоен лиценз: Apache 2.0 и GPLv2. Това ръководство следва официалната му документация във версия 2.38.1: инсталиране с Docker Compose, файлът server.yml, потребителите и контролът на достъпа, токените за достъп, HTTPS, мобилните приложения, имейлът, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 21 ноември 2026 г.Време за четене: 15 минути
binwiederhier/ntfy, файл server.yml с base-url, cache-file и auth-file, и порт, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.auth-default-access: deny-all, създайте администратор с ntfy user add, после дайте на всеки скрипт собствен токен и ограничени права.server.yml и user.db, които пазят конфигурацията, потребителите, правата и токените; обновявайте, като смените етикета на образа, след като прочетете бележките към версията.ntfy, който се произнася „notify“, е услуга за известия по модела публикуване и абонамент (publish-subscribe), базирана на HTTP. README го представя като начин да изпращате известия до телефона или компютъра си от скриптове, от всеки компютър. Проектът поддържа публична инстанция, ntfy.sh, а сървърът може да се хоства самостоятелно: именно това разглежда ръководството.
curl, скрипт, планирана задача или друго приложение. Съобщението може да носи заглавие, приоритет от 1 до 5, етикети и емоджи, прикачен файл, бутони за действия или отложен час на доставка.ntfy или API, през WebSocket или HTTP поток, който остава отворен.curl -d "Backup finished" https://ntfy.example.com/backups
README на ntfy посочва, че проектът е с двоен лиценз: Apache License 2.0, във файла LICENSE, и GNU GPL версия 2, във файла LICENSE.GPLv2. Docker образът декларира и двата: Apache-2.0, GPL-2.0.
Можете следователно да пускате ntfy на своя сървър, за фирмата, екипа или клиентите си, без да купувате лиценз. И двата текста предоставят софтуера без гаранция.
Лицензът покрива кода. Името е отделен въпрос: Apache License 2.0 не дава права върху търговските марки на лицензодателя, а условията за ползване на ntfy.sh посочват, че името, логото и брандингът на ntfy са търговски марки на ntfy LLC, чието използване във връзка с продукт или услуга изисква предварителното ѝ писмено съгласие. Това ръководство назовава ntfy, за да опише софтуера.
Тази публикация е независима от проекта ntfy и от ntfy LLC и не е свързана с тях, нито спонсорирана или одобрена от тях.
Сървърът е един статично свързан двоичен файл за amd64, armv7 и arm64; Docker образът е наличен и за armv6. Документацията не дава числа за паметта или процесора: за домашен сървър, казва тя, мащабът не е повод за притеснение. Вместо това тя посочва какво ограничава една инстанция:
nofile. Услугата systemd на пакета го задава на 10 000.На Managed VPS ни разкажете как го използвате, броя на абонираните устройства, обема на съобщенията и прикачените файлове и ще ви препоръчаме подходящия размер.
Документацията предлага образа binwiederhier/ntfy в Docker Hub. Той предоставя уеб приложението и API на порт 80 на контейнера и не съдържа файл server.yml: конфигурацията се поставя в папка, монтирана на /etc/ntfy. На сървър с инсталиран Docker създайте папка и поставете в нея този compose.yaml, базиран на примера от документацията:
services:
ntfy:
image: binwiederhier/ntfy:v2.38.1
container_name: ntfy
command:
- serve
environment:
- TZ=UTC
volumes:
- ./etc:/etc/ntfy
- ./lib:/var/lib/ntfy
ports:
- "127.0.0.1:2586:80"
healthcheck:
test: ["CMD-SHELL", "wget -q --tries=1 http://localhost:80/v1/health -O - | grep -Eo '\"healthy\"\\s*:\\s*true' || exit 1"]
interval: 60s
timeout: 10s
retries: 3
start_period: 40s
restart: unless-stopped
init: true
После конфигурационният файл, в etc/server.yml, с публичния адрес на вашия сървър:
base-url: "https://ntfy.example.com"
cache-file: "/var/lib/ntfy/cache.db"
attachment-cache-dir: "/var/lib/ntfy/attachments"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
behind-proxy: true
enable-login: true
docker compose up -d
curl http://127.0.0.1:2586/v1/health
Сървърът отговаря {"healthy":true,"role":"active"}. Какво прави всяка настройка:
127.0.0.1:2586: примерите за Docker в документацията публикуват порт 80 на всички адреси, а примерите ѝ за обратен прокси препращат към 127.0.0.1:2586. Публикуван така, портът е достъпен само от самия сървър, а до API се стига единствено през обратния прокси, по HTTPS.base-url: публичният адрес на услугата. Примерният файл server.yml го изисква за прикачените файлове, изпращането на имейли и известията за iOS от самостоятелно хостван сървър.cache-file: без него съобщенията остават в паметта 12 часа и се губят при рестартиране. Този кеш позволява на телефони с нестабилна връзка да вземат пропуснатите съобщения.attachment-cache-dir: включва прикачените файлове. ntfy поема изцяло управлението на тази папка, затова я използвайте само за тази цел.auth-file и auth-default-access: deny-all: базата данни с потребителите и правата, създадена при първото стартиране, и анонимният достъп, забранен по подразбиране. Това е настройката, която документацията препоръчва за частна инстанция.behind-proxy: без нея, зад прокси, всички посетители споделят IP адреса на проксито и едни и същи ограничения на заявките.enable-login: позволява влизане в уеб приложението. Свободната регистрация остава затворена, тъй като enable-signup по подразбиране е false.v2.38.1 фиксира версията; latest следва най-новото издание. Документацията предлага също user: UID:GID за акаунт, различен от root: тогава файловете в etc и lib принадлежат на него.Проектът публикува и хранилище с пакети, подписано с ключ с отпечатък 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. На сървър с amd64:
sudo mkdir -p /etc/apt/keyrings
sudo curl -L -o /etc/apt/keyrings/ntfy.gpg https://archive.ntfy.sh/apt/keyring.gpg
sudo apt install apt-transport-https
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/ntfy.gpg] https://archive.ntfy.sh/apt stable main" \
| sudo tee /etc/apt/sources.list.d/ntfy.list
sudo apt update
sudo apt install ntfy
sudo systemctl enable ntfy
sudo systemctl start ntfy
Пакетът чете /etc/ntfy/server.yml. Примерният файл препоръчва /var/cache/ntfy/cache.db за кеша и /var/lib/ntfy/user.db за потребителите, две папки, които пакетът създава. Зад прокси добавете listen-http: "127.0.0.1:2586".
Веднага след инсталиране сървърът ntfy е отворен: всеки може да чете и пише във всяка тема, а името на темата служи за парола. С auth-file и deny-all нищо не минава без идентификационни данни. ntfy има две роли: admin, която чете и пише във всички теми, и user, която има само правата, които ѝ дадете.
docker compose exec ntfy ntfy user add --role=admin alice
Командата пита за паролата, после за потвърждението ѝ. Командите ntfy user, ntfy access и ntfy token пишат направо в базата данни с потребителите: те се изпълняват на сървъра, тук в контейнера, който чете пътя до тази база от server.yml.
Токенът за достъп засега дава пълен достъп до акаунта на своя потребител, с изключение на смяната на паролата и изтриването на акаунта. За скрипт създайте отделен потребител, ограничен до неговите теми, после токен за него:
docker compose exec ntfy ntfy user add backup-server
docker compose exec ntfy ntfy access backup-server backups write-only
docker compose exec ntfy ntfy token add --label="backups" backup-server
read-write, read-only, write-only или deny, за конкретна тема или за шаблон като alerts-*: звездичката е единственият поддържан заместващ знак.everyone, или *. За UnifiedPush в частна инстанция документацията отваря темите, които започват с up, само за писане: ntfy access '*' 'up*' write-only.tk_, могат да изтичат с --expires=30d, а всеки потребител може да има до 60. ntfy token list ги показва, ntfy token remove изтрива един от тях.auth-users, auth-access и auth-tokens създават същите обекти от server.yml при всяко стартиране. Потребител, премахнат от този списък, се изтрива от базата при следващото рестартиране.След това скриптът публикува със своя токен, по HTTPS:
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Title: Backup finished" \
-H "Priority: high" \
-d "The nightly backup went fine." \
https://ntfy.example.com/backups
Паролата при Basic auth е само кодирана в base64, а не шифрована: документацията изисква HTTPS на всеки самостоятелно хостван сървър. Именно това разглежда следващият раздел.
ntfy може сам да предоставя HTTPS, но зад прокси документацията препоръчва терминирането на TLS да се остави на проксито. Две неща са най-важни:
Upgrade и Connection и оставя тези дълги връзки да живеят. По подразбиране ntfy изпраща съобщение за поддържане на връзката на всеки 45 секунди, keepalive-interval, за да не ги затвори никой посредник поради неактивност.behind-proxy: true ntfy чете заглавката X-Forwarded-For и запазва най-десния адрес, този, който добавя вашето прокси. Ограниченията на заявките се прилагат към този адрес.Документацията отбелязва, че Caddy обслужва и HTTP, и WebSocket с reverse_proxy, без допълнителни настройки. Той сам получава сертификата Let’s Encrypt:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Този блок следва конфигурацията от документацията, близка до тази, с която работи ntfy.sh: буферирането е изключено за потоците, времената за изчакване са 3 минути, а размерът на тялото на заявките е без ограничение, тъй като ntfy сам го ограничава. Той слуша на порт 80, за да остави на Certbot да постави HTTPS:
server {
listen 80;
listen [::]:80;
server_name ntfy.example.com;
location / {
proxy_pass http://127.0.0.1:2586;
proxy_http_version 1.1;
proxy_buffering off;
proxy_request_buffering off;
proxy_redirect off;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_connect_timeout 3m;
proxy_send_timeout 3m;
proxy_read_timeout 3m;
client_max_body_size 0;
}
}
sudo ln -s /etc/nginx/sites-available/ntfy /etc/nginx/sites-enabled/
sudo nginx -t
sudo certbot --nginx -d ntfy.example.com
След като HTTP пренасочва към HTTPS, публикувайте в скриптовете си към адреси с https://. За хиляди абонати документацията увеличава worker_connections в nginx.conf и LimitNOFILE на услугата Nginx до двойния брой на връзките, към които се стремите.
Приложенията ntfy добавят теми от вашия сървър точно както от ntfy.sh: въведете адреса му, когато добавяте темата, а за защитена тема и потребителското име и паролата на потребител, който има достъп до нея. Уеб приложението се предоставя на адреса на самия сървър.
ntfy webpush keys, и валиден HTTPS сертификат.Добавете един ред в server.yml, после рестартирайте контейнера:
upstream-base-url: "https://ntfy.sh"
Тогава за всяко съобщение вашият сървър публикува към ntfy.sh заявка за проверка (poll), която съдържа само идентификатора на съобщението и хеша SHA-256 на URL адреса на темата. ntfy.sh я предава на устройството през услугата за известия на Apple, после приложението изтегля съобщението от вашия сървър. Текстът, който минава през ntfy.sh, е винаги един и същ, „New message“, каквото и да казва вашето съобщение. Без тази настройка известията пак пристигат, със закъснение, което може да стигне няколко часа според състоянието на телефона. upstream-access-token добавя токен, ако надхвърлите ограниченията на заявките на ntfy.sh.
ntfy ограничава всеки посетител, разпознат по IP адреса му, а при IPv6 по подмрежата му /64. Тези ограничения пазят сървъра от злоупотреби; при нормална употреба, казва документацията, не би трябвало да ги достигате. Над тях сървърът отговаря 429 Too Many Requests. Стойностите по подразбиране:
| Настройка | Стойност по подразбиране | Какво ограничава |
|---|---|---|
visitor-request-limit-burst | 60 | Заявките на посетител в един изблик |
visitor-request-limit-replenish | 5s | Скоростта на възстановяване: една заявка на всеки 5 секунди |
visitor-subscription-limit | 30 | Отворените връзки на посетител |
visitor-message-daily-limit | Няма | Съобщенията на ден, иначе управлявани от ограничението на заявките |
visitor-email-limit-burst | 16 | Имейлите в един изблик, после по един на час |
visitor-attachment-total-size-limit | 100M | Хранилището за прикачени файлове на посетител |
visitor-attachment-daily-bandwidth-limit | 500M | Трафикът на прикачени файлове на посетител на ден |
global-topic-limit | 15 000 | Общият брой теми на сървъра |
message-size-limit | 4K | Размерът на съобщението; над него то става прикачен файл |
visitor-request-limit-exempt-hosts, списък от IP адреси или имена на хостове.ntfy tier, дават на някои акаунти по-високи ограничения.attachment-file-size-limit, по подразбиране 15M, ограничава всеки файл, attachment-total-size-limit, 5G, цялото хранилище, а attachment-expiry-duration, 3h, живота им. Прикаченият файл никога не надживява съобщението си: за да пазите прикачените файлове по-дълго, увеличете и cache-duration.ntfy може да препрати съобщение по имейл, когато заявката за публикуване носи заглавката Email, или X-Email, с адрес. За целта той минава през SMTP сървър за изходяща поща, със STARTTLS и удостоверяване PLAIN или LOGIN: това е порт 587. От VPS на Simafri пощата излиза през удостоверено SMTP реле на същия порт 587: посочете тук адреса на пощенски акаунт, който вече имате, или този на вашата услуга за доставка на имейли.
smtp-sender-addr: "smtp.example.com:587"
smtp-sender-user: "ntfy@example.com"
smtp-sender-pass: "smtp-password"
smtp-sender-from: "ntfy@example.com"
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Email: alice@example.com" \
-d "The file server disk is over 90% full." \
https://ntfy.example.com/alerts
base-url и smtp-sender-from са задължителни, щом е зададен smtp-sender-addr: без тях сървърът отказва да стартира.smtp-sender-verify: true ограничава изпращането до адресите, които всеки потребител е потвърдил в акаунта си, и го затваря за анонимните потребители.server.yml: оставете този файл четим само от собственика му, с chmod 600.Със SQLite ntfy пази всеки вид данни в отделен файл. При инсталацията от това ръководство всичко се намира в папките etc и lib, до compose.yaml:
| Елемент | Какво пази | Архивиране |
|---|---|---|
etc/server.yml | Конфигурацията, включително SMTP тайните и ключовете за Web Push | Да |
lib/user.db | Потребителите, записите за контрол на достъпа, токените и дневните броячи | Да |
lib/cache.db | Съобщенията от последните 12 часа, по подразбиране | Полезно, животът им е кратък |
lib/attachments/ | Прикачените файлове от последните 3 часа, по подразбиране | Полезно, животът им е кратък |
Файлът web-push-file | Абонаментите за Web Push на браузърите, ако сте го включили | Да |
За последователно копие на файловете SQLite спрете услугата, докато се създава архивът:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Планирайте това копие в спокоен час и го изпращайте извън сървъра. Поставени на диска му, тези архиви влизат и в нощните му резервни копия. За възстановяване върнете папките на мястото им, после изпълнете docker compose up -d.
Ако загубите user.db без копие, потребителите и токените, декларирани в server.yml чрез auth-users и auth-tokens, се създават отново при стартиране; тези, създадени от командния ред, трябва да се създадат наново.
С Docker сменете етикета на образа в compose.yaml, например от v2.38.1 на следващата версия, после:
docker compose pull
docker compose up -d
Папките etc и lib остават на мястото си, а ntfy сам мигрира базите си данни при стартиране. С пакета за Debian sudo apt update, после sudo apt upgrade правят същото.
Бележките към всяка версия, на страницата „Releases“ в документацията, събират в „Upgrade notes“ какво се променя за съществуваща инстанция, като например във 2.36.0 конфигурация, която вече се проверява изцяло при стартиране, или дневни броячи, нулирани отново. Прочетете ги преди обновяване и копирайте двете папки непосредствено преди това. Версия 2.38.1 е версия за сигурност, която проектът силно препоръчва: тя укрепва шаблоните на съобщенията срещу атаки за отказ на услугата (denial-of-service) и не позволява бавните качвания на прикачени файлове към S3 и неотговарящите крайни точки за web push да заемат памет и връзки. Тя следва 2.38.0, която споделя ограниченията на заявките между възлите на клъстер и е компилирана с Go 1.27.4.
Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; ntfy остава ваш софтуер, с неговите настройки и данни.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който пасва на вашата дейност |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Четенето на журналите на вашата инстанция |
| ntfy | Проактивно проследяване: грешки, забавяния, отворени връзки и дисково пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент |
| Достъпът | Сървърът, който го носи, наблюдаван и архивиран | Потребителите, правата върху темите и токените на вашите скриптове |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Копията, специфични за ntfy, и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на ntfy, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. ntfy е с двоен лиценз, Apache 2.0 и GPLv2: можете да го използвате в работата си, без да купувате лиценз. Условията им се отнасят до разпространението на софтуера. Остава цената на сървъра, на който работи.
Създайте compose.yaml с образа binwiederhier/ntfy, командата serve, папка, монтирана на /etc/ntfy за server.yml, друга на /var/lib/ntfy за базите данни и порт 80 на контейнера, публикуван на 127.0.0.1:2586. Изпълнете docker compose up -d, после поставете обратен прокси с HTTPS пред този порт.
В server.yml задайте auth-file и auth-default-access: deny-all. После създайте администратор с ntfy user add --role=admin, ограничени потребители с ntfy user add и правата им върху темите с ntfy access.
Създайте токен с ntfy token add за потребител, отделен за скрипта и ограничен до неговите теми, после публикувайте с curl и заглавката Authorization: Bearer, последвана от токена, по HTTPS. Токенът дава достъп до целия акаунт на своя потребител.
Зад обратен прокси всяка заявка идва от адреса на проксито. С behind-proxy: true ntfy чете заглавката X-Forwarded-For, за да разпознае всеки посетител; без нея всички споделят едни и същи ограничения на заявките.
Да, с upstream-base-url: "https://ntfy.sh" в server.yml. Тогава вашият сървър предава чрез ntfy.sh сигнал, който съдържа само идентификатора на съобщението, а приложението изтегля съобщението от вашия сървър. Без тази настройка доставката може да отнеме няколко часа.
Архивирайте server.yml и user.db, които пазят конфигурацията, потребителите, правата и токените, както и файла на Web Push, ако е включен. Кешът на съобщенията и прикачените файлове имат кратък живот. Спрете услугата, докато копирате, за последователни файлове SQLite.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.