Gostovanje ntfy na Managed VPS: potisna obvestila z vašega lastnega strežnika

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.

Simon Vasconcelos Lee Avtor: Objavljeno 21. novembra 2026Čas branja: 15 minut

Vsi vodniki

Na kratko

  1. ntfy sprejme sporočilo prek zahteve HTTP PUT ali POST na temo in ga takoj potisne na telefone, v brskalnike in skripte, ki so naročeni na to temo.
  2. Njegova dvojna licenca, Apache 2.0 in GPLv2, vam omogoča, da ga prosto uporabljate pri delu; njeni pogoji veljajo za nadaljnje razširjanje programske opreme.
  3. Namestite ga z Docker Compose: slika 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.
  4. Privzeto lahko vsak bere in piše v vse teme: nastavite auth-default-access: deny-all, z ukazom ntfy user add ustvarite skrbnika, nato pa vsakemu skriptu dodelite lasten žeton in omejena dovoljenja.
  5. Varnostno kopirajte server.yml in user.db, ki hranita konfiguracijo, uporabnike, dovoljenja in žetone; posodabljate s spremembo oznake slike, potem ko preberete opombe ob izdaji.

Kaj počne ntfy

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.

Terminal, prvo sporočilo
curl -d "Backup finished" https://ntfy.example.com/backups

Licenci Apache 2.0 in GPLv2 ter blagovna znamka

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.

Viri, ki jih je treba predvideti

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:

Na Managed VPS nam opišite svojo uporabo, število naročenih naprav, obseg sporočil in priloge, in priporočimo vam ustrezno velikost.

Namestitev z Docker Compose

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:

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

Nato konfiguracijska datoteka etc/server.yml z javnim naslovom vašega strežnika:

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, v mapi datoteke compose.yaml
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:

Brez Dockerja: repozitorij za Debian in Ubuntu

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:

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

Uporabniki, nadzor dostopa in žetoni

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.

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

En uporabnik in en žeton na skript

Ž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:

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

Skript nato objavlja s svojim žetonom, prek HTTPS:

Terminal, na stroju, ki objavlja
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.

HTTPS: obratni posredniški strežnik

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:

S Caddyjem

Dokumentacija opozarja, da Caddy z reverse_proxy obvlada tako HTTP kot WebSockete, brez dodatnih nastavitev. Potrdilo Let’s Encrypt pridobi sam:

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

Z Nginxom

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:

/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

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 za Android, iOS in splet

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.

Takojšnja obvestila na iOS

V server.yml dodajte eno vrstico, nato znova zaženite vsebnik:

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

Omejitve zahtev in priloge

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:

NastavitevPrivzetoKaj omejuje
visitor-request-limit-burst60Zahteve obiskovalca v enem nizu
visitor-request-limit-replenish5sHitrost obnavljanja: ena zahteva vsakih 5 sekund
visitor-subscription-limit30Odprte povezave na obiskovalca
visitor-message-daily-limitBrezSporočila na dan, sicer jih ureja omejitev zahtev
visitor-email-limit-burst16E-poštna sporočila v enem nizu, nato eno na uro
visitor-attachment-total-size-limit100MProstor za priloge na obiskovalca
visitor-attachment-daily-bandwidth-limit500MPromet prilog na obiskovalca na dan
global-topic-limit15.000Skupno število tem na strežniku
message-size-limit4KVelikost sporočila; nad njo sporočilo postane priloga

E-poštna obvestila

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.

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

Varnostne kopije

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:

ElementKaj hraniVarnostna kopija
etc/server.ymlKonfiguracijo, vključno s skrivnostmi SMTP in ključi Web PushDa
lib/user.dbUporabnike, vnose nadzora dostopa, žetone in dnevne števceDa
lib/cache.dbSporočila zadnjih 12 ur, privzetoKoristna, življenjska doba je kratka
lib/attachments/Priloge zadnjih 3 ur, privzetoKoristna, življenjska doba je kratka
Datoteka web-push-fileNaročnine Web Push brskalnikov, če ste ga omogočiliDa

Za dosledno kopijo datotek SQLite med izdelavo arhiva ustavite storitev:

Terminal, v mapi datoteke compose.yaml
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.

Posodobitve

Z Dockerjem spremenite oznako slike v compose.yaml, na primer z v2.38.1 na naslednjo različico, nato:

Terminal, v mapi datoteke compose.yaml
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.

Kdo kaj dela na Managed VPS

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.

TemaNaše ekipeVi
StrežnikPosodobitve sistema in varnosti, vključno s posegi na strežnikuTrenutek, ki ustreza vaši dejavnosti
NadzorStrežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klicBranje dnevnikov vaše instance
ntfyProaktivno spremljanje: napake, upočasnitve, odprte povezave in prostor na disku, s priporočenim popravkomNamestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik
DostopiStrežnik, ki jih nosi, pod nadzorom in varnostno kopiranUporabniki, dovoljenja za teme in žetoni vaših skriptov
Varnostne kopijeVsako noč, šifrirane in shranjene zunaj stroja; obnova je vključenaKopije, značilne za ntfy, in zahteva za obnovo, ko jo potrebujete
SelitevSelitev vašega sedanjega strežnika, brezplačnoTrenutek 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.

ntfy na strežniku, ki ga vzdržujemo za vas

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.

Odkrijte Managed VPS

Pogosta vprašanja

Ali je ntfy za podjetje brezplačen?

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.

Kako namestim ntfy z Docker Compose?

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.

Kako naredim strežnik ntfy zaseben?

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.

Kako objavljam v ntfy iz skripta z žetonom?

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.

Zakaj v ntfy nastaviti behind-proxy?

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.

Ali obvestila ntfy na iPhone prispejo takoj?

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.

Kako varnostno kopiram ntfy?

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.

Ali Managed VPS pokriva ntfy?

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.

Viri in uradna dokumentacija

Stopite v stik z nami