Talpinkite ntfy Managed VPS serveryje: push pranešimai iš jūsų serverio

ntfy talpinimas Managed VPS serveryje reiškia, kad push pranešimus siunčiate paprasta HTTP užklausa, PUT arba POST, iš savo mašinos, kurią mūsų komandos prižiūri atnaujintą ir stebi dieną bei naktį. ntfy yra laisva programinė įranga, platinama pagal dvigubą licenciją: Apache 2.0 ir GPLv2. Šis gidas seka oficialią jos dokumentaciją, 2.38.1 versiją: diegimą su Docker Compose, failą server.yml, naudotojus ir prieigos valdymą, prieigos žetonus, HTTPS, mobiliąsias programėles, el. paštą, atsargines kopijas ir atnaujinimus.

Simon Vasconcelos Lee Autorius: Paskelbta 2026 m. lapkričio 21 d.Skaitymo trukmė: 15 min.

Visi gidai

Svarbiausia

  1. ntfy priima žinutę per HTTP PUT ar POST užklausą į temą ir iškart perduoda ją telefonams, naršyklėms ir scenarijams, užsiprenumeravusiems tą temą.
  2. Jos dviguba licencija, Apache 2.0 ir GPLv2, leidžia laisvai ją naudoti darbe; jos sąlygos taikomos programinės įrangos platinimui.
  3. Įdiekite ją su Docker Compose: atvaizdas binwiederhier/ntfy, failas server.yml su base-url, cache-file ir auth-file, o prievadas paskelbtas adresu 127.0.0.1 už HTTPS atvirkštinio tarpinio serverio.
  4. Numatytai kiekvienas gali skaityti ir rašyti į kiekvieną temą: nustatykite auth-default-access: deny-all, sukurkite administratorių su ntfy user add, tada kiekvienam scenarijui suteikite atskirą žetoną ir ribotas teises.
  5. Kopijuokite server.yml ir user.db, kuriuose yra konfigūracija, naudotojai, teisės ir žetonai; atnaujinkite pakeisdami atvaizdo žymą, prieš tai perskaitę versijos pastabas.

Ką daro ntfy

ntfy, tariama „notify“, yra HTTP pagrindu veikianti publikavimo ir prenumeratos (publish-subscribe) pranešimų paslauga. Jos README ją pristato kaip būdą siųsti pranešimus į telefoną ar kompiuterį iš scenarijų, iš bet kurio kompiuterio. Projektas palaiko viešą egzempliorių ntfy.sh, o serverį galima talpinti savarankiškai: būtent tai aprašo šis gidas.

Terminal, pirmoji žinutė
curl -d "Backup finished" https://ntfy.example.com/backups

Apache 2.0 ir GPLv2 licencijos bei prekės ženklas

ntfy README nurodo, kad projektas turi dvigubą licenciją: Apache License 2.0, faile LICENSE, ir GNU GPL 2 versiją, faile LICENSE.GPLv2. Docker atvaizdas deklaruoja abi: Apache-2.0, GPL-2.0.

Todėl ntfy savo serveryje galite paleisti savo įmonei, komandai ar klientams nieko nepirkdami dėl licencijos. Abu tekstai programinę įrangą teikia be garantijos.

Licencija apima kodą. Pavadinimas yra atskiras klausimas: Apache License 2.0 nesuteikia jokių teisių į licencijos davėjo prekių ženklus, o ntfy.sh naudojimo sąlygos nurodo, kad ntfy pavadinimas, logotipas ir prekės ženklo elementai yra ntfy LLC prekių ženklai, kurių naudojimui, susijusiam su produktu ar paslauga, reikia išankstinio rašytinio jos sutikimo. Šis gidas ntfy mini programinei įrangai apibūdinti.

Šis leidinys yra nepriklausomas nuo ntfy projekto ir ntfy LLC ir nėra su jais susijęs, jų remiamas ar patvirtintas.

Ištekliai, kuriuos reikia numatyti

Serveris yra vienas statiškai susietas dvejetainis failas, skirtas amd64, armv7 ir arm64; Docker atvaizdas yra ir armv6. Dokumentacija nepateikia atminties ar procesoriaus skaičių: namų serveriui, pasak jos, dėl masto nerimauti neverta. Vietoj to ji nurodo, kas riboja egzempliorių:

Naudojant Managed VPS, papasakokite mums apie savo naudojimą, užsiprenumeravusių įrenginių skaičių, žinučių kiekį ir priedus, ir mes rekomenduosime tinkamą dydį.

Diegimas su Docker Compose

