ntfy majutamine Managed VPS-is: tõukemärguanded teie enda serverist

ntfy majutamine Managed VPS-is tähendab, et saadate tõukemärguandeid lihtsa HTTP-päringuga, PUT või POST, masinast, mis on teie enda ning mida meie meeskonnad hoiavad ajakohasena ja jälgivad päeval ja öösel. ntfy on vabatarkvara, millel on kaks litsentsi, Apache 2.0 ja GPLv2. See juhend järgib selle ametlikku dokumentatsiooni versioonis 2.38.1: paigaldus Docker Compose’iga, fail server.yml, kasutajad ja juurdepääsu haldus, juurdepääsuload, HTTPS, mobiilirakendused, e-post, varukoopiad ja uuendused.

Simon Vasconcelos Lee Autor: Avaldatud 21. novembril 2026Lugemisaeg: 15 minutit

Kõik juhendid

Lühidalt

  1. ntfy võtab sõnumi vastu teemale suunatud HTTP PUT- või POST-päringuga ja edastab selle kohe sellele teemale tellitud telefonidele, brauseritele ja skriptidele.
  2. Selle kaks litsentsi, Apache 2.0 ja GPLv2, lubavad seda ettevõttes vabalt käitada; nende tingimused kehtivad tarkvara edasilevitamisele.
  3. Paigaldage see Docker Compose’iga: tõmmis binwiederhier/ntfy, fail server.yml sätetega base-url, cache-file ja auth-file ning aadressil 127.0.0.1 avaldatud port HTTPS-iga pöördproksi taga.
  4. Vaikimisi saab igaüks lugeda ja kirjutada kõigis teemades: määrake auth-default-access: deny-all, looge käsuga ntfy user add administraator ja andke seejärel igale skriptile oma juurdepääsuluba ja piiratud õigused.
  5. Varundage server.yml ja user.db, mis hoiavad konfiguratsiooni, kasutajaid, õigusi ja juurdepääsulube; uuendage tõmmise silti muutes, pärast väljalaskemärkmete lugemist.

Mida ntfy teeb

ntfy, mida hääldatakse nagu «notify», on HTTP-põhine avaldamise ja tellimise märguandeteenus. Selle README tutvustab seda kui võimalust saata skriptidest märguandeid oma telefoni või arvutisse, mis tahes masinast. Projekt peab avalikku instantsi ntfy.sh ja serverit saab ise majutada: just sellest see juhend räägib.

Terminal, esimene sõnum
curl -d "Backup finished" https://ntfy.example.com/backups

Apache 2.0 ja GPLv2 litsentsid ning kaubamärk

ntfy README märgib, et projektil on kaks litsentsi: Apache License 2.0 failis LICENSE ja GNU GPL versioon 2 failis LICENSE.GPLv2. Docker-tõmmis deklareerib mõlemad, Apache-2.0, GPL-2.0.

ntfy käitamine teie serveris, teie ettevõtte, meeskonna või klientide jaoks ei nõua seega ühegi litsentsi ostmist. Mõlemad tekstid pakuvad tarkvara ilma garantiita.

Litsents katab koodi. Nimi on eraldi küsimus: Apache License 2.0 ei anna mingeid õigusi litsentsiandja kaubamärkidele ning ntfy.sh teenusetingimused märgivad, et ntfy nimi, logo ja visuaalne identiteet on ntfy LLC kaubamärgid, mille kasutamine seoses toote või teenusega nõuab selle eelnevat kirjalikku nõusolekut. See juhend nimetab ntfy-d tarkvara kirjeldamiseks.

See väljaanne on sõltumatu ntfy projektist ja ettevõttest ntfy LLC ega ole nendega seotud, nende sponsitud ega heaks kiidetud.

Arvestatavad ressursid

Server on üksainus staatiliselt lingitud binaarfail amd64, armv7 ja arm64 jaoks; Docker-tõmmis on olemas ka armv6 jaoks. Dokumentatsioon ei too välja mälu ega protsessori näitajaid: koduserveri puhul pole skaleerimise pärast vaja muretseda, ütleb see. Selle asemel osutab see sellele, mis instantsi piirab:

Managed VPS-is rääkige meile oma kasutusest, tellitud seadmete arvust, sõnumite mahust ja manustest ning soovitame sobiva suuruse.

Paigaldus Docker Compose’iga

Dokumentatsioon pakub Docker Hubis tõmmist binwiederhier/ntfy. See pakub veebirakendust ja API-t konteineri pordil 80 ega sisalda faili server.yml: konfiguratsioon läheb kausta, mis on paigaldatud asukohta /etc/ntfy. Looge serveris, kuhu Docker on paigaldatud, kaust ja pange sinna see dokumentatsiooni näitel põhinev compose.yaml:

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

