Хостване на ntfy на Managed VPS: push известия от ваш собствен сървър

Хостването на 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 минути

Всички ръководства

Накратко

  1. ntfy приема съобщение чрез HTTP заявка PUT или POST към тема и веднага го изпраща до телефоните, браузърите и скриптовете, абонирани за тази тема.
  2. Двойният му лиценз, Apache 2.0 и GPLv2, позволява свободно да го използвате в работата си; условията му се отнасят до разпространението на софтуера.
  3. Инсталирайте го с Docker Compose: образът binwiederhier/ntfy, файл server.yml с base-url, cache-file и auth-file, и порт, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.
  4. По подразбиране всеки може да чете и пише във всяка тема: задайте auth-default-access: deny-all, създайте администратор с ntfy user add, после дайте на всеки скрипт собствен токен и ограничени права.
  5. Архивирайте server.yml и user.db, които пазят конфигурацията, потребителите, правата и токените; обновявайте, като смените етикета на образа, след като прочетете бележките към версията.

Какво прави ntfy

ntfy, който се произнася „notify“, е услуга за известия по модела публикуване и абонамент (publish-subscribe), базирана на HTTP. README го представя като начин да изпращате известия до телефона или компютъра си от скриптове, от всеки компютър. Проектът поддържа публична инстанция, ntfy.sh, а сървърът може да се хоства самостоятелно: именно това разглежда ръководството.

Терминал, първо съобщение
curl -d "Backup finished" https://ntfy.example.com/backups

Лицензите Apache 2.0 и GPLv2 и търговската марка

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. Документацията не дава числа за паметта или процесора: за домашен сървър, казва тя, мащабът не е повод за притеснение. Вместо това тя посочва какво ограничава една инстанция:

На Managed VPS ни разкажете как го използвате, броя на абонираните устройства, обема на съобщенията и прикачените файлове и ще ви препоръчаме подходящия размер.

Инсталиране с Docker Compose

Документацията предлага образа binwiederhier/ntfy в Docker Hub. Той предоставя уеб приложението и API на порт 80 на контейнера и не съдържа файл server.yml: конфигурацията се поставя в папка, монтирана на /etc/ntfy. На сървър с инсталиран Docker създайте папка и поставете в нея този compose.yaml, базиран на примера от документацията:

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, с публичния адрес на вашия сървър:

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
Терминал, в папката на compose.yaml
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Сървърът отговаря {"healthy":true,"role":"active"}. Какво прави всяка настройка:

Без Docker: хранилището за Debian и Ubuntu

Проектът публикува и хранилище с пакети, подписано с ключ с отпечатък 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

След това скриптът публикува със своя токен, по 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 на всеки самостоятелно хостван сървър. Именно това разглежда следващият раздел.

HTTPS: обратният прокси

ntfy може сам да предоставя HTTPS, но зад прокси документацията препоръчва терминирането на TLS да се остави на проксито. Две неща са най-важни:

С Caddy

Документацията отбелязва, че Caddy обслужва и HTTP, и WebSocket с reverse_proxy, без допълнителни настройки. Той сам получава сертификата Let’s Encrypt:

Caddyfile
ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}

С Nginx

Този блок следва конфигурацията от документацията, близка до тази, с която работи ntfy.sh: буферирането е изключено за потоците, времената за изчакване са 3 минути, а размерът на тялото на заявките е без ограничение, тъй като ntfy сам го ограничава. Той слуша на порт 80, за да остави на Certbot да постави HTTPS:

/etc/nginx/sites-available/ntfy
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 до двойния брой на връзките, към които се стремите.

Приложенията за Android, iOS и уеб

Приложенията ntfy добавят теми от вашия сървър точно както от ntfy.sh: въведете адреса му, когато добавяте темата, а за защитена тема и потребителското име и паролата на потребител, който има достъп до нея. Уеб приложението се предоставя на адреса на самия сървър.

Мигновени известия на iOS

Добавете един ред в server.yml, после рестартирайте контейнера:

etc/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-burst60Заявките на посетител в един изблик
visitor-request-limit-replenish5sСкоростта на възстановяване: една заявка на всеки 5 секунди
visitor-subscription-limit30Отворените връзки на посетител
visitor-message-daily-limitНямаСъобщенията на ден, иначе управлявани от ограничението на заявките
visitor-email-limit-burst16Имейлите в един изблик, после по един на час
visitor-attachment-total-size-limit100MХранилището за прикачени файлове на посетител
visitor-attachment-daily-bandwidth-limit500MТрафикът на прикачени файлове на посетител на ден
global-topic-limit15 000Общият брой теми на сървъра
message-size-limit4KРазмерът на съобщението; над него то става прикачен файл

