Hostati ntfy na Managed VPS-u: push obavijesti s vlastitog poslužitelja

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.

Simon Vasconcelos Lee Autor: Objavljeno 21. studenoga 2026.Vrijeme čitanja: 15 minuta

Svi vodiči

Najvažnije

  1. ntfy prima poruku putem HTTP zahtjeva PUT ili POST upućenog temi i odmah je prosljeđuje telefonima, preglednicima i skriptama pretplaćenima na tu temu.
  2. Njegova dvojna licenca, Apache 2.0 i GPLv2, omogućuje vam da ga slobodno pokrećete na poslu; njezini se uvjeti odnose na daljnju distribuciju softvera.
  3. Instalirajte ga s Docker Composeom: slika 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.
  4. Prema zadanim postavkama svatko može čitati i pisati u svaku temu: postavite auth-default-access: deny-all, naredbom ntfy user add stvorite administratora, a zatim svakoj skripti dodijelite vlastiti token i ograničene dozvole.
  5. Sigurnosno kopirajte server.yml i user.db, koji sadrže konfiguraciju, korisnike, dozvole i tokene; ažurirajte promjenom oznake slike, nakon čitanja bilješki o izdanju.

Što radi ntfy

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

Terminal, prva poruka
curl -d "Backup finished" https://ntfy.example.com/backups

Licence Apache 2.0 i GPLv2 te zaštitni znak

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.

Resursi koje treba predvidjeti

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:

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.

Instalacija s Docker Composeom

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:

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

Zatim konfiguracijska datoteka, u etc/server.yml, s javnom adresom vašeg poslužitelja:

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
Terminal, u mapi s datotekom compose.yaml
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Poslužitelj odgovara {"healthy":true,"role":"active"}. Što radi svaka postavka:

Bez Dockera: repozitorij za Debian i Ubuntu

Projekt objavljuje i repozitorij paketa, potpisan ključem s otiskom 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Na poslužitelju amd64:

Terminal
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".

Korisnici, kontrola pristupa i tokeni

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.

Terminal, prvi administrator
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.

Jedan korisnik i jedan token po skripti

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:

Terminal
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

Skripta zatim objavljuje sa svojim tokenom, putem HTTPS-a:

Terminal, na stroju koji objavljuje
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.

HTTPS: obrnuti proxy

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:

S Caddyjem

Dokumentacija napominje da Caddy s reverse_proxy obrađuje i HTTP i WebSockete, bez dodatnih postavki. Certifikat Let’s Encrypt pribavlja sam:

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

S Nginxom

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:

/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;
    }
}
Terminal
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 za Android, iOS i web

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.

Trenutačne obavijesti na iOS-u

Dodajte jedan redak u server.yml, a zatim ponovno pokrenite kontejner:

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

Ograničenja zahtjeva i privitci

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:

PostavkaZadanoŠto ograničava
visitor-request-limit-burst60Zahtjevi posjetitelja u jednom naletu
visitor-request-limit-replenish5sBrzina obnavljanja: jedan zahtjev svakih 5 sekundi
visitor-subscription-limit30Otvorene veze po posjetitelju
visitor-message-daily-limitNemaPoruke dnevno, inače uređene ograničenjem zahtjeva
visitor-email-limit-burst16E-poruke u jednom naletu, zatim jedna na sat
visitor-attachment-total-size-limit100MProstor za privitke po posjetitelju
visitor-attachment-daily-bandwidth-limit500MPromet privitaka po posjetitelju dnevno
global-topic-limit15 000Ukupan broj tema na poslužitelju
message-size-limit4KVeličina poruke; iznad nje poruka postaje privitak

Obavijesti e-poštom

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.

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"
Terminal
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

Sigurnosne kopije

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žiSigurnosna kopija
etc/server.ymlKonfiguraciju, uključujući SMTP tajne i ključeve za Web PushDa
lib/user.dbKorisnike, unose kontrole pristupa, tokene i dnevne brojačeDa
lib/cache.dbPoruke iz posljednjih 12 sati, prema zadanim postavkamaKorisna, vijek trajanja je kratak
lib/attachments/Privitke iz posljednja 3 sata, prema zadanim postavkamaKorisna, vijek trajanja je kratak
Datoteka web-push-filePretplate preglednika na Web Push, ako ste ga uključiliDa

Za dosljednu kopiju SQLite datoteka zaustavite uslugu dok se arhiva izrađuje:

Terminal, u mapi s datotekom compose.yaml
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.

Ažuriranja

S Dockerom promijenite oznaku slike u compose.yaml, na primjer s v2.38.1 na sljedeću inačicu, a zatim:

Terminal, u mapi s datotekom compose.yaml
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.

Tko što radi na Managed VPS-u

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.

TemaNaši timoviVi
PoslužiteljAžuriranja sustava i sigurnosti, uključujući intervencije na poslužiteljuTrenutak koji odgovara vašem poslovanju
NadzorPoslužitelj pod nadzorom 24 sata dnevno, 7 dana u tjednu, s intervencijom bez čekanja vašeg pozivaČitanje zapisnika vaše instance
ntfyProaktivno praćenje: uočene pogreške, usporavanja, otvorene veze i prostor na disku, preporučen ispravakNjegova instalacija, ažuriranja i postavke, koje primjenjujete vi ili vaš AI asistent
PristupiPoslužitelj koji ih nosi, nadziran i sigurnosno kopiranKorisnici, dozvole za teme i tokeni vaših skripti
Sigurnosne kopijeSvake noći, šifrirane i čuvane izvan stroja; vraćanje uključenoKopije specifične za ntfy i zahtjev za vraćanje, kada vam zatreba
MigracijaVaš trenutačni poslužitelj migriran, besplatnoTrenutak 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.

ntfy, na poslužitelju koji vodimo za vas

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.

Otkrijte Managed VPS

Česta pitanja

Je li ntfy besplatan za tvrtke?

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.

Kako instalirati ntfy s Docker Composeom?

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.

Kako poslužitelj ntfy učiniti privatnim?

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.

Kako objavljivati u ntfy iz skripte s tokenom?

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.

Zašto u ntfy postaviti behind-proxy?

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.

Stižu li obavijesti ntfy na iPhone odmah?

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.

Kako sigurnosno kopirati ntfy?

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.

Pokriva li Managed VPS ntfy?

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.

Izvori i službena dokumentacija

Kontaktirajte nas