Seejärel konfiguratsioonifail asukohas etc/server.yml, teie serveri avaliku aadressiga:

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, compose.yaml-i kaustas
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Server vastab {"healthy":true,"role":"active"}. Mida iga säte teeb:

Ilma Dockerita: Debiani ja Ubuntu hoidla

Projekt avaldab ka pakettide hoidla, mis on allkirjastatud võtmega, mille sõrmejälg on 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. amd64-serveris:

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

Pakett loeb faili /etc/ntfy/server.yml. Näidisfail soovitab vahemälu jaoks asukohta /var/cache/ntfy/cache.db ja kasutajate jaoks asukohta /var/lib/ntfy/user.db, kaht kausta, mille pakett loob. Proksi taga lisage listen-http: "127.0.0.1:2586".

Kasutajad, juurdepääsu haldus ja juurdepääsuload

Algseisus on ntfy server avatud: igaüks saab lugeda ja kirjutada kõigis teemades ning teema nimi toimib paroolina. Sätetega auth-file ja deny-all ei pääse midagi läbi ilma mandaadita. ntfy-l on kaks rolli: admin, mis loeb ja kirjutab kõigis teemades, ja user, millel on ainult teie antud õigused.

Terminal, esimene administraator
docker compose exec ntfy ntfy user add --role=admin alice

Käsk küsib parooli ja seejärel selle kinnitust. Käsud ntfy user, ntfy access ja ntfy token kirjutavad otse kasutajate andmebaasi: need käivitatakse serveris, siin konteineri sees, mis loeb selle andmebaasi asukoha failist server.yml.

Üks kasutaja ja üks juurdepääsuluba skripti kohta

Praegu annab juurdepääsuluba täieliku juurdepääsu oma kasutaja kontole, välja arvatud parooli muutmine ja konto kustutamine. Skripti jaoks looge eraldi kasutaja, mis on piiratud selle teemadega, ja seejärel sellele juurdepääsuluba:

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 avaldab seejärel oma juurdepääsuloaga, HTTPS-i kaudu:

Terminal, avaldavas masinas
curl \
  -H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
  -H "Title: Backup finished" \
  -H "Priority: high" \
  -d "The nightly backup went fine." \
  https://ntfy.example.com/backups

Basic authi parool on ainult base64-kodeeritud, mitte krüpteeritud: dokumentatsioon nõuab HTTPS-i igas isemajutatud serveris. Sellest räägib järgmine jaotis.

HTTPS: pöördproksi

ntfy suudab HTTPS-i ise pakkuda, kuid proksi taga soovitab dokumentatsioon jätta TLS-i lõpetamise proksile. Kaks punkti on kõige olulisemad:

Caddy-ga

Dokumentatsioon märgib, et Caddy käsitleb direktiiviga reverse_proxy nii HTTP-d kui ka WebSocketit, ilma lisasäteteta. See hangib Let’s Encrypti sertifikaadi ise:

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

Nginxiga

See plokk järgib dokumentatsiooni konfiguratsiooni, mis on lähedane ntfy.sh-i omale: puhverdamine voogude jaoks välja lülitatud, 3-minutilised ajalõpud ja päringute sisule suurusepiirang puudub, sest ntfy piirab seda ise. See kuulab pordil 80, et Certbot saaks HTTPS-i seadistada:

/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

Kui HTTP suunab HTTPS-ile, avaldage oma skriptides aadressidele https://. Tuhandete tellijate jaoks tõstab dokumentatsioon failis nginx.conf väärtust worker_connections ja Nginxi teenuse sätet LimitNOFILE kahekordseks soovitud ühenduste arvust.

Androidi, iOS-i ja veebirakendused

ntfy rakendused lisavad teie serveri teemasid samamoodi nagu ntfy.sh-i omi: sisestage teema lisamisel selle aadress ja kaitstud teema puhul kasutaja nimi ja parool, kellel on sellele juurdepääs. Veebirakendust pakutakse serveri enda aadressil.

Kohesed märguanded iOS-is

Lisage faili server.yml üks rida ja taaskäivitage seejärel konteiner:

etc/server.yml
upstream-base-url: "https://ntfy.sh"

Iga sõnumi kohta avaldab teie server siis ntfy.sh-is pollimispäringu, mis sisaldab ainult sõnumi ID-d ja teema URL-i SHA-256 räsi. ntfy.sh edastab selle seadmele Apple’i märguandeteenuse kaudu ja seejärel toob rakendus sõnumi teie serverist. ntfy.sh-i läbiv tekst on alati sama, «New message», ükskõik mida teie oma ütleb. Ilma selle sätteta jõuavad märguanded ikkagi kohale, viivitusega, mis võib olenevalt telefoni olekust ulatuda mitme tunnini. upstream-access-token lisab juurdepääsuloa, kui ületate ntfy.sh-i kiiruspiiranguid.

