Hostovanie ntfy na Managed VPS znamená posielať push notifikácie obyčajnou požiadavkou HTTP, PUT alebo POST, z vlastného stroja, ktorý naše tímy udržiavajú aktuálny a dohliadajú naň vo dne v noci. ntfy je slobodný softvér s duálnou licenciou, Apache 2.0 a GPLv2. Tento sprievodca postupuje podľa jeho oficiálnej dokumentácie vo verzii 2.38.1: inštalácia cez Docker Compose, súbor server.yml, používatelia a riadenie prístupu, prístupové tokeny, HTTPS, mobilné aplikácie, e-mail, zálohy a aktualizácie.
Autor: Simon Vasconcelos Lee
Publikované 21. novembra 2026Čas čítania: 15 minút
binwiederhier/ntfy, súbor server.yml s base-url, cache-file a auth-file a port publikovaný na 127.0.0.1 za reverznou proxy s HTTPS.auth-default-access: deny-all, vytvorte správcu príkazom ntfy user add a potom dajte každému skriptu vlastný token a obmedzené oprávnenia.server.yml a user.db, ktoré obsahujú konfiguráciu, používateľov, oprávnenia a tokeny; aktualizujte zmenou tagu obrazu, po prečítaní poznámok k vydaniu.ntfy, vyslovované „notify“, je notifikačná služba typu publikovanie a odber, postavená na HTTP. Jeho README ho predstavuje ako spôsob, ako posielať upozornenia na telefón alebo počítač zo skriptov, z akéhokoľvek počítača. Projekt prevádzkuje verejnú inštanciu ntfy.sh a server sa dá hostovať samostatne: tomu sa venuje tento sprievodca.
curl, skriptu, plánovanej úlohy alebo inej aplikácie. Správa môže niesť nadpis, prioritu od 1 do 5, štítky a emoji, prílohu, akčné tlačidlá alebo odložený čas doručenia.ntfy alebo API, cez WebSocket alebo HTTP stream, ktorý zostáva otvorený.curl -d "Backup finished" https://ntfy.example.com/backups
README projektu ntfy uvádza, že projekt má duálnu licenciu: licenciu Apache 2.0 v súbore LICENSE a GNU GPL verzie 2 v súbore LICENSE.GPLv2. Obraz Docker deklaruje obe, Apache-2.0, GPL-2.0.
Prevádzkovať ntfy na vašom serveri, pre vašu firmu, tím alebo klientov, teda nevyžaduje kúpu žiadnej licencie. Oba texty poskytujú softvér bez záruky.
Licencia sa vzťahuje na kód. Názov je samostatná vec: licencia Apache 2.0 neudeľuje žiadne práva k ochranným známkam poskytovateľa licencie a podmienky služby ntfy.sh uvádzajú, že názov, logo a vizuálna identita ntfy sú ochrannými známkami spoločnosti ntfy LLC, ktorých použitie v súvislosti s produktom alebo službou si vyžaduje jej predchádzajúci písomný súhlas. Tento sprievodca uvádza názov ntfy na opis softvéru.
Táto publikácia je nezávislá od projektu ntfy a od spoločnosti ntfy LLC: nie je s nimi prepojená, nie je nimi sponzorovaná ani schválená.
Server je jediný, staticky linkovaný binárny súbor pre amd64, armv7 a arm64; obraz Docker existuje aj pre armv6. Dokumentácia neuvádza žiadne údaje o pamäti ani o procesore: pri domácom serveri sa podľa nej netreba obávať škálovania. Namiesto toho uvádza, čo inštanciu obmedzuje:
nofile. Služba systemd z balíka ho nastavuje na 10 000.Na Managed VPS nám opíšte svoje používanie, počet odoberajúcich zariadení, objem správ a prílohy a odporučíme vám vhodnú veľkosť.
Dokumentácia ponúka obraz binwiederhier/ntfy z Docker Hubu. Poskytuje webovú aplikáciu a API na porte 80 kontajnera a neobsahuje žiadny súbor server.yml: konfigurácia patrí do priečinka pripojeného do /etc/ntfy. Na serveri s nainštalovaným Dockerom vytvorte priečinok a vložte doň tento compose.yaml, vychádzajúci z príkladu v dokumentácii:
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
Potom konfiguračný súbor etc/server.yml s verejnou adresou vášho servera:
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
Server odpovie {"healthy":true,"role":"active"}. Čo robí ktoré nastavenie:
127.0.0.1:2586: príklady pre Docker v dokumentácii publikujú port 80 na všetkých adresách a jej príklady reverznej proxy presmerúvajú na 127.0.0.1:2586. Takto publikovaný port je dostupný len zo samotného servera a k API sa dostanete výhradne cez reverznú proxy, cez HTTPS.base-url: verejná adresa služby. Vzorový súbor server.yml ju vyžaduje pre prílohy, odosielanie e-mailov a upozornenia pre iOS zo samostatne hostovaného servera.cache-file: bez neho zostávajú správy 12 hodín v pamäti a pri reštarte sa stratia. Táto vyrovnávacia pamäť umožní telefónom s nestabilným pripojením stiahnuť správy, ktoré zmeškali.attachment-cache-dir: zapína prílohy. ntfy nad týmto priečinkom preberá úplnú kontrolu, vyhraďte ho preto len na tento účel.auth-file a auth-default-access: deny-all: databáza používateľov a oprávnení, vytvorená pri prvom spustení, a anonymný prístup v predvolenom stave zamietnutý. Toto nastavenie dokumentácia odporúča pre súkromnú inštanciu.behind-proxy: bez neho za proxy zdieľajú všetci návštevníci IP adresu proxy a rovnaké limity požiadaviek.enable-login: umožňuje prihlásenie do webovej aplikácie. Voľná registrácia zostáva zatvorená, pretože enable-signup má predvolenú hodnotu false.v2.38.1 zafixuje verziu; latest sleduje najnovšie vydanie. Dokumentácia ponúka aj user: UID:GID pre iný účet než root: súbory v etc a lib potom patria jemu.Projekt zverejňuje aj repozitár balíkov, podpísaný kľúčom s odtlačkom 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Na serveri 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
Balík číta /etc/ntfy/server.yml. Vzorový súbor odporúča /var/cache/ntfy/cache.db pre vyrovnávaciu pamäť a /var/lib/ntfy/user.db pre používateľov, dva priečinky, ktoré balík vytvorí. Za proxy pridajte listen-http: "127.0.0.1:2586".
Po inštalácii je server ntfy otvorený: každý môže čítať a zapisovať do všetkých tém a názov témy slúži ako heslo. S auth-file a deny-all neprejde nič bez prihlasovacích údajov. ntfy má dve roly: admin, ktorá číta a zapisuje do všetkých tém, a user, ktorá má len oprávnenia, ktoré jej udelíte.
docker compose exec ntfy ntfy user add --role=admin alice
Príkaz si vypýta heslo a potom jeho potvrdenie. Príkazy ntfy user, ntfy access a ntfy token zapisujú priamo do databázy používateľov: spúšťajú sa na serveri, tu vnútri kontajnera, ktorý cestu k tejto databáze číta zo server.yml.
Prístupový token v súčasnosti dáva úplný prístup k účtu svojho používateľa, okrem zmeny hesla a odstránenia účtu. Pre skript vytvorte vyhradeného používateľa, obmedzeného na jeho témy, a potom preň token:
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 alebo deny, na konkrétnu tému alebo na vzor ako alerts-*, jediný podporovaný zástupný znak.everyone, čiže *. Pre UnifiedPush na súkromnej inštancii dokumentácia otvára témy začínajúce na up len na zápis: ntfy access '*' 'up*' write-only.tk_, môžu vypršať vďaka --expires=30d a každý používateľ ich môže mať až 60. ntfy token list ich vypíše, ntfy token remove jeden z nich odstráni.auth-users, auth-access a auth-tokens tie isté objekty zo server.yml, pri každom spustení. Používateľ odstránený z tohto zoznamu sa pri nasledujúcom reštarte vymaže z databázy.Skript potom publikuje so svojím tokenom, cez 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
Heslo Basic auth je len zakódované v base64, nie zašifrované: dokumentácia vyžaduje HTTPS na každom samostatne hostovanom serveri. Tomu sa venuje nasledujúca časť.
ntfy vie HTTPS obsluhovať aj sám, ale za proxy dokumentácia odporúča nechať ukončenie TLS na proxy. Najviac záleží na dvoch bodoch:
Upgrade a Connection a nechá tieto dlhé spojenia žiť. ntfy v predvolenom stave posiela každých 45 sekúnd udržiavaciu správu, keepalive-interval, aby ich žiadny sprostredkovateľ nezatvoril pre nečinnosť.behind-proxy: true číta ntfy hlavičku X-Forwarded-For a berie z nej adresu najviac vpravo, tú, ktorú pridáva vaša proxy. Limity požiadaviek sa vzťahujú na túto adresu.Dokumentácia poznamenáva, že Caddy zvláda HTTP aj WebSockety direktívou reverse_proxy, bez ďalších nastavení. Certifikát Let’s Encrypt si zaobstará sám:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Tento blok vychádza z konfigurácie v dokumentácii, blízkej tej, ktorú používa ntfy.sh: vypnuté bufferovanie pre streamy, časové limity 3 minúty a žiadny limit veľkosti tela požiadaviek, ktoré ntfy obmedzuje sám. Počúva na porte 80, aby Certbot mohol nastaviť 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
Keď HTTP presmerúva na HTTPS, publikujte v skriptoch na adresy https://. Pre tisíce odberateľov dokumentácia zvyšuje worker_connections v nginx.conf a LimitNOFILE služby Nginx na dvojnásobok cieľového počtu spojení.
Aplikácie ntfy pridávajú témy z vášho servera rovnako ako z ntfy.sh: pri pridávaní témy zadajte adresu servera a pri chránenej téme používateľské meno a heslo používateľa, ktorý k nej má prístup. Webová aplikácia je dostupná na adrese samotného servera.
ntfy webpush keys a platný certifikát HTTPS.Pridajte do server.yml jeden riadok a potom reštartujte kontajner:
upstream-base-url: "https://ntfy.sh"
Pri každej správe potom váš server publikuje na ntfy.sh dopytovaciu požiadavku, ktorá obsahuje len ID správy a hash SHA-256 adresy URL témy. ntfy.sh ju odovzdá zariadeniu cez notifikačnú službu Apple a aplikácia si potom správu stiahne z vášho servera. Text, ktorý prechádza cez ntfy.sh, je vždy rovnaký, „New message“, bez ohľadu na obsah vašej správy. Bez tohto nastavenia upozornenia prichádzajú tiež, s oneskorením, ktoré môže podľa stavu telefónu dosiahnuť niekoľko hodín. upstream-access-token pridá token, ak prekročíte limity požiadaviek ntfy.sh.
ntfy obmedzuje každého návštevníka, identifikovaného podľa IP adresy a pri IPv6 podľa podsiete /64. Tieto limity chránia server pred zneužitím; pri bežnom používaní by ste na ne podľa dokumentácie nemali naraziť. Po ich prekročení server odpovie 429 Too Many Requests. Predvolené hodnoty:
| Nastavenie | Predvolené | Čo obmedzuje |
|---|---|---|
visitor-request-limit-burst | 60 | Požiadavky návštevníka v jednej dávke |
visitor-request-limit-replenish | 5s | Rýchlosť dopĺňania: jedna požiadavka každých 5 sekúnd |
visitor-subscription-limit | 30 | Otvorené spojenia na návštevníka |
visitor-message-daily-limit | Žiadny | Správy za deň, inak riadené limitom požiadaviek |
visitor-email-limit-burst | 16 | E-maily v jednej dávke, potom jeden za hodinu |
visitor-attachment-total-size-limit | 100M | Úložisko príloh na návštevníka |
visitor-attachment-daily-bandwidth-limit | 500M | Prenos príloh na návštevníka za deň |
global-topic-limit | 15 000 | Celkový počet tém na serveri |
message-size-limit | 4K | Veľkosť správy; nad ňou sa správa stáva prílohou |
visitor-request-limit-exempt-hosts, zoznamu IP adries alebo názvov hostiteľov.ntfy tier, dávajú niektorým účtom vyššie limity.attachment-file-size-limit, v predvolenom stave 15M, obmedzuje každý súbor, attachment-total-size-limit, 5G, celé úložisko a attachment-expiry-duration, 3h, ich životnosť. Príloha nikdy neprežije svoju správu: ak chcete prílohy uchovávať dlhšie, zvýšte aj cache-duration.ntfy vie správu preposlať e-mailom, keď požiadavka na publikovanie nesie hlavičku Email, alebo X-Email, s adresou. Používa na to odchádzajúci server SMTP, cez STARTTLS, s overením PLAIN alebo LOGIN: to je port 587. Z VPS Simafri odchádza pošta cez overené relé SMTP na tom istom porte 587: zadajte sem adresu e-mailového účtu, ktorý už máte, alebo adresu svojej odosielacej služby.
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 a smtp-sender-from sú povinné, hneď ako je nastavené smtp-sender-addr: bez nich sa server odmietne spustiť.smtp-sender-verify: true obmedzuje odosielanie na adresy, ktoré si každý používateľ overil vo svojom účte, a uzatvára ho pre anonymných používateľov.server.yml: ponechajte tento súbor čitateľný len pre jeho vlastníka, príkazom chmod 600.So SQLite uchováva ntfy každý druh údajov vo vlastnom súbore. V inštalácii z tohto sprievodcu je všetko v priečinkoch etc a lib, vedľa súboru compose.yaml:
| Položka | Čo obsahuje | Zálohovať |
|---|---|---|
etc/server.yml | Konfiguráciu, vrátane tajných údajov SMTP a kľúčov Web Push | Áno |
lib/user.db | Používateľov, záznamy riadenia prístupu, tokeny a denné počty | Áno |
lib/cache.db | Správy z posledných 12 hodín, v predvolenom stave | Užitočné, ich životnosť je krátka |
lib/attachments/ | Prílohy z posledných 3 hodín, v predvolenom stave | Užitočné, ich životnosť je krátka |
Súbor web-push-file | Odbery Web Push z prehliadačov, ak ste ich zapli | Áno |
Pre konzistentnú kópiu súborov SQLite zastavte službu počas vytvárania archívu:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Naplánujte túto kópiu na pokojnú hodinu a posielajte ju mimo servera. Uložené na jeho disku sú tieto archívy navyše súčasťou jeho nočných záloh. Na obnovu vráťte priečinky na miesto a potom spustite docker compose up -d.
Ak stratíte user.db bez kópie, používatelia a tokeny deklarované v server.yml cez auth-users a auth-tokens sa pri spustení obnovia; tie vytvorené na príkazovom riadku treba vytvoriť znova.
S Dockerom zmeňte tag obrazu v compose.yaml, napríklad z v2.38.1 na ďalšiu verziu, a potom:
docker compose pull
docker compose up -d
Priečinky etc a lib zostávajú na mieste a ntfy svoje databázy pri spustení migruje sám. Pri balíku pre Debian to isté urobia sudo apt update a potom sudo apt upgrade.
Poznámky ku každej verzii, na stránke „Releases“ dokumentácie, zhŕňajú pod nadpisom „Upgrade notes“ to, čo sa mení pre existujúcu inštanciu, napríklad vo verzii 2.36.0 konfiguráciu, ktorá sa odteraz pri spustení kontroluje celá, alebo vynulované denné počty. Prečítajte si ich pred aktualizáciou a tesne predtým skopírujte oba priečinky. Verzia 2.38.1 je bezpečnostné vydanie, ktoré projekt dôrazne odporúča: spevňuje šablóny správ proti útokom typu odmietnutie služby a bráni tomu, aby pomalé nahrávania príloh do S3 a nereagujúce koncové body web push blokovali pamäť a spojenia. Nadväzuje na verziu 2.38.0, ktorá zdieľa limity požiadaviek medzi uzlami klastra a je zostavená s Go 1.27.4.
Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; ntfy zostáva vaším softvérom, s vašimi nastaveniami a údajmi.
| Téma | Naše tímy | Vy |
|---|---|---|
| Server | Aktualizácie systému a zabezpečenia, vrátane zásahov na serveri | Čas, ktorý vyhovuje vašej činnosti |
| Dohľad | Server sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanie | Čítanie záznamov vašej inštancie |
| ntfy | Proaktívne sledovanie: chyby, spomalenia, otvorené spojenia a miesto na disku, s odporúčanou opravou | Jeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent |
| Prístupy | Server, ktorý ich nesie, sledovaný a zálohovaný | Používatelia, oprávnenia k témam a tokeny vašich skriptov |
| Zálohy | Každú noc, šifrované a uchovávané mimo stroja; obnova je v cene | Kópie špecifické pre ntfy a žiadosť o obnovu, keď ju potrebujete |
| Migrácia | Váš súčasný server prenesený zdarma | Čas prepnutia |
Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.
S Managed VPS od Simafri udržiavajú naše tímy server vašej inštancie ntfy aktuálny, sledujú ho vo dne v noci a zasahujú bez čakania na vaše zavolanie; vašu inštanciu navyše proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy alebo váš AI asistent. Zálohy sa každú noc šifrujú a uchovávajú mimo stroja, ich obnova je v cene a migrácia vášho súčasného servera je zdarma.
Áno. ntfy má duálnu licenciu, Apache 2.0 a GPLv2: vo firme ho môžete prevádzkovať bez licencie, ktorú by ste museli kupovať. Ich podmienky sa týkajú ďalšieho šírenia softvéru. Zostáva náklad na server, na ktorom beží.
Vytvorte compose.yaml s obrazom binwiederhier/ntfy, príkazom serve, priečinkom pripojeným do /etc/ntfy pre server.yml, ďalším do /var/lib/ntfy pre databázy a portom 80 kontajnera publikovaným na 127.0.0.1:2586. Spustite docker compose up -d a potom pred tento port umiestnite reverznú proxy s HTTPS.
V server.yml nastavte auth-file a auth-default-access: deny-all. Potom vytvorte správcu príkazom ntfy user add --role=admin, používateľov s obmedzeným prístupom príkazom ntfy user add a ich oprávnenia k témam príkazom ntfy access.
Vytvorte token príkazom ntfy token add pre používateľa vyhradeného pre skript, obmedzeného na jeho témy, a potom publikujte cez curl s hlavičkou Authorization: Bearer, za ktorou nasleduje token, cez HTTPS. Token dáva prístup k celému účtu svojho používateľa.
Za reverznou proxy prichádza každá požiadavka z adresy proxy. S behind-proxy: true číta ntfy hlavičku X-Forwarded-For, aby rozpoznal každého návštevníka; bez toho zdieľajú všetci rovnaké limity požiadaviek.
Áno, s upstream-base-url: "https://ntfy.sh" v server.yml. Váš server potom nechá ntfy.sh preposlať signál, ktorý obsahuje len ID správy, a aplikácia si správu stiahne z vášho servera. Bez tohto nastavenia môže doručenie trvať niekoľko hodín.
Zálohujte server.yml a user.db, ktoré obsahujú konfiguráciu, používateľov, oprávnenia a tokeny, a tiež súbor Web Push, ak je zapnutý. Vyrovnávacia pamäť správ a prílohy majú krátku životnosť. Počas kopírovania zastavte službu, aby boli súbory SQLite konzistentné.
Managed VPS pokrýva server: systém, zabezpečenie, dohľad a zálohy. Naše tímy vašu inštanciu aj proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy. Zásah v samotnej aplikácii sa fakturuje hodinovo alebo paušálne.
Simafri
Porozprávajme sa o vašom zámere
Povedzte nám v pár slovách, čo potrebujete: rýchlo sa vám ozveme.
Ďakujeme! Vaša žiadosť bola odoslaná. Čoskoro sa vám ozveme.
Máte radšej e-mail? Napíšte nám na support@simafri.com.