Dokumentacija siūlo Docker Hub atvaizdą binwiederhier/ntfy. Jis teikia žiniatinklio programą ir API konteinerio 80 prievadu ir neturi failo server.yml: konfigūracija dedama į katalogą, prijungtą prie /etc/ntfy. Serveryje, kuriame įdiegtas Docker, sukurkite katalogą ir įdėkite į jį šį compose.yaml, paremtą dokumentacijos pavyzdžiu:

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

Tada konfigūracijos failas, etc/server.yml, su viešuoju jūsų serverio adresu:

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 kataloge
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Serveris atsako {"healthy":true,"role":"active"}. Ką daro kiekvienas nustatymas:

Be Docker: Debian ir Ubuntu saugykla

Projektas taip pat skelbia paketų saugyklą, pasirašytą raktu, kurio piršto atspaudas 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Serveryje su 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

Paketas skaito /etc/ntfy/server.yml. Pavyzdinis failas podėliui rekomenduoja /var/cache/ntfy/cache.db, o naudotojams /var/lib/ntfy/user.db, du katalogus, kuriuos sukuria paketas. Už tarpinio serverio pridėkite listen-http: "127.0.0.1:2586".

Naudotojai, prieigos valdymas ir žetonai

Iš karto po įdiegimo ntfy serveris yra atviras: kiekvienas gali skaityti ir rašyti į kiekvieną temą, o temos pavadinimas atlieka slaptažodžio vaidmenį. Su auth-file ir deny-all be prisijungimo duomenų niekas nepraeina. ntfy turi du vaidmenis: admin, kuris skaito ir rašo į visas temas, ir user, kuris turi tik jūsų suteiktas teises.

Terminal, pirmasis administratorius
docker compose exec ntfy ntfy user add --role=admin alice

Komanda paprašo slaptažodžio, tada jo patvirtinimo. Komandos ntfy user, ntfy access ir ntfy token rašo tiesiai į naudotojų duomenų bazę: jos vykdomos serveryje, čia konteineryje, kuris tos duomenų bazės kelią skaito iš server.yml.

Vienas naudotojas ir vienas žetonas kiekvienam scenarijui

Prieigos žetonas šiuo metu suteikia visišką prieigą prie savo naudotojo paskyros, išskyrus slaptažodžio keitimą ir paskyros ištrynimą. Scenarijui sukurkite atskirą naudotoją, apribotą jo temomis, tada jam ž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

Tada scenarijus skelbia su savo žetonu, per HTTPS:

Terminal, skelbiančioje mašinoje
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 auth slaptažodis tik užkoduojamas base64, o ne šifruojamas: dokumentacija prašo HTTPS kiekviename savarankiškai talpinamame serveryje. Būtent tai aprašo kitas skyrius.

HTTPS: atvirkštinis tarpinis serveris

ntfy gali pati teikti HTTPS, tačiau už tarpinio serverio dokumentacija rekomenduoja TLS užbaigimą palikti tarpiniam serveriui. Svarbiausi yra du dalykai:

Su Caddy

Dokumentacija pažymi, kad Caddy su reverse_proxy tvarko ir HTTP, ir WebSocket, be jokių papildomų nustatymų. Let’s Encrypt sertifikatą ji gauna pati:

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

Su Nginx

Šis blokas seka dokumentacijos konfigūraciją, artimą tai, kurią naudoja ntfy.sh: srautams išjungtas buferizavimas, 3 minučių laiko limitai ir jokios užklausų turinio dydžio ribos, nes ntfy jį riboja pati. Jis klausosi 80 prievado, kad HTTPS įdiegtų Certbot:

/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

Kai HTTP peradresuoja į HTTPS, savo scenarijuose skelbkite adresais https://. Tūkstančiams prenumeratorių dokumentacija padidina worker_connections faile nginx.conf ir Nginx paslaugos LimitNOFILE iki dvigubo siekiamų ryšių skaičiaus.

Android, iOS ir žiniatinklio programėlės

ntfy programėlės prideda jūsų serverio temas taip pat, kaip ir ntfy.sh temas: pridėdami temą įveskite jo adresą, o apsaugotai temai, naudotojo, turinčio prie jos prieigą, vardą ir slaptažodį. Žiniatinklio programa teikiama paties serverio adresu.

Momentiniai pranešimai iOS

Pridėkite vieną eilutę į server.yml, tada paleiskite konteinerį iš naujo:

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

Tada kiekvienai žinutei jūsų serveris ntfy.sh paskelbia apklausos (poll) užklausą, kurioje yra tik žinutės ID ir temos URL SHA-256 maiša. ntfy.sh ją perduoda įrenginiui per Apple pranešimų paslaugą, tada programėlė atsisiunčia žinutę iš jūsų serverio. Per ntfy.sh einantis tekstas visada tas pats, „New message“, kad ir ką sakytų jūsų žinutė. Be šio nustatymo pranešimai vis tiek ateina, su vėlavimu, kuris, priklausomai nuo telefono būsenos, gali siekti kelias valandas. upstream-access-token prideda žetoną, jei viršijate ntfy.sh užklausų ribas.

