Hostovanie ntfy na Managed VPS: push notifikácie z vášho vlastného servera

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.

Simon Vasconcelos Lee Autor: Publikované 21. novembra 2026Čas čítania: 15 minút

Všetci sprievodcovia

To najdôležitejšie

  1. ntfy prijme správu cez požiadavku HTTP PUT alebo POST na tému a okamžite ju doručí telefónom, prehliadačom a skriptom, ktoré danú tému odoberajú.
  2. Jeho duálna licencia, Apache 2.0 a GPLv2, vám umožňuje voľne ho prevádzkovať v práci; jej podmienky sa týkajú ďalšieho šírenia softvéru.
  3. Nainštalujte ho cez Docker Compose: obraz 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.
  4. V predvolenom stave môže každý čítať a zapisovať do všetkých tém: nastavte 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.
  5. Zálohujte 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.

Čo robí ntfy

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.

Terminál, prvá správa
curl -d "Backup finished" https://ntfy.example.com/backups

Licencie Apache 2.0 a GPLv2 a ochranná známka

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á.

Zdroje, s ktorými treba počítať

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:

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ť.

Inštalácia cez Docker Compose

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:

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

Potom konfiguračný súbor etc/server.yml s verejnou adresou vášho servera:

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
Terminál, v priečinku so súborom compose.yaml
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Server odpovie {"healthy":true,"role":"active"}. Čo robí ktoré nastavenie:

Bez Dockeru: repozitár pre Debian a Ubuntu

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:

Terminál
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".

Používatelia, riadenie prístupu a tokeny

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.

Terminál, prvý správca
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.

Jeden používateľ a jeden token na skript

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:

Terminál
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

Skript potom publikuje so svojím tokenom, cez HTTPS:

Terminál, na stroji, ktorý publikuje
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ť.

HTTPS: reverzná proxy

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:

S Caddy

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:

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

S Nginx

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:

/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;
    }
}
Terminál
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 pre Android, iOS a web

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.

Okamžité upozornenia na iOS

Pridajte do server.yml jeden riadok a potom reštartujte kontajner:

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

Limity požiadaviek a prílohy

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:

NastaveniePredvolenéČo obmedzuje
visitor-request-limit-burst60Požiadavky návštevníka v jednej dávke
visitor-request-limit-replenish5sRýchlosť dopĺňania: jedna požiadavka každých 5 sekúnd
visitor-subscription-limit30Otvorené spojenia na návštevníka
visitor-message-daily-limitŽiadnySprávy za deň, inak riadené limitom požiadaviek
visitor-email-limit-burst16E-maily v jednej dávke, potom jeden za hodinu
visitor-attachment-total-size-limit100MÚložisko príloh na návštevníka
visitor-attachment-daily-bandwidth-limit500MPrenos príloh na návštevníka za deň
global-topic-limit15 000Celkový počet tém na serveri
message-size-limit4KVeľkosť správy; nad ňou sa správa stáva prílohou

E-mailové upozornenia

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.

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"
Terminál
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

Zálohy

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 obsahujeZálohovať
etc/server.ymlKonfiguráciu, vrátane tajných údajov SMTP a kľúčov Web PushÁno
lib/user.dbPoužívateľov, záznamy riadenia prístupu, tokeny a denné počtyÁno
lib/cache.dbSprávy z posledných 12 hodín, v predvolenom staveUžitočné, ich životnosť je krátka
lib/attachments/Prílohy z posledných 3 hodín, v predvolenom staveUžitočné, ich životnosť je krátka
Súbor web-push-fileOdbery 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:

Terminál, v priečinku so súborom compose.yaml
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.

Aktualizácie

S Dockerom zmeňte tag obrazu v compose.yaml, napríklad z v2.38.1 na ďalšiu verziu, a potom:

Terminál, v priečinku so súborom compose.yaml
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.

Kto čo robí na Managed VPS

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émaNaše tímyVy
ServerAktualizácie systému a zabezpečenia, vrátane zásahov na serveriČas, ktorý vyhovuje vašej činnosti
DohľadServer 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
ntfyProaktívne sledovanie: chyby, spomalenia, otvorené spojenia a miesto na disku, s odporúčanou opravouJeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent
PrístupyServer, ktorý ich nesie, sledovaný a zálohovanýPoužívatelia, oprávnenia k témam a tokeny vašich skriptov
ZálohyKaždú noc, šifrované a uchovávané mimo stroja; obnova je v ceneKópie špecifické pre ntfy a žiadosť o obnovu, keď ju potrebujete
MigráciaVáš 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.

ntfy na serveri, o ktorý sa staráme za vás

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.

Objaviť Managed VPS

Časté otázky

Je ntfy pre firmu zadarmo?

Á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ží.

Ako nainštalovať ntfy cez Docker Compose?

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.

Ako urobiť server ntfy súkromným?

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.

Ako publikovať do ntfy zo skriptu s tokenom?

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.

Prečo v ntfy nastaviť behind-proxy?

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.

Prídu upozornenia ntfy na iPhone okamžite?

Á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.

Ako zálohovať ntfy?

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é.

Pokrýva Managed VPS aj ntfy?

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.

Kontaktujte nás