Gostovanje ntfy na Managed VPS pomeni, da potisna obvestila pošiljate z navadno zahtevo HTTP, PUT ali POST, z lastnega stroja, ki ga naše ekipe posodabljajo in podnevi in ponoči spremljajo. ntfy je prosta programska oprema z dvojno licenco, Apache 2.0 in GPLv2. Ta vodnik sledi njegovi uradni dokumentaciji v različici 2.38.1: namestitev z Docker Compose, datoteka server.yml, uporabniki in nadzor dostopa, žetoni za dostop, HTTPS, mobilne aplikacije, e-pošta, varnostne kopije in posodobitve.
Avtor: Simon Vasconcelos Lee
Objavljeno 21. novembra 2026Čas branja: 15 minut
binwiederhier/ntfy, datoteka server.yml z base-url, cache-file in auth-file ter vrata, objavljena na 127.0.0.1 za obratnim posredniškim strežnikom s HTTPS.auth-default-access: deny-all, z ukazom ntfy user add ustvarite skrbnika, nato pa vsakemu skriptu dodelite lasten žeton in omejena dovoljenja.server.yml in user.db, ki hranita konfiguracijo, uporabnike, dovoljenja in žetone; posodabljate s spremembo oznake slike, potem ko preberete opombe ob izdaji.ntfy, ki se izgovarja „notify“, je storitev za obvestila po načelu objave in naročnine, zgrajena na HTTP. Njegov README ga predstavlja kot način za pošiljanje obvestil na telefon ali računalnik iz skriptov, s katerega koli računalnika. Projekt upravlja javno instanco ntfy.sh, strežnik pa lahko gostite tudi sami: s tem se ukvarja ta vodnik.
curl, skripta, načrtovanega opravila ali druge aplikacije. Sporočilo ima lahko naslov, prioriteto od 1 do 5, oznake in emojije, prilogo, gumbe za dejanja ali zakasnjen čas dostave.ntfy ali API, prek WebSocketa ali toka HTTP, ki ostane odprt.curl -d "Backup finished" https://ntfy.example.com/backups
README projekta ntfy navaja, da je projekt na voljo pod dvojno licenco: pod licenco Apache 2.0 v datoteki LICENSE in pod GNU GPL različice 2 v datoteki LICENSE.GPLv2. Slika Docker navaja obe, Apache-2.0, GPL-2.0.
Za poganjanje ntfy na vašem strežniku, za vaše podjetje, ekipo ali stranke, torej ni treba kupiti nobene licence. Obe besedili zagotavljata programsko opremo brez jamstva.
Licenca pokriva kodo. Ime je ločena zadeva: licenca Apache 2.0 ne podeljuje nobenih pravic do blagovnih znamk dajalca licence, pogoji uporabe storitve ntfy.sh pa navajajo, da so ime ntfy, logotip in celostna podoba blagovne znamke družbe ntfy LLC, katerih uporaba v povezavi z izdelkom ali storitvijo zahteva njeno predhodno pisno soglasje. Ta vodnik ime ntfy navaja za opis programske opreme.
Ta objava je neodvisna od projekta ntfy in družbe ntfy LLC ter z njima ni povezana, niti je ne sponzorirata ali odobravata.
Strežnik je ena sama, statično povezana binarna datoteka za amd64, armv7 in arm64; slika Docker je na voljo tudi za armv6. Dokumentacija ne navaja vrednosti za pomnilnik ali procesor: pri domačem strežniku, pravi, zaradi obsega ni treba skrbeti. Namesto tega navaja, kaj omejuje instanco:
nofile. Storitev systemd iz paketa jo nastavi na 10.000.Na Managed VPS nam opišite svojo uporabo, število naročenih naprav, obseg sporočil in priloge, in priporočimo vam ustrezno velikost.
Dokumentacija ponuja sliko binwiederhier/ntfy z Docker Huba. Spletno aplikacijo in API streže na vratih 80 vsebnika in ne vsebuje datoteke server.yml: konfiguracija sodi v mapo, priklopljeno na /etc/ntfy. Na strežniku z nameščenim Dockerjem ustvarite mapo in vanjo postavite ta compose.yaml, pripravljen po zgledu 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
Nato konfiguracijska datoteka etc/server.yml z javnim naslovom vašega strežnika:
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
Strežnik odgovori {"healthy":true,"role":"active"}. Kaj počne posamezna nastavitev:
127.0.0.1:2586: primeri za Docker v dokumentaciji objavijo vrata 80 na vseh naslovih, njeni primeri obratnega posredniškega strežnika pa posredujejo na 127.0.0.1:2586. Tako objavljena vrata so dosegljiva le s strežnika samega, do API-ja pa pridete samo prek obratnega posredniškega strežnika, s HTTPS.base-url: javni naslov storitve. Vzorčna datoteka server.yml ga zahteva za priloge, pošiljanje e-pošte in obvestila za iOS s strežnika, ki ga gostite sami.cache-file: brez njega sporočila ostanejo v pomnilniku 12 ur in se ob ponovnem zagonu izgubijo. Ta predpomnilnik telefonom z nestabilno povezavo omogoča, da prenesejo sporočila, ki so jih zamudili.attachment-cache-dir: omogoči priloge. ntfy prevzame popoln nadzor nad to mapo, zato jo namenite samo temu.auth-file in auth-default-access: deny-all: zbirka uporabnikov in dovoljenj, ustvarjena ob prvem zagonu, in privzeto zavrnjen anonimni dostop. To nastavitev dokumentacija priporoča za zasebno instanco.behind-proxy: brez nje si za posredniškim strežnikom vsi obiskovalci delijo naslov IP posredniškega strežnika in iste omejitve zahtev.enable-login: omogoča prijavo v spletno aplikacijo. Odprta registracija ostane zaprta, ker ima enable-signup privzeto vrednost false.v2.38.1 zaklene različico; latest sledi najnovejši izdaji. Dokumentacija ponuja tudi user: UID:GID za račun, ki ni root: datoteke v etc in lib nato pripadajo njemu.Projekt objavlja tudi repozitorij paketov, podpisan s ključem s prstnim odtisom 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Na strežniku 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 bere /etc/ntfy/server.yml. Vzorčna datoteka priporoča /var/cache/ntfy/cache.db za predpomnilnik in /var/lib/ntfy/user.db za uporabnike, dve mapi, ki ju ustvari paket. Za posredniškim strežnikom dodajte listen-http: "127.0.0.1:2586".
Po namestitvi je strežnik ntfy odprt: vsak lahko bere in piše v vse teme, ime teme pa služi kot geslo. Z auth-file in deny-all brez poverilnic ne gre nič skozi. ntfy ima dve vlogi: admin, ki bere in piše v vse teme, ter user, ki ima le dovoljenja, ki ji jih dodelite.
docker compose exec ntfy ntfy user add --role=admin alice
Ukaz vpraša za geslo in nato za njegovo potrditev. Ukazi ntfy user, ntfy access in ntfy token pišejo neposredno v zbirko uporabnikov: tečejo na strežniku, tu znotraj vsebnika, ki pot do te zbirke prebere iz server.yml.
Žeton za dostop trenutno daje poln dostop do računa svojega uporabnika, razen spremembe gesla in izbrisa računa. Za skript ustvarite namenskega uporabnika, omejenega na njegove teme, nato pa zanj žeton:
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 ali deny, za določeno temo ali za vzorec, kot je alerts-*, edini podprti nadomestni znak.everyone oziroma *. Za UnifiedPush na zasebni instanci dokumentacija teme, ki se začnejo z up, odpre samo za pisanje: ntfy access '*' 'up*' write-only.tk_, lahko potečejo z --expires=30d, vsak uporabnik pa jih ima lahko do 60. ntfy token list jih prikaže, ntfy token remove enega izbriše.auth-users, auth-access in auth-tokens ustvarijo iste objekte iz server.yml, ob vsakem zagonu. Uporabnik, odstranjen s tega seznama, se ob naslednjem ponovnem zagonu izbriše iz zbirke.Skript nato objavlja s svojim žetonom, prek 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
Geslo Basic auth je le kodirano v base64, ne šifrirano: dokumentacija zahteva HTTPS na vsakem strežniku, ki ga gostite sami. S tem se ukvarja naslednji razdelek.
ntfy zna HTTPS streči tudi sam, vendar dokumentacija za posredniškim strežnikom priporoča, da zaključevanje TLS prepustite njemu. Najpomembnejši sta dve točki:
Upgrade in Connection ter tem dolgim povezavam pusti živeti. ntfy privzeto vsakih 45 sekund pošlje sporočilo za ohranjanje povezave, keepalive-interval, da jih noben posrednik ne zapre zaradi nedejavnosti.behind-proxy: true ntfy bere glavo X-Forwarded-For in vzame skrajno desni naslov, tistega, ki ga doda vaš posredniški strežnik. Omejitve zahtev veljajo za ta naslov.Dokumentacija opozarja, da Caddy z reverse_proxy obvlada tako HTTP kot WebSockete, brez dodatnih nastavitev. Potrdilo Let’s Encrypt pridobi sam:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Ta blok sledi konfiguraciji iz dokumentacije, ki je blizu tisti, ki jo uporablja ntfy.sh: izklopljeno medpomnjenje za tokove, časovne omejitve 3 minute in brez omejitve velikosti telesa zahtev, ki jo ntfy določi sam. Posluša na vratih 80, da lahko Certbot nastavi 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
Ko HTTP preusmerja na HTTPS, v skriptih objavljajte na naslove https://. Za tisoče naročnikov dokumentacija dvigne worker_connections v nginx.conf in LimitNOFILE storitve Nginx na dvakratnik ciljnega števila povezav.
Aplikacije ntfy dodajajo teme z vašega strežnika enako kot z ntfy.sh: ko dodajate temo, vnesite naslov strežnika, za zaščiteno temo pa uporabniško ime in geslo uporabnika, ki ima dostop do nje. Spletna aplikacija se streže na naslovu strežnika samega.
ntfy webpush keys, in veljavno potrdilo HTTPS.V server.yml dodajte eno vrstico, nato znova zaženite vsebnik:
upstream-base-url: "https://ntfy.sh"
Ob vsakem sporočilu vaš strežnik tedaj v ntfy.sh objavi zahtevo za poizvedbo, ki vsebuje le ID sporočila in zgoščeno vrednost SHA-256 naslova URL teme. ntfy.sh jo prek Applove storitve obvestil posreduje napravi, nato pa aplikacija prenese sporočilo z vašega strežnika. Besedilo, ki gre skozi ntfy.sh, je vedno enako, „New message“, ne glede na vsebino vašega sporočila. Brez te nastavitve obvestila še vedno prispejo, z zamikom, ki lahko glede na stanje telefona doseže več ur. upstream-access-token doda žeton, če presežete omejitve zahtev ntfy.sh.
ntfy omejuje vsakega obiskovalca, ki ga prepozna po naslovu IP, pri IPv6 pa po podomrežju /64. Te omejitve ščitijo strežnik pred zlorabami; pri običajni uporabi jih po navedbah dokumentacije ne bi smeli doseči. Ko jih presežete, strežnik odgovori 429 Too Many Requests. Privzete vrednosti:
| Nastavitev | Privzeto | Kaj omejuje |
|---|---|---|
visitor-request-limit-burst | 60 | Zahteve obiskovalca v enem nizu |
visitor-request-limit-replenish | 5s | Hitrost obnavljanja: ena zahteva vsakih 5 sekund |
visitor-subscription-limit | 30 | Odprte povezave na obiskovalca |
visitor-message-daily-limit | Brez | Sporočila na dan, sicer jih ureja omejitev zahtev |
visitor-email-limit-burst | 16 | E-poštna sporočila v enem nizu, nato eno na uro |
visitor-attachment-total-size-limit | 100M | Prostor za priloge na obiskovalca |
visitor-attachment-daily-bandwidth-limit | 500M | Promet prilog na obiskovalca na dan |
global-topic-limit | 15.000 | Skupno število tem na strežniku |
message-size-limit | 4K | Velikost sporočila; nad njo sporočilo postane priloga |
visitor-request-limit-exempt-hosts, seznamom naslovov IP ali imen gostiteljev.ntfy tier, nekaterim računom dajo višje omejitve.attachment-file-size-limit, privzeto 15M, omeji vsako datoteko, attachment-total-size-limit, 5G, celotno shrambo, attachment-expiry-duration, 3h, pa njihovo življenjsko dobo. Priloga nikoli ne preživi svojega sporočila: če želite priloge hraniti dlje, povečajte tudi cache-duration.ntfy lahko sporočilo posreduje po e-pošti, ko zahteva za objavo nosi glavo Email, ali X-Email, z naslovom. Za to uporablja strežnik SMTP za odhodno pošto, prek STARTTLS, s preverjanjem pristnosti PLAIN ali LOGIN: to so vrata 587. Z VPS Simafri pošta odhaja prek overjenega releja SMTP na istih vratih 587: tu nastavite naslov e-poštnega računa, ki ga že imate, ali naslov svoje storitve pošiljanja.
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 in smtp-sender-from sta obvezni, takoj ko je nastavljen smtp-sender-addr: brez njiju strežnik zavrne zagon.smtp-sender-verify: true omeji pošiljanje na naslove, ki jih je vsak uporabnik preveril v svojem računu, za anonimne uporabnike pa ga zapre.server.yml: to datoteko pustite berljivo le za lastnika, z chmod 600.S SQLite ntfy vsako vrsto podatkov hrani v svoji datoteki. V namestitvi iz tega vodnika je vse v mapah etc in lib, poleg datoteke compose.yaml:
| Element | Kaj hrani | Varnostna kopija |
|---|---|---|
etc/server.yml | Konfiguracijo, vključno s skrivnostmi SMTP in ključi Web Push | Da |
lib/user.db | Uporabnike, vnose nadzora dostopa, žetone in dnevne števce | Da |
lib/cache.db | Sporočila zadnjih 12 ur, privzeto | Koristna, življenjska doba je kratka |
lib/attachments/ | Priloge zadnjih 3 ur, privzeto | Koristna, življenjska doba je kratka |
Datoteka web-push-file | Naročnine Web Push brskalnikov, če ste ga omogočili | Da |
Za dosledno kopijo datotek SQLite med izdelavo arhiva ustavite storitev:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
To kopijo načrtujte ob mirni uri in jo pošljite zunaj strežnika. Ker so shranjeni na njegovem disku, so ti arhivi tudi del njegovih nočnih varnostnih kopij. Za obnovo vrnite mapi na mesto, nato zaženite docker compose up -d.
Če izgubite user.db brez kopije, se uporabniki in žetoni, deklarirani v server.yml z auth-users in auth-tokens, ob zagonu obnovijo; tiste, ustvarjene v ukazni vrstici, je treba ustvariti znova.
Z Dockerjem spremenite oznako slike v compose.yaml, na primer z v2.38.1 na naslednjo različico, nato:
docker compose pull
docker compose up -d
Mapi etc in lib ostaneta na mestu, ntfy pa ob zagonu sam preseli svoje zbirke podatkov. S paketom za Debian enako opravita sudo apt update in nato sudo apt upgrade.
Opombe vsake različice na strani „Releases“ dokumentacije pod naslovom „Upgrade notes“ zberejo, kar se spremeni za obstoječo instanco, na primer v 2.36.0 konfiguracijo, ki se zdaj ob zagonu v celoti preveri, ali ponastavljene dnevne števce. Preberite jih pred posodobitvijo in tik pred njo kopirajte obe mapi. Različica 2.38.1 je varnostna izdaja, ki jo projekt močno priporoča: utrdi predloge sporočil pred napadi zavrnitve storitve in preprečuje, da bi počasna nalaganja prilog v S3 ter končne točke web push, ki se ne odzivajo, zasedala pomnilnik in povezave. Sledi različici 2.38.0, ki deli omejitve zahtev med vozlišči gruče in je zgrajena z Go 1.27.4.
Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; ntfy ostaja vaša programska oprema, z vašimi nastavitvami in podatki.
| Tema | Naše ekipe | Vi |
|---|---|---|
| Strežnik | Posodobitve sistema in varnosti, vključno s posegi na strežniku | Trenutek, ki ustreza vaši dejavnosti |
| Nadzor | Strežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klic | Branje dnevnikov vaše instance |
| ntfy | Proaktivno spremljanje: napake, upočasnitve, odprte povezave in prostor na disku, s priporočenim popravkom | Namestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik |
| Dostopi | Strežnik, ki jih nosi, pod nadzorom in varnostno kopiran | Uporabniki, dovoljenja za teme in žetoni vaših skriptov |
| Varnostne kopije | Vsako noč, šifrirane in shranjene zunaj stroja; obnova je vključena | Kopije, značilne za ntfy, in zahteva za obnovo, ko jo potrebujete |
| Selitev | Selitev vašega sedanjega strežnika, brezplačno | Trenutek preklopa |
Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.
Z Managed VPS Simafri naše ekipe strežnik vaše instance ntfy sproti posodabljajo, ga podnevi in ponoči nadzirajo ter posežejo brez čakanja na vaš klic; vašo instanco tudi proaktivno spremljajo in vam priporočajo koristne popravke, ki jih uvedete vi ali vaš AI pomočnik. Varnostne kopije so vsako noč šifrirane in shranjene zunaj stroja, njihova obnova je vključena, selitev vašega sedanjega strežnika pa je brezplačna.
Da. ntfy ima dvojno licenco, Apache 2.0 in GPLv2: v podjetju ga lahko uporabljate, ne da bi morali kupiti licenco. Njuni pogoji veljajo za nadaljnje razširjanje programske opreme. Ostane le strošek strežnika, na katerem teče.
Ustvarite compose.yaml s sliko binwiederhier/ntfy, ukazom serve, mapo, priklopljeno na /etc/ntfy za server.yml, drugo na /var/lib/ntfy za zbirke podatkov, in vrati 80 vsebnika, objavljenimi na 127.0.0.1:2586. Zaženite docker compose up -d, nato pred ta vrata postavite obratni posredniški strežnik s HTTPS.
V server.yml nastavite auth-file in auth-default-access: deny-all. Nato ustvarite skrbnika z ntfy user add --role=admin, uporabnike z omejenim dostopom z ntfy user add in njihova dovoljenja za teme z ntfy access.
Z ntfy token add ustvarite žeton za uporabnika, namenjenega skriptu in omejenega na njegove teme, nato objavljajte s curl in glavo Authorization: Bearer, ki ji sledi žeton, prek HTTPS. Žeton daje dostop do celotnega računa svojega uporabnika.
Za obratnim posredniškim strežnikom vsaka zahteva prihaja z naslova posredniškega strežnika. Z behind-proxy: true ntfy bere glavo X-Forwarded-For, da prepozna vsakega obiskovalca; brez tega si vsi delijo iste omejitve zahtev.
Da, z upstream-base-url: "https://ntfy.sh" v server.yml. Vaš strežnik tedaj prek ntfy.sh posreduje signal, ki vsebuje le ID sporočila, aplikacija pa sporočilo prenese z vašega strežnika. Brez te nastavitve lahko dostava traja več ur.
Varnostno kopirajte server.yml in user.db, ki hranita konfiguracijo, uporabnike, dovoljenja in žetone, ter datoteko Web Push, če je omogočen. Predpomnilnik sporočil in priloge imajo kratko življenjsko dobo. Med kopiranjem ustavite storitev, da bodo datoteke SQLite dosledne.
Managed VPS pokriva strežnik: sistem, varnost, nadzor in varnostne kopije. Naše ekipe proaktivno spremljajo tudi vašo instanco in vam priporočajo koristne popravke, ki jih uvedete vi. Poseg v aplikacijo se zaračuna po urah ali pavšalno.
Simafri
Pogovorimo se o vašem projektu
Povejte nam v nekaj besedah, kaj potrebujete: hitro se vam oglasimo.
Hvala! Vaše povpraševanje je bilo poslano. Kmalu vam bomo odgovorili.
Imate raje e-pošto? Pišite nam na support@simafri.com.