Kiiruspiirangud ja manused

ntfy piirab iga külastajat, keda tuvastatakse IP-aadressi järgi ja IPv6 puhul /64-alamvõrgu järgi. Need piirangud kaitsevad serverit kuritarvitamise eest; tavakasutuses, ütleb dokumentatsioon, ei tohiks te nendeni jõuda. Nende ületamisel vastab server 429 Too Many Requests. Vaikeväärtused:

SäteVaikimisiMida see piirab
visitor-request-limit-burst60Külastaja päringud ühe pursuna
visitor-request-limit-replenish5sTäitumise kiirus: üks päring iga 5 sekundi järel
visitor-subscription-limit30Avatud ühendused külastaja kohta
visitor-message-daily-limitPuudubSõnumid päevas, muidu reguleerib neid päringupiirang
visitor-email-limit-burst16E-kirjad ühe pursuna, seejärel üks tunnis
visitor-attachment-total-size-limit100MManuste salvestusruum külastaja kohta
visitor-attachment-daily-bandwidth-limit500MManuste liiklus külastaja kohta päevas
global-topic-limit15 000Serveri teemade koguarv
message-size-limit4KSõnumi suurus; sellest suurem muutub manuseks

E-posti märguanded

ntfy saab sõnumi e-postiga edasi saata, kui avaldamispäringul on päis Email või X-Email koos aadressiga. Selleks kasutab see väljuva posti SMTP-serverit, STARTTLS-iga, autentimisega PLAIN või LOGIN: see on port 587. Simafri VPS-ist väljub e-post autenditud SMTP-releed pidi samal pordil 587: seadistage siin e-posti konto aadress, mis teil juba on, või teie e-kirjade saatmise teenuse aadress.

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

Varukoopiad

SQLite’iga hoiab ntfy iga andmeliiki eraldi failis. Selle juhendi paigalduses on kõik kaustades etc ja lib, faili compose.yaml kõrval:

ElementMida see hoiabVarundada
etc/server.ymlKonfiguratsioon, sealhulgas SMTP saladused ja Web Pushi võtmedJah
lib/user.dbKasutajad, juurdepääsu reeglid, juurdepääsuload ja päevased loenduridJah
lib/cache.dbViimase 12 tunni sõnumid, vaikimisiKasulik, selle eluiga on lühike
lib/attachments/Viimase 3 tunni manused, vaikimisiKasulik, selle eluiga on lühike
Fail web-push-fileBrauserite Web Pushi tellimused, kui olete selle lubanudJah

SQLite’i failide ühtse koopia saamiseks peatage teenus arhiivi loomise ajaks:

Terminal, compose.yaml-i kaustas
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start

Ajastage see koopia vaiksele ajale ja saatke see serverist välja. Serveri kettal hoituna lähevad need arhiivid ka selle öistesse varukoopiatesse. Taastamiseks pange kaustad tagasi oma kohale ja käivitage seejärel docker compose up -d.

Kui kaotate faili user.db ilma koopiata, luuakse failis server.yml sätetega auth-users ja auth-tokens deklareeritud kasutajad ja juurdepääsuload käivitamisel uuesti; käsurealt loodud tuleb uuesti luua.

Uuendused

Dockeriga muutke failis compose.yaml tõmmise silti, näiteks v2.38.1 järgmise versiooni vastu, ja seejärel:

Terminal, compose.yaml-i kaustas
docker compose pull
docker compose up -d

Kaustad etc ja lib jäävad paigale ning ntfy migreerib oma andmebaasid käivitamisel ise. Debiani paketiga teevad sama sudo apt update ja seejärel sudo apt upgrade.

Iga versiooni märkmed dokumentatsiooni lehel «Releases» koondavad jaotisse «Upgrade notes» selle, mis olemasoleva instantsi jaoks muutub, näiteks versioonis 2.36.0 konfiguratsioon, mida nüüd kontrollitakse käivitamisel täielikult, või nullitud päevased loendurid. Lugege need enne uuendamist läbi ja kopeerige mõlemad kaustad vahetult enne. Versioon 2.38.1 on turvaväljalase, mida projekt tungivalt soovitab: see tugevdab sõnumimalle teenusetõkestusrünnete vastu ning ei lase aeglastel manuste üleslaadimistel S3-sse ja mittevastavatel web push lõpp-punktidel mälu ja ühendusi kinni hoida. See järgneb versioonile 2.38.0, mis jagab kiiruspiiranguid klastri sõlmede vahel ja on ehitatud Go 1.27.4-ga.

