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.
Autor: Simon Vasconcelos Lee
Avaldatud 21. novembril 2026Lugemisaeg: 15 minutit
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.auth-default-access: deny-all, looge käsuga ntfy user add administraator ja andke seejärel igale skriptile oma juurdepääsuluba ja piiratud õigused.server.yml ja user.db, mis hoiavad konfiguratsiooni, kasutajaid, õigusi ja juurdepääsulube; uuendage tõmmise silti muutes, pärast väljalaskemärkmete lugemist.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.
curl, skriptist, ajastatud tööst või muust rakendusest. Sõnumil võib olla pealkiri, prioriteet 1 kuni 5, sildid ja emojid, manus, toimingunupud või edasilükatud kohaletoimetamise aeg.ntfy või API, WebSocketi või avatuks jääva HTTP-voo kaudu.curl -d "Backup finished" https://ntfy.example.com/backups
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.
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:
nofile lubab. Paketi systemd-teenus seab selle väärtuseks 10 000.Managed VPS-is rääkige meile oma kasutusest, tellitud seadmete arvust, sõnumite mahust ja manustest ning soovitame sobiva suuruse.
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:
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:
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
Server vastab {"healthy":true,"role":"active"}. Mida iga säte teeb:
127.0.0.1:2586 avaldatud port: dokumentatsiooni Dockeri näited avaldavad pordi 80 kõigil aadressidel ja selle pöördproksi näited suunavad aadressile 127.0.0.1:2586. Nii avaldatuna on port kättesaadav ainult serverist endast ja API-ni jõuab üksnes pöördproksi kaudu, HTTPS-iga.base-url: teenuse avalik aadress. Näidisfail server.yml nõuab seda manuste, e-kirjade saatmise ja iOS-i märguannete jaoks isemajutatud serverist.cache-file: ilma selleta püsivad sõnumid mälus 12 tundi ja kaovad taaskäivitamisel. See vahemälu laseb ebakindla ühendusega telefonidel kätte saada sõnumid, mis neil vahele jäid.attachment-cache-dir: lubab manused. ntfy võtab selle kausta täielikult enda kontrolli alla, seega hoidke see ainult selleks otstarbeks.auth-file ja auth-default-access: deny-all: kasutajate ja õiguste andmebaas, mis luuakse esimesel käivitamisel, ning anonüümne juurdepääs vaikimisi keelatud. Seda sätet soovitab dokumentatsioon privaatse instantsi jaoks.behind-proxy: ilma selleta jagavad proksi taga kõik külastajad proksi IP-aadressi ja samu kiiruspiiranguid.enable-login: võimaldab veebirakendusse sisse logida. Avatud registreerumine jääb suletuks, sest enable-signup vaikeväärtus on false.v2.38.1 fikseerib versiooni; latest järgib uusimat väljalaset. Dokumentatsioon pakub ka sätet user: UID:GID konto jaoks, mis pole root: kaustade etc ja lib failid kuuluvad siis sellele.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:
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".
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.
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.
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:
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 või deny, kindlale teemale või mustrile nagu alerts-*, mis on ainus toetatud metamärk.everyone ehk *. UnifiedPushi jaoks privaatses instantsis avab dokumentatsioon ainult kirjutamiseks teemad, mis algavad tähtedega up: ntfy access '*' 'up*' write-only.tk_, võivad aeguda lipuga --expires=30d ja iga kasutaja võib neid hoida kuni 60. ntfy token list näitab neid, ntfy token remove kustutab ühe.auth-users, auth-access ja auth-tokens samad objektid failist server.yml, igal käivitamisel. Sellest loendist eemaldatud kasutaja kustutatakse andmebaasist järgmisel taaskäivitamisel.Skript avaldab seejärel oma juurdepääsuloaga, HTTPS-i kaudu:
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.
ntfy suudab HTTPS-i ise pakkuda, kuid proksi taga soovitab dokumentatsioon jätta TLS-i lõpetamise proksile. Kaks punkti on kõige olulisemad:
Upgrade ja Connection ning laseb neil pikkadel ühendustel kesta. ntfy saadab vaikimisi iga 45 sekundi järel keepalive-sõnumi, keepalive-interval, et ükski vahelüli neid tegevusetuse tõttu ei sulgeks.behind-proxy: true loeb ntfy päist X-Forwarded-For ja jätab alles kõige parempoolsema aadressi, selle, mille lisab teie proksi. Kiiruspiirangud kehtivad sellele aadressile.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:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
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:
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
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.
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.
ntfy webpush keys loodud võtmepaari ja kehtivat HTTPS-sertifikaati.Lisage faili server.yml üks rida ja taaskäivitage seejärel konteiner:
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.
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äte | Vaikimisi | Mida see piirab |
|---|---|---|
visitor-request-limit-burst | 60 | Külastaja päringud ühe pursuna |
visitor-request-limit-replenish | 5s | Täitumise kiirus: üks päring iga 5 sekundi järel |
visitor-subscription-limit | 30 | Avatud ühendused külastaja kohta |
visitor-message-daily-limit | Puudub | Sõnumid päevas, muidu reguleerib neid päringupiirang |
visitor-email-limit-burst | 16 | E-kirjad ühe pursuna, seejärel üks tunnis |
visitor-attachment-total-size-limit | 100M | Manuste salvestusruum külastaja kohta |
visitor-attachment-daily-bandwidth-limit | 500M | Manuste liiklus külastaja kohta päevas |
global-topic-limit | 15 000 | Serveri teemade koguarv |
message-size-limit | 4K | Sõnumi suurus; sellest suurem muutub manuseks |
visitor-request-limit-exempt-hosts, mis on IP-aadresside või hostinimede loend.ntfy tier, annavad mõnele kontole kõrgemad piirangud.attachment-file-size-limit, vaikimisi 15M, piirab iga faili, attachment-total-size-limit, 5G, kogu salvestusruumi ja attachment-expiry-duration, 3h, nende eluiga. Manus ei ela kunagi kauem kui selle sõnum: manuste kauemaks säilitamiseks suurendage ka sätet cache-duration.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.
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 ja smtp-sender-from on kohustuslikud kohe, kui smtp-sender-addr on määratud: ilma nendeta keeldub server käivitumast.smtp-sender-verify: true piirab saatmise aadressidega, mille iga kasutaja on oma kontol kinnitanud, ja sulgeb selle anonüümsetele kasutajatele.server.yml: hoidke see fail loetavana ainult selle omanikule, käsuga chmod 600.SQLite’iga hoiab ntfy iga andmeliiki eraldi failis. Selle juhendi paigalduses on kõik kaustades etc ja lib, faili compose.yaml kõrval:
| Element | Mida see hoiab | Varundada |
|---|---|---|
etc/server.yml | Konfiguratsioon, sealhulgas SMTP saladused ja Web Pushi võtmed | Jah |
lib/user.db | Kasutajad, juurdepääsu reeglid, juurdepääsuload ja päevased loendurid | Jah |
lib/cache.db | Viimase 12 tunni sõnumid, vaikimisi | Kasulik, selle eluiga on lühike |
lib/attachments/ | Viimase 3 tunni manused, vaikimisi | Kasulik, selle eluiga on lühike |
Fail web-push-file | Brauserite Web Pushi tellimused, kui olete selle lubanud | Jah |
SQLite’i failide ühtse koopia saamiseks peatage teenus arhiivi loomise ajaks:
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.
Dockeriga muutke failis compose.yaml tõmmise silti, näiteks v2.38.1 järgmise versiooni vastu, ja seejärel:
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.
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.
| Teema | Meie meeskonnad | Teie |
|---|---|---|
| Server | Süsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatud | Hetk, mis sobib teie tegevusele |
| Seire | Serverit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamata | Teie instantsi logide lugemine |
| ntfy | Proaktiivne jälgimine: vead, aeglus, avatud ühendused ja kettaruum avastatakse, parandus soovitatakse | Selle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent |
| Juurdepääsud | Seda kandev server, jälgitud ja varundatud | Kasutajad, teemade õigused ja teie skriptide juurdepääsuload |
| Varukoopiad | Igal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldub | ntfy enda koopiad ja taastamistaotlus, kui seda vajate |
| Üleviimine | Teie 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Räägime teie kavatsusest
Öelge meile paari sõnaga, mida vajate: vastame teile kiiresti.
Aitäh! Teie päring on saadetud. Võtame teiega peagi ühendust.
Eelistate e-posti? Kirjutage meile aadressil support@simafri.com.