Hostovat ntfy na Managed VPS: push oznámení z vašeho vlastního serveru

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.

Simon Vasconcelos Lee Autor: Publikováno 21. listopadu 2026Doba čtení: 15 minut

Všichni průvodci

To nejdůležitější

  1. ntfy přijme zprávu přes požadavek HTTP PUT nebo POST na téma a okamžitě ji doručí telefonům, prohlížečům a skriptům, které toto téma odebírají.
  2. Jeho dvojí licence, Apache 2.0 a GPLv2, vám dovoluje volně ho provozovat v práci; její podmínky se týkají dalšího šíření softwaru.
  3. Nainstalujte ho pomocí Docker Compose: obraz 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.
  4. Ve výchozím stavu může každý číst a zapisovat do všech témat: nastavte 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í.
  5. Zálohujte 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í.

Co umí ntfy

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.

Terminál, první zpráva
curl -d "Backup finished" https://ntfy.example.com/backups

Licence Apache 2.0 a GPLv2 a ochranná známka

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.

Zdroje, se kterými počítat

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:

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.

Instalace pomocí Docker Compose

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:

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

Pak konfigurační soubor etc/server.yml s veřejnou adresou vašeho serveru:

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, ve složce se souborem compose.yaml
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Server odpoví {"healthy":true,"role":"active"}. Co které nastavení dělá:

Bez Dockeru: repozitář pro Debian a Ubuntu

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:

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íč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".

Uživatelé, řízení přístupu a tokeny

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.

Terminál, první správce
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.

Jeden uživatel a jeden token na skript

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:

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 pak publikuje se svým tokenem, přes HTTPS:

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

HTTPS: reverzní proxy

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:

S Caddy

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:

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

S Nginx

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:

/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

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 pro Android, iOS a web

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.

Okamžitá oznámení na iOS

Přidejte do server.yml jeden řádek a pak restartujte kontejner:

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

Limity požadavků a přílohy

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-burst60Požadavky návštěvníka v jedné dávce
visitor-request-limit-replenish5sRychlost doplňování: jeden požadavek každých 5 sekund
visitor-subscription-limit30Otevř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-burst16E-maily v jedné dávce, pak jeden za hodinu
visitor-attachment-total-size-limit100MÚložiště příloh na návštěvníka
visitor-attachment-daily-bandwidth-limit500MPřenos příloh na návštěvníka za den
global-topic-limit15 000Celkový počet témat na serveru
message-size-limit4KVelikost zprávy; nad ni se zpráva stává přílohou

E-mailová oznámení

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.

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

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žkaCo obsahujeZálohovat
etc/server.ymlKonfiguraci, včetně tajných údajů SMTP a klíčů Web PushAno
lib/user.dbUživatele, záznamy řízení přístupu, tokeny a denní počtyAno
lib/cache.dbZprávy z posledních 12 hodin, ve výchozím stavuUžitečné, jejich životnost je krátká
lib/attachments/Přílohy z posledních 3 hodin, ve výchozím stavuUžitečné, jejich životnost je krátká
Soubor web-push-fileOdběry Web Push z prohlížečů, pokud jste je zapnuliAno

Pro konzistentní kopii souborů SQLite zastavte službu po dobu vytváření archivu:

Terminál, ve složce se souborem compose.yaml
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.

Aktualizace

S Dockerem změňte tag obrazu v compose.yaml, například z v2.38.1 na další verzi, a pak:

Terminál, ve složce se souborem compose.yaml
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.

Kdo co dělá na Managed VPS

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émaNaše týmyVy
ServerAktualizace systému a zabezpečení, včetně zásahů na serveruOkamžik, který vyhovuje vašemu provozu
DohledServer sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše voláníČtení protokolů vaší instance
ntfyProaktivní sledování: chyby, zpomalení, otevřená spojení a místo na disku zachycené, doporučená opravaJeho instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent
PřístupyServer, který je nese, hlídaný a zálohovanýUživatelé, oprávnění k tématům a tokeny vašich skriptů
ZálohyKaždou noc, šifrované a uchovávané mimo stroj; obnova v ceněVlastní kopie ntfy a žádost o obnovu, když ji potřebujete
MigraceVáš stávající server přenesen zdarmaOkamž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.

ntfy na serveru, o který se staráme za vás

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.

Objevit Managed VPS

Časté otázky

Je ntfy pro firmu 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ěží.

Jak nainstalovat ntfy pomocí Docker Compose?

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.

Jak udělat server ntfy soukromým?

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.

Jak publikovat do ntfy ze skriptu s tokenem?

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.

Proč v ntfy nastavit behind-proxy?

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

Dorazí oznámení ntfy na iPhone okamžitě?

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.

Jak zálohovat ntfy?

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

Pokrývá Managed VPS i ntfy?

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.

Zdroje a oficiální dokumentace

Kontaktujte nás