Известия по имейл

ntfy може да препрати съобщение по имейл, когато заявката за публикуване носи заглавката Email, или X-Email, с адрес. За целта той минава през SMTP сървър за изходяща поща, със STARTTLS и удостоверяване PLAIN или LOGIN: това е порт 587. От VPS на Simafri пощата излиза през удостоверено SMTP реле на същия порт 587: посочете тук адреса на пощенски акаунт, който вече имате, или този на вашата услуга за доставка на имейли.

etc/server.yml
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

Резервните копия

Със 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 спрете услугата, докато се създава архивът:

Терминал, в папката на compose.yaml
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 на следващата версия, после:

Терминал, в папката на compose.yaml
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

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; ntfy остава ваш софтуер, с неговите настройки и данни.

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който пасва на вашата дейност
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виЧетенето на журналите на вашата инстанция
ntfyПроактивно проследяване: грешки, забавяния, отворени връзки и дисково пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент
ДостъпътСървърът, който го носи, наблюдаван и архивиранПотребителите, правата върху темите и токените на вашите скриптове
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноКопията, специфични за ntfy, и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.

ntfy, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на ntfy, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е ntfy за фирма?

Да. ntfy е с двоен лиценз, Apache 2.0 и GPLv2: можете да го използвате в работата си, без да купувате лиценз. Условията им се отнасят до разпространението на софтуера. Остава цената на сървъра, на който работи.

Как се инсталира ntfy с Docker Compose?

Създайте compose.yaml с образа binwiederhier/ntfy, командата serve, папка, монтирана на /etc/ntfy за server.yml, друга на /var/lib/ntfy за базите данни и порт 80 на контейнера, публикуван на 127.0.0.1:2586. Изпълнете docker compose up -d, после поставете обратен прокси с HTTPS пред този порт.

Как се прави сървър ntfy частен?

В server.yml задайте auth-file и auth-default-access: deny-all. После създайте администратор с ntfy user add --role=admin, ограничени потребители с ntfy user add и правата им върху темите с ntfy access.

Как се публикува в ntfy от скрипт с токен?

Създайте токен с ntfy token add за потребител, отделен за скрипта и ограничен до неговите теми, после публикувайте с curl и заглавката Authorization: Bearer, последвана от токена, по HTTPS. Токенът дава достъп до целия акаунт на своя потребител.

Защо да зададете behind-proxy в ntfy?

Зад обратен прокси всяка заявка идва от адреса на проксито. С behind-proxy: true ntfy чете заглавката X-Forwarded-For, за да разпознае всеки посетител; без нея всички споделят едни и същи ограничения на заявките.

Пристигат ли известията на ntfy веднага на iPhone?

Да, с upstream-base-url: "https://ntfy.sh" в server.yml. Тогава вашият сървър предава чрез ntfy.sh сигнал, който съдържа само идентификатора на съобщението, а приложението изтегля съобщението от вашия сървър. Без тази настройка доставката може да отнеме няколко часа.

Как се архивира ntfy?

Архивирайте server.yml и user.db, които пазят конфигурацията, потребителите, правата и токените, както и файла на Web Push, ако е включен. Кешът на съобщенията и прикачените файлове имат кратък живот. Спрете услугата, докато копирате, за последователни файлове SQLite.

Покрива ли Managed VPS ntfy?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свързани ръководства

Хостване на Uptime Kuma на Managed VPS: следете услугите си непрекъснатоХостването на Uptime Kuma на Managed VPS означава да следите сайтовете, API-тата и сървърите си от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Uptime Kuma е свободен софтуер с лиценз MIT. Това ръководство следва официалната му документация: инсталиране с Docker Compose, HTTPS, база данни, известия, резервни копия и обновления.Разлика между управляван и неуправляван VPS: кой какво правиРазликата между управляван и неуправляван VPS се свежда до един въпрос: кой се грижи за сървъра, след като той вече работи. Думата „управляван“ обаче няма официално определение и от един хостинг доставчик до друг обхваща всичко от простото инсталиране на системата до цялостното стопанисване на сървъра. Това ръководство показва кой какво прави, ред по ред, заедно с междинното ниво на експертното съдействие, и дава въпросите, които премахват двусмислието, преди да подпишете.Резервни копия на VPS: какво да проверите, преди да подпишетеПочти всяко предложение за VPS обявява „включени резервни копия“. Зад тези думи може да стои копие всяка нощ, пазено извън машината и възстановявано от експерти, или моментна снимка, поставена на същия диск като сървъра. Това ръководство дава въпросите, които правят разликата, какво означава всеки отговор и как да проверите, че едно резервно копие наистина се възстановява.
Свържете се с нас