Hostati ntfy na Managed VPS-u znači slati push obavijesti običnim HTTP zahtjevom, PUT ili POST, sa stroja koji je vaš, a koji naši timovi održavaju ažurnim i nadziru danju i noću. ntfy je slobodan softver s dvojnom licencom, Apache 2.0 i GPLv2. Ovaj vodič prati njegovu službenu dokumentaciju u inačici 2.38.1: instalaciju s Docker Composeom, datoteku server.yml, korisnike i kontrolu pristupa, pristupne tokene, HTTPS, mobilne aplikacije, e-poštu, sigurnosne kopije i ažuriranja.
Autor: Simon Vasconcelos Lee
Objavljeno 21. studenoga 2026.Vrijeme čitanja: 15 minuta
binwiederhier/ntfy, datoteka server.yml s base-url, cache-file i auth-file te port objavljen na 127.0.0.1 iza obrnutog proxyja s HTTPS-om.auth-default-access: deny-all, naredbom ntfy user add stvorite administratora, a zatim svakoj skripti dodijelite vlastiti token i ograničene dozvole.server.yml i user.db, koji sadrže konfiguraciju, korisnike, dozvole i tokene; ažurirajte promjenom oznake slike, nakon čitanja bilješki o izdanju.ntfy, koji se izgovara „notify”, usluga je obavijesti po načelu objave i pretplate, zasnovana na HTTP-u. Njegov README predstavlja ga kao način slanja obavijesti na telefon ili računalo iz skripti, s bilo kojeg računala. Projekt održava javnu instancu, ntfy.sh, a poslužitelj možete hostati i sami: o tome govori ovaj vodič.
curl, skripte, zakazanog zadatka ili druge aplikacije. Poruka može imati naslov, prioritet od 1 do 5, oznake i emojije, privitak, gumbe za radnje ili odgođeno vrijeme isporuke.ntfy ili API, putem WebSocketa ili HTTP toka koji ostaje otvoren.curl -d "Backup finished" https://ntfy.example.com/backups
README projekta ntfy navodi da je projekt pod dvojnom licencom: pod licencom Apache 2.0, u datoteci LICENSE, i pod GNU GPL-om verzije 2, u datoteci LICENSE.GPLv2. Docker slika navodi obje, Apache-2.0, GPL-2.0.
Pokretanje programa ntfy na vašem poslužitelju, za vašu tvrtku, tim ili klijente, stoga ne zahtijeva kupnju nikakve licence. Oba teksta pružaju softver bez jamstva.
Licenca obuhvaća kod. Naziv je zasebno pitanje: licenca Apache 2.0 ne daje nikakva prava na zaštitne znakove davatelja licence, a uvjeti korištenja usluge ntfy.sh navode da su naziv, logotip i vizualni identitet ntfy zaštitni znakovi tvrtke ntfy LLC, čija uporaba u vezi s proizvodom ili uslugom zahtijeva njezinu prethodnu pisanu suglasnost. Ovaj vodič navodi naziv ntfy kako bi opisao softver.
Ova je publikacija neovisna o projektu ntfy i tvrtki ntfy LLC te nije s njima povezana, niti su je oni sponzorirali ili odobrili.
Poslužitelj je jedna, statički povezana binarna datoteka za amd64, armv7 i arm64; Docker slika postoji i za armv6. Dokumentacija ne navodi brojke za memoriju ni procesor: za kućni poslužitelj, kaže, razmjeri nisu razlog za brigu. Umjesto toga navodi što ograničava instancu:
nofile. Usluga systemd iz paketa postavlja ga na 10 000.Na Managed VPS-u opišite nam svoju uporabu, broj pretplaćenih uređaja, količinu poruka i privitke, a mi vam preporučujemo odgovarajuću veličinu.
Dokumentacija nudi sliku binwiederhier/ntfy s Docker Huba. Ona poslužuje web-aplikaciju i API na portu 80 kontejnera i ne sadrži datoteku server.yml: konfiguracija ide u mapu montiranu na /etc/ntfy. Na poslužitelju s instaliranim Dockerom stvorite mapu i u nju stavite ovaj compose.yaml, izrađen prema primjeru iz dokumentacije:
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
Zatim konfiguracijska datoteka, u etc/server.yml, s javnom adresom vašeg poslužitelja:
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
Poslužitelj odgovara {"healthy":true,"role":"active"}. Što radi svaka postavka:
127.0.0.1:2586: Docker primjeri u dokumentaciji objavljuju port 80 na svim adresama, a njezini primjeri obrnutog proxyja prosljeđuju na 127.0.0.1:2586. Ovako objavljen port dostupan je samo sa samog poslužitelja, a API se doseže isključivo preko obrnutog proxyja, putem HTTPS-a.base-url: javna adresa usluge. Ogledna datoteka server.yml zahtijeva je za privitke, slanje e-pošte i iOS obavijesti s poslužitelja koji hostate sami.cache-file: bez nje poruke ostaju u memoriji 12 sati i gube se pri ponovnom pokretanju. Ta predmemorija omogućuje telefonima s nestabilnom vezom da dohvate poruke koje su propustili.attachment-cache-dir: uključuje privitke. ntfy preuzima potpunu kontrolu nad tom mapom, pa je namijenite samo toj svrsi.auth-file i auth-default-access: deny-all: baza korisnika i dozvola, stvorena pri prvom pokretanju, i anonimni pristup odbijen prema zadanim postavkama. To je postavka koju dokumentacija preporučuje za privatnu instancu.behind-proxy: bez nje, iza proxyja, svi posjetitelji dijele IP adresu proxyja i ista ograničenja zahtjeva.enable-login: omogućuje prijavu u web-aplikaciju. Otvorena registracija ostaje zatvorena jer enable-signup ima zadanu vrijednost false.v2.38.1 fiksira inačicu; latest prati najnovije izdanje. Dokumentacija nudi i user: UID:GID za račun koji nije root: datoteke u etc i lib tada pripadaju njemu.Projekt objavljuje i repozitorij paketa, potpisan ključem s otiskom 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Na poslužitelju 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
Paket čita /etc/ntfy/server.yml. Ogledna datoteka preporučuje /var/cache/ntfy/cache.db za predmemoriju i /var/lib/ntfy/user.db za korisnike, dvije mape koje paket stvara. Iza proxyja dodajte listen-http: "127.0.0.1:2586".
Nakon instalacije poslužitelj ntfy je otvoren: svatko može čitati i pisati u svaku temu, a naziv teme služi kao lozinka. S auth-file i deny-all ništa ne prolazi bez vjerodajnica. ntfy ima dvije uloge: admin, koja čita i piše u sve teme, i user, koja ima samo dozvole koje joj dodijelite.
docker compose exec ntfy ntfy user add --role=admin alice
Naredba traži lozinku, a zatim njezinu potvrdu. Naredbe ntfy user, ntfy access i ntfy token pišu izravno u bazu korisnika: pokreću se na poslužitelju, ovdje unutar kontejnera, koji putanju te baze čita iz server.yml.
Pristupni token trenutačno daje puni pristup računu svojeg korisnika, osim promjene lozinke i brisanja računa. Za skriptu stvorite namjenskog korisnika, ograničenog na njezine teme, a zatim token za njega:
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 ili deny, na određenu temu ili na uzorak poput alerts-*, jedini podržani zamjenski znak.everyone, odnosno *. Za UnifiedPush na privatnoj instanci dokumentacija otvara teme koje počinju s up samo za pisanje: ntfy access '*' 'up*' write-only.tk_, mogu isteći s --expires=30d, a svaki korisnik može ih imati do 60. ntfy token list ih prikazuje, ntfy token remove briše jedan od njih.auth-users, auth-access i auth-tokens stvaraju iste objekte iz server.yml, pri svakom pokretanju. Korisnik uklonjen s tog popisa briše se iz baze pri sljedećem ponovnom pokretanju.Skripta zatim objavljuje sa svojim tokenom, putem HTTPS-a:
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Title: Backup finished" \
-H "Priority: high" \
-d "The nightly backup went fine." \
https://ntfy.example.com/backups
Lozinka za Basic auth samo je kodirana u base64, a ne šifrirana: dokumentacija traži HTTPS na svakom poslužitelju koji hostate sami. O tome govori sljedeći odjeljak.
ntfy može sam posluživati HTTPS, ali iza proxyja dokumentacija preporučuje da završetak TLS-a prepustite proxyju. Dvije točke važnije su od svih ostalih:
Upgrade i Connection i ostavlja te duge veze živima. ntfy prema zadanim postavkama svakih 45 sekundi šalje poruku za održavanje veze, keepalive-interval, kako ih nijedan posrednik ne bi zatvorio zbog neaktivnosti.behind-proxy: true ntfy čita zaglavlje X-Forwarded-For i zadržava krajnju desnu adresu, onu koju dodaje vaš proxy. Ograničenja zahtjeva primjenjuju se na tu adresu.Dokumentacija napominje da Caddy s reverse_proxy obrađuje i HTTP i WebSockete, bez dodatnih postavki. Certifikat Let’s Encrypt pribavlja sam:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Ovaj blok slijedi konfiguraciju iz dokumentacije, blisku onoj koju koristi ntfy.sh: međuspremanje isključeno za tokove, vremenska ograničenja od 3 minute i bez ograničenja veličine tijela zahtjeva, koje ntfy sam ograničava. Sluša na portu 80 kako bi Certbot mogao postaviti 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
Kada HTTP preusmjerava na HTTPS, u skriptama objavljujte na adrese https://. Za tisuće pretplatnika dokumentacija podiže worker_connections u nginx.conf i LimitNOFILE usluge Nginx na dvostruki ciljani broj veza.
Aplikacije ntfy dodaju teme s vašeg poslužitelja jednako kao s ntfy.sh: pri dodavanju teme unesite adresu poslužitelja, a za zaštićenu temu korisničko ime i lozinku korisnika koji joj ima pristup. Web-aplikacija poslužuje se na adresi samog poslužitelja.
ntfy webpush keys i valjan HTTPS certifikat.Dodajte jedan redak u server.yml, a zatim ponovno pokrenite kontejner:
upstream-base-url: "https://ntfy.sh"
Za svaku poruku vaš poslužitelj tada na ntfy.sh objavljuje zahtjev za provjeru, koji sadrži samo ID poruke i SHA-256 sažetak URL-a teme. ntfy.sh ga prosljeđuje uređaju putem Appleove usluge obavijesti, a zatim aplikacija dohvaća poruku s vašeg poslužitelja. Tekst koji prolazi kroz ntfy.sh uvijek je isti, „New message”, bez obzira na sadržaj vaše poruke. Bez te postavke obavijesti i dalje stižu, s kašnjenjem koje, ovisno o stanju telefona, može doseći nekoliko sati. upstream-access-token dodaje token ako premašite ograničenja zahtjeva na ntfy.sh.
ntfy ograničava svakog posjetitelja, kojeg prepoznaje po IP adresi, a za IPv6 po podmreži /64. Ta ograničenja štite poslužitelj od zlouporabe; pri uobičajenoj uporabi, prema dokumentaciji, ne biste ih trebali dosegnuti. Kad ih premašite, poslužitelj odgovara 429 Too Many Requests. Zadane vrijednosti:
| Postavka | Zadano | Što ograničava |
|---|---|---|
visitor-request-limit-burst | 60 | Zahtjevi posjetitelja u jednom naletu |
visitor-request-limit-replenish | 5s | Brzina obnavljanja: jedan zahtjev svakih 5 sekundi |
visitor-subscription-limit | 30 | Otvorene veze po posjetitelju |
visitor-message-daily-limit | Nema | Poruke dnevno, inače uređene ograničenjem zahtjeva |
visitor-email-limit-burst | 16 | E-poruke u jednom naletu, zatim jedna na sat |
visitor-attachment-total-size-limit | 100M | Prostor za privitke po posjetitelju |
visitor-attachment-daily-bandwidth-limit | 500M | Promet privitaka po posjetitelju dnevno |
global-topic-limit | 15 000 | Ukupan broj tema na poslužitelju |
message-size-limit | 4K | Veličina poruke; iznad nje poruka postaje privitak |
visitor-request-limit-exempt-hosts, popisom IP adresa ili naziva hostova.ntfy tier, nekim računima daju viša ograničenja.attachment-file-size-limit, zadano 15M, ograničava svaku datoteku, attachment-total-size-limit, 5G, cijelu pohranu, a attachment-expiry-duration, 3h, njihov vijek trajanja. Privitak nikada ne nadživi svoju poruku: kako biste privitke čuvali dulje, povećajte i cache-duration.ntfy može proslijediti poruku e-poštom kada zahtjev za objavu nosi zaglavlje Email, ili X-Email, s adresom. Za to koristi poslužitelj za odlaznu SMTP poštu, putem STARTTLS-a, s autentifikacijom PLAIN ili LOGIN: to je port 587. S Simafri VPS-a pošta odlazi preko autentificiranog SMTP releja na istom portu 587: ovdje unesite adresu računa e-pošte koji već imate ili adresu svoje usluge slanja.
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 i smtp-sender-from obvezni su čim je postavljen smtp-sender-addr: bez njih se poslužitelj odbija pokrenuti.smtp-sender-verify: true ograničava slanje na adrese koje je svaki korisnik potvrdio u svojem računu i zatvara ga za anonimne korisnike.server.yml: neka tu datoteku može čitati samo njezin vlasnik, uz chmod 600.Uz SQLite ntfy svaku vrstu podataka čuva u vlastitoj datoteci. U instalaciji iz ovog vodiča sve se nalazi u mapama etc i lib, pokraj datoteke compose.yaml:
| Stavka | Što sadrži | Sigurnosna kopija |
|---|---|---|
etc/server.yml | Konfiguraciju, uključujući SMTP tajne i ključeve za Web Push | Da |
lib/user.db | Korisnike, unose kontrole pristupa, tokene i dnevne brojače | Da |
lib/cache.db | Poruke iz posljednjih 12 sati, prema zadanim postavkama | Korisna, vijek trajanja je kratak |
lib/attachments/ | Privitke iz posljednja 3 sata, prema zadanim postavkama | Korisna, vijek trajanja je kratak |
Datoteka web-push-file | Pretplate preglednika na Web Push, ako ste ga uključili | Da |
Za dosljednu kopiju SQLite datoteka zaustavite uslugu dok se arhiva izrađuje:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Zakažite ovu kopiju u mirno doba i šaljite je izvan poslužitelja. Pohranjene na njegovu disku, te su arhive i dio njegovih noćnih sigurnosnih kopija. Za vraćanje vratite mape na mjesto, a zatim pokrenite docker compose up -d.
Ako izgubite user.db bez kopije, korisnici i tokeni deklarirani u server.yml putem auth-users i auth-tokens obnavljaju se pri pokretanju; one stvorene u naredbenom retku treba ponovno stvoriti.
S Dockerom promijenite oznaku slike u compose.yaml, na primjer s v2.38.1 na sljedeću inačicu, a zatim:
docker compose pull
docker compose up -d
Mape etc i lib ostaju na mjestu, a ntfy sam migrira svoje baze pri pokretanju. S paketom za Debian isto rade sudo apt update i zatim sudo apt upgrade.
Bilješke svake inačice, na stranici „Releases” u dokumentaciji, pod naslovom „Upgrade notes” okupljaju ono što se mijenja za postojeću instancu, na primjer u 2.36.0 konfiguraciju koja se odsad u cijelosti provjerava pri pokretanju ili poništene dnevne brojače. Pročitajte ih prije ažuriranja i neposredno prije toga kopirajte obje mape. Inačica 2.38.1 sigurnosno je izdanje koje projekt izričito preporučuje: ojačava predloške poruka protiv napada uskraćivanjem usluge i sprječava da spora učitavanja privitaka u S3 i krajnje točke za web push koje ne odgovaraju zauzimaju memoriju i veze. Slijedi inačicu 2.38.0, koja dijeli ograničenja zahtjeva među čvorovima klastera i izgrađena je s Go 1.27.4.
Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; ntfy ostaje vaš softver, sa svojim postavkama i podacima.
| Tema | Naši timovi | Vi |
|---|---|---|
| Poslužitelj | Ažuriranja sustava i sigurnosti, uključujući intervencije na poslužitelju | Trenutak koji odgovara vašem poslovanju |
| Nadzor | Poslužitelj pod nadzorom 24 sata dnevno, 7 dana u tjednu, s intervencijom bez čekanja vašeg poziva | Čitanje zapisnika vaše instance |
| ntfy | Proaktivno praćenje: uočene pogreške, usporavanja, otvorene veze i prostor na disku, preporučen ispravak | Njegova instalacija, ažuriranja i postavke, koje primjenjujete vi ili vaš AI asistent |
| Pristupi | Poslužitelj koji ih nosi, nadziran i sigurnosno kopiran | Korisnici, dozvole za teme i tokeni vaših skripti |
| Sigurnosne kopije | Svake noći, šifrirane i čuvane izvan stroja; vraćanje uključeno | Kopije specifične za ntfy i zahtjev za vraćanje, kada vam zatreba |
| Migracija | Vaš trenutačni poslužitelj migriran, besplatno | Trenutak prelaska |
Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.
Uz Simafri Managed VPS naši timovi održavaju poslužitelj vaše instance ntfy ažurnim, nadziru ga danju i noću i interveniraju bez čekanja vašeg poziva; uz to proaktivno prate vašu instancu i preporučuju vam korisne ispravke, koje primjenjujete vi ili vaš AI asistent. Sigurnosne kopije svake se noći šifriraju i čuvaju izvan stroja, njihovo vraćanje je uključeno, a migracija vašeg trenutačnog poslužitelja je besplatna.
Da. ntfy je pod dvojnom licencom, Apache 2.0 i GPLv2: možete ga pokretati u tvrtki bez kupnje licence. Njihovi se uvjeti odnose na daljnju distribuciju softvera. Ostaje trošak poslužitelja na kojem radi.
Stvorite compose.yaml sa slikom binwiederhier/ntfy, naredbom serve, mapom montiranom na /etc/ntfy za server.yml, drugom na /var/lib/ntfy za baze podataka i portom 80 kontejnera objavljenim na 127.0.0.1:2586. Pokrenite docker compose up -d, a zatim ispred tog porta postavite obrnuti proxy s HTTPS-om.
U server.yml postavite auth-file i auth-default-access: deny-all. Zatim stvorite administratora naredbom ntfy user add --role=admin, korisnike s ograničenim pristupom naredbom ntfy user add, a njihove dozvole za teme naredbom ntfy access.
Stvorite token naredbom ntfy token add za korisnika namijenjenog skripti, ograničenog na njezine teme, a zatim objavljujte s curl i zaglavljem Authorization: Bearer iza kojeg slijedi token, putem HTTPS-a. Token daje pristup cijelom računu svojeg korisnika.
Iza obrnutog proxyja svaki zahtjev dolazi s adrese proxyja. S behind-proxy: true ntfy čita zaglavlje X-Forwarded-For kako bi prepoznao svakog posjetitelja; bez toga svi dijele ista ograničenja zahtjeva.
Da, s upstream-base-url: "https://ntfy.sh" u server.yml. Vaš poslužitelj tada preko ntfy.sh prosljeđuje signal koji sadrži samo ID poruke, a aplikacija dohvaća poruku s vašeg poslužitelja. Bez te postavke isporuka može trajati nekoliko sati.
Sigurnosno kopirajte server.yml i user.db, koji sadrže konfiguraciju, korisnike, dozvole i tokene, te datoteku za Web Push ako je uključen. Predmemorija poruka i privitci imaju kratak vijek trajanja. Tijekom kopiranja zaustavite uslugu kako bi SQLite datoteke bile dosljedne.
Managed VPS pokriva poslužitelj: sustav, sigurnost, nadzor i sigurnosne kopije. Naši timovi proaktivno prate i vašu instancu te vam preporučuju korisne ispravke, koje primjenjujete vi. Intervencija u aplikaciji naplaćuje se po satu ili paušalno.
Simafri
Porazgovarajmo o Vašem projektu
Recite nam u nekoliko riječi što trebate: javljamo Vam se brzo.
Hvala! Vaš upit je poslan. Javit ćemo vam se uskoro.
Više volite e-mail? Pišite nam na support@simafri.com.