Užklausų ribos ir priedai

ntfy riboja kiekvieną lankytoją, atpažįstamą pagal IP adresą, o IPv6 atveju pagal /64 potinklį. Šios ribos saugo serverį nuo piktnaudžiavimo; įprastai naudojant, pasak dokumentacijos, jų neturėtumėte pasiekti. Jas viršijus, serveris atsako 429 Too Many Requests. Numatytosios reikšmės:

NustatymasNumatytoji reikšmėKą jis riboja
visitor-request-limit-burst60Lankytojo užklausos vienu pliūpsniu
visitor-request-limit-replenish5sPapildymo sparta: viena užklausa kas 5 sekundes
visitor-subscription-limit30Atviri ryšiai vienam lankytojui
visitor-message-daily-limitNėraŽinutės per dieną, kitaip valdomos užklausų ribos
visitor-email-limit-burst16El. laiškai vienu pliūpsniu, tada vienas per valandą
visitor-attachment-total-size-limit100MPriedų saugykla vienam lankytojui
visitor-attachment-daily-bandwidth-limit500MPriedų srautas vienam lankytojui per dieną
global-topic-limit15 000Bendras serverio temų skaičius
message-size-limit4KŽinutės dydis; jį viršijus, ji tampa priedu

Pranešimai el. paštu

ntfy gali persiųsti žinutę el. paštu, kai skelbimo užklausoje yra antraštė Email arba X-Email su adresu. Tam ji naudoja išeinančio pašto SMTP serverį, per STARTTLS, su PLAIN ar LOGIN autentifikavimu: tai 587 prievadas. Iš Simafri VPS serverio el. paštas išeina per autentifikuotą SMTP persiuntimo serverį tuo pačiu 587 prievadu: čia nurodykite jau turimos el. pašto paskyros adresą arba savo el. laiškų pristatymo paslaugos adresą.

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

Atsarginės kopijos

Su SQLite ntfy kiekvieną duomenų rūšį laiko atskirame faile. Šio gido diegime viskas yra kataloguose etc ir lib, šalia compose.yaml:

ElementasKą jis saugoKopijuoti
etc/server.ymlKonfigūraciją, įskaitant SMTP paslaptis ir Web Push raktusTaip
lib/user.dbNaudotojus, prieigos valdymo įrašus, žetonus ir dienos skaitikliusTaip
lib/cache.dbPaskutinių 12 valandų žinutes, numatytaiNaudinga, jų gyvavimo laikas trumpas
lib/attachments/Paskutinių 3 valandų priedus, numatytaiNaudinga, jų gyvavimo laikas trumpas
Failas web-push-fileNaršyklių Web Push prenumeratas, jei jį įjungėteTaip

Kad SQLite failų kopija būtų nuosekli, kuriant archyvą sustabdykite paslaugą:

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

Suplanuokite šią kopiją ramiu metu ir siųskite ją už serverio ribų. Padėti jo diske, šie archyvai patenka ir į jo naktines atsargines kopijas. Norėdami atkurti, grąžinkite katalogus į vietą, tada paleiskite docker compose up -d.

Jei prarandate user.db be kopijos, naudotojai ir žetonai, deklaruoti server.yml per auth-users ir auth-tokens, sukuriami iš naujo paleidžiant; komandų eilutėje sukurtus reikia sukurti dar kartą.

Atnaujinimai

Su Docker pakeiskite atvaizdo žymą faile compose.yaml, pavyzdžiui, iš v2.38.1 į kitą versiją, tada:

Terminal, compose.yaml kataloge
docker compose pull
docker compose up -d

Katalogai etc ir lib lieka vietoje, o ntfy paleidimo metu pati migruoja savo duomenų bazes. Su Debian paketu tą patį atlieka sudo apt update, tada sudo apt upgrade.

Kiekvienos versijos pastabos dokumentacijos puslapyje „Releases“ skiltyje „Upgrade notes“ sugrupuoja tai, kas keičiasi esamam egzemplioriui, pavyzdžiui, 2.36.0 versijoje paleidžiant nuo šiol visiškai tikrinamą konfigūraciją ar į nulį atstatomus dienos skaitiklius. Perskaitykite jas prieš atnaujindami ir nukopijuokite abu katalogus prieš pat tai. 2.38.1 versija yra saugumo leidimas, kurį projektas primygtinai rekomenduoja: ji sustiprina žinučių šablonus prieš paslaugos trikdymo (denial-of-service) atakas ir neleidžia lėtiems priedų įkėlimams į S3 bei neatsakantiems web push galiniams taškams užimti atminties ir ryšių. Ji seka po 2.38.0 versijos, kuri dalijasi užklausų ribomis tarp klasterio mazgų ir yra sukompiliuota su Go 1.27.4.