Kes mida teeb Managed VPS-is

Ise majutamine nõuab lisaks rakendusele ka serveri hoidmist. Managed VPS-is võtavad meie meeskonnad serveri enda hoole alla ja jälgivad teie instantsi proaktiivselt; ntfy jääb teie tarkvaraks oma sätete ja andmetega.

TeemaMeie meeskonnadTeie
ServerSüsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatudHetk, mis sobib teie tegevusele
SeireServerit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamataTeie instantsi logide lugemine
ntfyProaktiivne jälgimine: vead, aeglus, avatud ühendused ja kettaruum avastatakse, parandus soovitatakseSelle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent
JuurdepääsudSeda kandev server, jälgitud ja varundatudKasutajad, teemade õigused ja teie skriptide juurdepääsuload
VarukoopiadIgal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldubntfy enda koopiad ja taastamistaotlus, kui seda vajate
ÜleviimineTeie praeguse serveri üleviimine, tasutaÜmberlülitamise hetk

Kui eelistate, et meie meeskonnad sekkuksid rakendusse endasse, arveldatakse see teenus tunni- või kindlahinnaga, hinnapakkumine edastatakse enne sekkumist.

ntfy teie eest hoitud serveris

Simafri Managed VPS-iga hoiavad meie meeskonnad teie ntfy instantsi serveri ajakohasena, jälgivad seda päeval ja öösel ning sekkuvad ilma teie kõnet ootamata; nad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate ise või oma tehisintellekti assistendiga. Varukoopiad krüpteeritakse igal ööl ja hoitakse väljaspool masinat, nende taastamine sisaldub hinnas ning teie praeguse serveri üleviimine on tasuta.

Vaadake Managed VPS

Korduma kippuvad küsimused

Kas ntfy on ettevõttele tasuta?

Jah. ntfy-l on kaks litsentsi, Apache 2.0 ja GPLv2: võite seda ettevõttes käitada, ilma et peaksite litsentsi ostma. Nende tingimused kehtivad tarkvara edasilevitamisele. Jääb ainult seda käitava serveri hind.

Kuidas paigaldada ntfy Docker Compose’iga?

Looge compose.yaml tõmmisega binwiederhier/ntfy, käsuga serve, kaustaga, mis on paigaldatud asukohta /etc/ntfy faili server.yml jaoks, teisega asukohas /var/lib/ntfy andmebaaside jaoks ning konteineri pordiga 80, mis on avaldatud aadressil 127.0.0.1:2586. Käivitage docker compose up -d ja pange seejärel selle pordi ette HTTPS-iga pöördproksi.

Kuidas muuta ntfy server privaatseks?

Määrake failis server.yml sätted auth-file ja auth-default-access: deny-all. Seejärel looge käsuga ntfy user add --role=admin administraator, käsuga ntfy user add piiratud kasutajad ja käsuga ntfy access nende õigused teemadele.

Kuidas avaldada skriptist ntfy-sse juurdepääsuloaga?

Looge käsuga ntfy token add juurdepääsuluba skripti jaoks eraldatud kasutajale, kes on piiratud selle teemadega, ja avaldage seejärel käsuga curl ja päisega Authorization: Bearer, millele järgneb juurdepääsuluba, HTTPS-i kaudu. Juurdepääsuluba annab juurdepääsu kogu oma kasutaja kontole.

Miks määrata ntfy-s behind-proxy?

Pöördproksi taga tuleb iga päring proksi aadressilt. Sättega behind-proxy: true loeb ntfy iga külastaja tuvastamiseks päist X-Forwarded-For; ilma selleta jagavad kõik samu kiiruspiiranguid.

Kas ntfy märguanded jõuavad iPhone’i kohe?

Jah, kui failis server.yml on upstream-base-url: "https://ntfy.sh". Teie server laseb siis ntfy.sh-il edastada signaali, mis sisaldab ainult sõnumi ID-d, ja rakendus toob sõnumi teie serverist. Ilma selle sätteta võib kohaletoimetamine võtta mitu tundi.

Kuidas ntfy-d varundada?

Varundage server.yml ja user.db, mis hoiavad konfiguratsiooni, kasutajaid, õigusi ja juurdepääsulube, ning Web Pushi fail, kui see on lubatud. Sõnumite vahemälu ja manuste eluiga on lühike. Peatage kopeerimise ajaks teenus, et saada ühtsed SQLite’i failid.

Kas Managed VPS katab ntfy?

Managed VPS katab serveri: süsteem, turvalisus, seire ja varukoopiad. Meie meeskonnad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate teie. Sekkumine rakendusse arveldatakse tunni- või kindlahinnaga.

Allikad ja ametlik dokumentatsioon

Võtke meiega ühendust