Hostovat ntfy na Managed VPS znamená posílat push oznámení obyčejným požadavkem HTTP, PUT nebo POST, z vlastního stroje, který naše týmy udržují aktuální a ve dne i v noci hlídají. ntfy je svobodný software s dvojí licencí, Apache 2.0 a GPLv2. Tento průvodce sleduje jeho oficiální dokumentaci ve verzi 2.38.1: instalaci pomocí Docker Compose, soubor server.yml, uživatele a řízení přístupu, přístupové tokeny, HTTPS, mobilní aplikace, e-mail, zálohy a aktualizace.
Autor: Simon Vasconcelos Lee
Publikováno 21. listopadu 2026Doba čtení: 15 minut
binwiederhier/ntfy, soubor server.yml s base-url, cache-file a auth-file a port publikovaný na 127.0.0.1 za reverzní proxy s HTTPS.auth-default-access: deny-all, vytvořte správce příkazem ntfy user add a pak dejte každému skriptu vlastní token a omezená oprávnění.server.yml a user.db, které obsahují konfiguraci, uživatele, oprávnění a tokeny; aktualizujte změnou tagu obrazu, po přečtení poznámek k vydání.ntfy, vyslovováno „notify“, je notifikační služba typu publikace a odběr, postavená na HTTP. Jeho README ho představuje jako způsob, jak posílat oznámení na telefon nebo počítač ze skriptů, z jakéhokoli počítače. Projekt provozuje veřejnou instanci ntfy.sh a server lze hostovat samostatně: tomu se věnuje tento průvodce.
curl, skriptu, plánované úlohy nebo jiné aplikace. Zpráva může nést název, prioritu od 1 do 5, štítky a emoji, přílohu, akční tlačítka nebo odložený čas doručení.ntfy nebo API, přes WebSocket nebo HTTP stream, který zůstává otevřený.curl -d "Backup finished" https://ntfy.example.com/backups
README projektu ntfy uvádí, že projekt má dvojí licenci: licenci Apache 2.0 v souboru LICENSE a GNU GPL verze 2 v souboru LICENSE.GPLv2. Obraz Docker deklaruje obě, Apache-2.0, GPL-2.0.
Provozovat ntfy na vašem serveru, pro vaši firmu, tým nebo klienty, tedy nevyžaduje nákup žádné licence. Oba texty poskytují software bez záruky.
Licence se vztahuje na kód. Název je samostatná věc: licence Apache 2.0 neuděluje žádná práva k ochranným známkám poskytovatele licence a podmínky služby ntfy.sh uvádějí, že název, logo a vizuální identita ntfy jsou ochrannými známkami společnosti ntfy LLC, jejichž použití v souvislosti s produktem nebo službou vyžaduje její předchozí písemný souhlas. Tento průvodce uvádí název ntfy k popisu softwaru.
Tato publikace je nezávislá na projektu ntfy i na ntfy LLC: není s nimi přidružena a není jimi sponzorována ani schválena.
Server je jediný, staticky linkovaný binární soubor pro amd64, armv7 a arm64; obraz Docker existuje i pro armv6. Dokumentace neuvádí žádné údaje o paměti ani o CPU: u domácího serveru se podle ní o škálování není třeba starat. Místo toho uvádí, co instanci omezuje:
nofile. Služba systemd z balíčku ho nastavuje na 10 000.Na Managed VPS nám popište své využití, počet odebírajících zařízení, objem zpráv a přílohy a doporučíme vám vhodnou velikost.
Dokumentace nabízí obraz binwiederhier/ntfy z Docker Hubu. Servíruje webovou aplikaci a API na portu 80 kontejneru a neobsahuje žádný soubor server.yml: konfigurace patří do složky připojené do /etc/ntfy. Na serveru s nainstalovaným Dockerem vytvořte složku a vložte do ní tento compose.yaml, vycházející z příkladu v dokumentaci:
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
Pak konfigurační soubor etc/server.yml s veřejnou adresou vašeho serveru:
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 odpoví {"healthy":true,"role":"active"}. Co které nastavení dělá:
127.0.0.1:2586: příklady pro Docker v dokumentaci publikují port 80 na všech adresách a její příklady reverzní proxy přeposílají na 127.0.0.1:2586. Takto publikovaný port je dosažitelný jen ze samotného serveru a k API se dostanete výhradně přes reverzní proxy, přes HTTPS.base-url: veřejná adresa služby. Vzorový soubor server.yml ji vyžaduje pro přílohy, odesílání e-mailů a oznámení pro iOS ze samostatně hostovaného serveru.cache-file: bez něj zůstávají zprávy 12 hodin v paměti a při restartu se ztratí. Tato mezipaměť umožní telefonům s nestabilním připojením stáhnout zprávy, které zmeškaly.attachment-cache-dir: zapíná přílohy. ntfy nad touto složkou přebírá plnou kontrolu, vyhraďte ji tedy jen pro tento účel.auth-file a auth-default-access: deny-all: databáze uživatelů a oprávnění, vytvořená při prvním spuštění, a anonymní přístup ve výchozím stavu odepřený. Toto nastavení dokumentace doporučuje pro soukromou instanci.behind-proxy: bez něj za proxy sdílejí všichni návštěvníci IP adresu proxy a stejné limity požadavků.enable-login: umožňuje přihlášení do webové aplikace. Volná registrace zůstává zavřená, protože enable-signup má výchozí hodnotu false.v2.38.1 zafixuje verzi; latest sleduje nejnovější vydání. Dokumentace nabízí také user: UID:GID pro jiný účet než root: soubory v etc a lib pak patří jemu.Projekt také zveřejňuje repozitář balíčků, podepsaný klíčem s otiskem 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Na serveru 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íček čte /etc/ntfy/server.yml. Vzorový soubor doporučuje /var/cache/ntfy/cache.db pro mezipaměť a /var/lib/ntfy/user.db pro uživatele, dvě složky, které balíček vytvoří. Za proxy přidejte listen-http: "127.0.0.1:2586".
Po instalaci je server ntfy otevřený: každý může číst a zapisovat do všech témat a název tématu slouží jako heslo. S auth-file a deny-all neprojde nic bez přihlašovacích údajů. ntfy má dvě role: admin, která čte a zapisuje do všech témat, a user, která má jen oprávnění, jež jí udělíte.
docker compose exec ntfy ntfy user add --role=admin alice
Příkaz si vyžádá heslo a pak jeho potvrzení. Příkazy ntfy user, ntfy access a ntfy token zapisují přímo do databáze uživatelů: spouštějí se na serveru, zde uvnitř kontejneru, který cestu k této databázi čte ze server.yml.
Přístupový token v současnosti dává plný přístup k účtu svého uživatele, kromě změny hesla a smazání účtu. Pro skript vytvořte vyhrazeného uživatele, omezeného na jeho témata, a pak pro něj 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 nebo deny, na konkrétní téma nebo na vzor jako alerts-*, jediný podporovaný zástupný znak.everyone, neboli *. Pro UnifiedPush na soukromé instanci dokumentace otevírá témata začínající na up pouze pro zápis: ntfy access '*' 'up*' write-only.tk_, mohou vypršet díky --expires=30d a každý uživatel jich může mít až 60. ntfy token list je vypíše, ntfy token remove jeden z nich smaže.auth-users, auth-access a auth-tokens tytéž objekty ze server.yml, při každém spuštění. Uživatel odebraný z tohoto seznamu je při příštím restartu smazán z databáze.Skript pak publikuje se svým tokenem, přes 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 pouze zakódované v base64, nikoli zašifrované: dokumentace vyžaduje HTTPS na každém samostatně hostovaném serveru. Tomu se věnuje další oddíl.
ntfy umí HTTPS obsluhovat sám, ale za proxy dokumentace doporučuje nechat ukončení TLS na proxy. Nejvíce záleží na dvou bodech:
Upgrade a Connection a nechává tato dlouhá spojení žít. ntfy ve výchozím stavu posílá každých 45 sekund udržovací zprávu, keepalive-interval, aby je žádný prostředník neuzavřel kvůli nečinnosti.behind-proxy: true čte ntfy hlavičku X-Forwarded-For a bere z ní adresu nejvíce vpravo, tu, kterou přidává vaše proxy. Limity požadavků se vztahují na tuto adresu.Dokumentace poznamenává, že Caddy zvládá HTTP i WebSockety direktivou reverse_proxy, bez dalšího nastavení. Certifikát Let’s Encrypt si obstará sám:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Tento blok vychází z konfigurace v dokumentaci, blízké té, kterou používá ntfy.sh: vypnuté bufferování pro streamy, časové limity 3 minuty a žádný limit velikosti těla požadavků, které ntfy omezuje sám. Naslouchá na portu 80, aby Certbot mohl nastavit 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
Jakmile HTTP přesměrovává na HTTPS, publikujte ve skriptech na adresy https://. Pro tisíce odběratelů dokumentace zvyšuje worker_connections v nginx.conf a LimitNOFILE služby Nginx na dvojnásobek cílového počtu spojení.
Aplikace ntfy přidávají témata z vašeho serveru stejně jako z ntfy.sh: při přidání tématu zadejte adresu serveru a u chráněného tématu uživatelské jméno a heslo uživatele, který k němu má přístup. Webová aplikace se servíruje na adrese samotného serveru.
ntfy webpush keys a platný certifikát HTTPS.Přidejte do server.yml jeden řádek a pak restartujte kontejner:
upstream-base-url: "https://ntfy.sh"
U každé zprávy pak váš server publikuje na ntfy.sh dotazovací požadavek, který obsahuje jen ID zprávy a hash SHA-256 adresy URL tématu. ntfy.sh ho předá zařízení přes notifikační službu Apple a aplikace si pak zprávu stáhne z vašeho serveru. Text, který prochází přes ntfy.sh, je vždy stejný, „New message“, ať je ten váš jakýkoli. Bez tohoto nastavení oznámení přicházejí také, se zpožděním, které podle stavu telefonu může dosáhnout několika hodin. upstream-access-token přidá token, pokud překročíte limity požadavků ntfy.sh.
ntfy omezuje každého návštěvníka, identifikovaného podle IP adresy a u IPv6 podle podsítě /64. Tyto limity chrání server před zneužitím; při běžném používání byste na ně podle dokumentace narážet neměli. Po jejich překročení server odpoví 429 Too Many Requests. Výchozí hodnoty:
| Nastavení | Výchozí | Co omezuje |
|---|---|---|
visitor-request-limit-burst | 60 | Požadavky návštěvníka v jedné dávce |
visitor-request-limit-replenish | 5s | Rychlost doplňování: jeden požadavek každých 5 sekund |
visitor-subscription-limit | 30 | Otevřená spojení na návštěvníka |
visitor-message-daily-limit | Žádný | Zprávy za den, jinak řízené limitem požadavků |
visitor-email-limit-burst | 16 | E-maily v jedné dávce, pak jeden za hodinu |
visitor-attachment-total-size-limit | 100M | Úložiště příloh na návštěvníka |
visitor-attachment-daily-bandwidth-limit | 500M | Přenos příloh na návštěvníka za den |
global-topic-limit | 15 000 | Celkový počet témat na serveru |
message-size-limit | 4K | Velikost zprávy; nad ni se zpráva stává přílohou |
visitor-request-limit-exempt-hosts, seznamu IP adres nebo názvů hostitelů.ntfy tier, dávají některým účtům vyšší limity.attachment-file-size-limit, ve výchozím stavu 15M, omezuje každý soubor, attachment-total-size-limit, 5G, celé úložiště a attachment-expiry-duration, 3h, jejich životnost. Příloha nikdy nepřežije svou zprávu: chcete-li přílohy uchovávat déle, zvyšte také cache-duration.ntfy umí zprávu přeposlat e-mailem, když požadavek na publikaci nese hlavičku Email, nebo X-Email, s adresou. Používá k tomu odchozí server SMTP, přes STARTTLS, s ověřením PLAIN nebo LOGIN: to je port 587. Z VPS Simafri odchází pošta přes ověřené relé SMTP na stejném portu 587: zadejte sem adresu e-mailového účtu, který už máte, nebo adresu své odesílací 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 jsou povinné, jakmile je nastaveno smtp-sender-addr: bez nich se server odmítne spustit.smtp-sender-verify: true omezuje odesílání na adresy, které si každý uživatel ověřil ve svém účtu, a uzavírá ho pro anonymní uživatele.server.yml: ponechte tento soubor čitelný jen pro jeho vlastníka, příkazem chmod 600.Se SQLite uchovává ntfy každý druh dat ve vlastním souboru. V instalaci z tohoto průvodce je vše ve složkách etc a lib, vedle souboru compose.yaml:
| Položka | Co obsahuje | Zálohovat |
|---|---|---|
etc/server.yml | Konfiguraci, včetně tajných údajů SMTP a klíčů Web Push | Ano |
lib/user.db | Uživatele, záznamy řízení přístupu, tokeny a denní počty | Ano |
lib/cache.db | Zprávy z posledních 12 hodin, ve výchozím stavu | Užitečné, jejich životnost je krátká |
lib/attachments/ | Přílohy z posledních 3 hodin, ve výchozím stavu | Užitečné, jejich životnost je krátká |
Soubor web-push-file | Odběry Web Push z prohlížečů, pokud jste je zapnuli | Ano |
Pro konzistentní kopii souborů SQLite zastavte službu po dobu vytváření archivu:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Naplánujte tuto kopii na klidnou hodinu a posílejte ji mimo server. Uložené na jeho disku jsou tyto archivy navíc součástí jeho nočních záloh. Pro obnovu vraťte složky na místo a pak spusťte docker compose up -d.
Pokud ztratíte user.db bez kopie, uživatelé a tokeny deklarované v server.yml přes auth-users a auth-tokens se při spuštění obnoví; ty vytvořené na příkazovém řádku je třeba vytvořit znovu.
S Dockerem změňte tag obrazu v compose.yaml, například z v2.38.1 na další verzi, a pak:
docker compose pull
docker compose up -d
Složky etc a lib zůstávají na místě a ntfy své databáze při spuštění migruje sám. U balíčku pro Debian totéž udělají sudo apt update a pak sudo apt upgrade.
Poznámky ke každé verzi, na stránce „Releases“ dokumentace, shrnují pod nadpisem „Upgrade notes“ to, co se mění pro existující instanci, například ve verzi 2.36.0 konfiguraci nově plně kontrolovanou při spuštění nebo vynulované denní počty. Přečtěte si je před aktualizací a těsně předtím zkopírujte obě složky. Verze 2.38.1 je bezpečnostní vydání, které projekt důrazně doporučuje: zpevňuje šablony zpráv proti útokům typu odepření služby a brání tomu, aby pomalá nahrávání příloh do S3 a nereagující koncové body web push blokovala paměť a spojení. Navazuje na verzi 2.38.0, která sdílí limity požadavků mezi uzly clusteru a je sestavena s Go 1.27.4.
Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; ntfy zůstává vaším softwarem, s jeho nastavením a daty.
| Téma | Naše týmy | Vy |
|---|---|---|
| Server | Aktualizace systému a zabezpečení, včetně zásahů na serveru | Okamžik, který vyhovuje vašemu provozu |
| Dohled | Server sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše volání | Čtení protokolů vaší instance |
| ntfy | Proaktivní sledování: chyby, zpomalení, otevřená spojení a místo na disku zachycené, doporučená oprava | Jeho instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent |
| Přístupy | Server, který je nese, hlídaný a zálohovaný | Uživatelé, oprávnění k tématům a tokeny vašich skriptů |
| Zálohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Vlastní kopie ntfy a žádost o obnovu, když ji potřebujete |
| Migrace | Váš stávající server přenesen zdarma | Okamžik přepnutí |
Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.
S Managed VPS od Simafri udržují naše týmy server vaší instance ntfy aktuální, hlídají ho ve dne i v noci a zasahují bez čekání na vaše volání; vaši instanci také proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy nebo váš AI asistent. Zálohy se každou noc šifrují a uchovávají mimo stroj, jejich obnova je v ceně a migrace vašeho stávajícího serveru je zdarma.
Ano. ntfy má dvojí licenci, Apache 2.0 a GPLv2: ve firmě ho můžete provozovat, aniž byste kupovali licenci. Jejich podmínky se týkají dalšího šíření softwaru. Zbývají náklady na server, na kterém běží.
Vytvořte compose.yaml s obrazem binwiederhier/ntfy, příkazem serve, složkou připojenou do /etc/ntfy pro server.yml, další do /var/lib/ntfy pro databáze a portem 80 kontejneru publikovaným na 127.0.0.1:2586. Spusťte docker compose up -d a pak před tento port umístěte reverzní proxy s HTTPS.
V server.yml nastavte auth-file a auth-default-access: deny-all. Pak vytvořte správce příkazem ntfy user add --role=admin, uživatele s omezeným přístupem příkazem ntfy user add a jejich oprávnění k tématům příkazem ntfy access.
Vytvořte token příkazem ntfy token add pro uživatele vyhrazeného skriptu, omezeného na jeho témata, a pak publikujte přes curl s hlavičkou Authorization: Bearer, za kterou následuje token, přes HTTPS. Token dává přístup k celému účtu svého uživatele.
Za reverzní proxy přichází každý požadavek z adresy proxy. S behind-proxy: true čte ntfy hlavičku X-Forwarded-For, aby rozpoznal každého návštěvníka; bez toho sdílejí všichni stejné limity požadavků.
Ano, s upstream-base-url: "https://ntfy.sh" v server.yml. Váš server pak nechá ntfy.sh přeposlat signál, který obsahuje jen ID zprávy, a aplikace si zprávu stáhne z vašeho serveru. Bez tohoto nastavení může doručení trvat několik hodin.
Zálohujte server.yml a user.db, které obsahují konfiguraci, uživatele, oprávnění a tokeny, a také soubor Web Push, pokud je zapnutý. Mezipaměť zpráv a přílohy mají krátkou životnost. Během kopírování zastavte službu, aby byly soubory SQLite konzistentní.
Managed VPS pokrývá server: systém, zabezpečení, dohled a zálohy. Naše týmy také proaktivně sledují vaši instanci a doporučí vám užitečné opravy, které zapracujete vy. Zásah v samotné aplikaci se účtuje po hodinách nebo paušálem.
Simafri
Promluvme si o vašem záměru
Řekněte nám v pár slovech, co potřebujete: rychle se vám ozveme.
Děkujeme! Vaše zpráva byla odeslána. Brzy se vám ozveme.
Máte raději e-mail? Napište nám na support@simafri.com.