Kas ką daro Managed VPS serveryje

Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; ntfy lieka jūsų programa su savo nustatymais ir duomenimis.

TemaMūsų komandosJūs
ServerisSistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryjeJūsų veiklai tinkamas momentas
StebėsenaServeris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučioJūsų egzemplioriaus žurnalų skaitymas
ntfyProaktyvi stebėsena: klaidos, sulėtėjimai, atviri ryšiai ir disko vieta pastebimi, rekomenduojamas pataisymasJos diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas
PrieigaServeris, kuriame ji veikia, stebimas ir saugomas atsarginėmis kopijomisNaudotojai, temų teisės ir jūsų scenarijų žetonai
Atsarginės kopijosKiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotasntfy savos kopijos ir atkūrimo prašymas, kai jo prireikia
PerkėlimasJūsų dabartinis serveris perkeliamas nemokamaiPerjungimo momentas

Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.

ntfy serveryje, kurį prižiūrime už jus

Su Simafri Managed VPS mūsų komandos palaiko jūsų ntfy egzemplioriaus serverį atnaujintą, stebi jį dieną ir naktį ir įsikiša nelaukdamos jūsų skambučio; jos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs arba jūsų DI asistentas. Atsarginės kopijos kiekvieną naktį šifruojamos ir saugomos už mašinos ribų, jų atkūrimas įskaičiuotas, o jūsų dabartinio serverio perkėlimas nemokamas.

Žiūrėti Managed VPS

Dažni klausimai

Ar ntfy nemokama įmonei?

Taip. ntfy platinama pagal dvigubą Apache 2.0 ir GPLv2 licenciją: darbe ją galite naudoti nieko nepirkdami dėl licencijos. Jų sąlygos taikomos programinės įrangos platinimui. Lieka tik ją vykdančio serverio kaina.

Kaip įdiegti ntfy su Docker Compose?

Sukurkite compose.yaml su atvaizdu binwiederhier/ntfy, komanda serve, katalogu, prijungtu prie /etc/ntfy failui server.yml, kitu, prijungtu prie /var/lib/ntfy duomenų bazėms, ir konteinerio 80 prievadu, paskelbtu adresu 127.0.0.1:2586. Paleiskite docker compose up -d, tada prieš šį prievadą pastatykite HTTPS atvirkštinį tarpinį serverį.

Kaip padaryti ntfy serverį privatų?

Faile server.yml nustatykite auth-file ir auth-default-access: deny-all. Tada sukurkite administratorių su ntfy user add --role=admin, ribotus naudotojus su ntfy user add, o jų teises temoms su ntfy access.

Kaip skelbti į ntfy iš scenarijaus su žetonu?

Sukurkite žetoną su ntfy token add scenarijui skirtam naudotojui, apribotam jo temomis, tada skelbkite su curl ir antrašte Authorization: Bearer, po kurios eina žetonas, per HTTPS. Žetonas suteikia prieigą prie visos jo naudotojo paskyros.

Kodėl ntfy reikia nustatyti behind-proxy?

Už atvirkštinio tarpinio serverio kiekviena užklausa ateina iš tarpinio serverio adreso. Su behind-proxy: true ntfy skaito antraštę X-Forwarded-For, kad atpažintų kiekvieną lankytoją; be jo visi dalijasi tomis pačiomis užklausų ribomis.

Ar ntfy pranešimai iPhone pasiekia iškart?

Taip, su upstream-base-url: "https://ntfy.sh" faile server.yml. Tada jūsų serveris per ntfy.sh perduoda signalą, kuriame yra tik žinutės ID, o programėlė atsisiunčia žinutę iš jūsų serverio. Be šio nustatymo pristatymas gali užtrukti kelias valandas.

Kaip sukurti ntfy atsarginę kopiją?

Kopijuokite server.yml ir user.db, kuriuose yra konfigūracija, naudotojai, teisės ir žetonai, taip pat Web Push failą, jei jis įjungtas. Žinučių podėlio ir priedų gyvavimo laikas trumpas. Kopijuodami sustabdykite paslaugą, kad SQLite failai būtų nuoseklūs.

Ar Managed VPS apima ntfy?

Managed VPS apima serverį: sistemą, saugumą, stebėseną ir atsargines kopijas. Mūsų komandos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs. Įsikišimas į pačią programą apmokestinamas valandomis arba fiksuota kaina.

Šaltiniai ir oficiali dokumentacija

Susisiekite su mumis