Găzduirea ntfy pe un Managed VPS înseamnă să trimiteți notificări push cu o simplă cerere HTTP, PUT sau POST, de pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. ntfy este un software liber cu dublă licență, Apache 2.0 și GPLv2. Acest ghid urmează documentația sa oficială la versiunea 2.38.1: instalarea cu Docker Compose, fișierul server.yml, utilizatorii și controlul accesului, tokenurile de acces, HTTPS, aplicațiile mobile, e-mailul, backupurile și actualizările.
Autor: Simon Vasconcelos Lee
Publicat la 21 noiembrie 2026Timp de citire: 15 minute
binwiederhier/ntfy, un server.yml cu base-url, cache-file și auth-file, iar portul publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.auth-default-access: deny-all, creați un administrator cu ntfy user add, apoi dați fiecărui script propriul token și permisiuni limitate.server.yml și user.db, care păstrează configurația, utilizatorii, permisiunile și tokenurile; actualizați schimbând eticheta imaginii, după ce citiți notele versiunii.ntfy, care se pronunță „notify”, este un serviciu de notificări de tip publicare și abonare bazat pe HTTP. README-ul său îl prezintă ca pe o modalitate de a trimite notificări pe telefon sau pe computer din scripturi, de pe orice mașină. Proiectul întreține o instanță publică, ntfy.sh, iar serverul poate fi găzduit pe propriul server: despre asta este vorba în acest ghid.
curl, dintr-un script, dintr-o sarcină programată sau dintr-o altă aplicație. Un mesaj poate avea un titlu, o prioritate de la 1 la 5, etichete și emoji, un atașament, butoane de acțiune sau o oră de livrare amânată.ntfy sau API-ul, prin WebSocket ori printr-un flux HTTP care rămâne deschis.curl -d "Backup finished" https://ntfy.example.com/backups
README-ul ntfy precizează că proiectul are o dublă licență: Apache License 2.0, în fișierul LICENSE, și GNU GPL versiunea 2, în LICENSE.GPLv2. Imaginea Docker le declară pe amândouă, Apache-2.0, GPL-2.0.
Rularea ntfy pe serverul dumneavoastră, pentru firma, echipa sau clienții dumneavoastră, nu cere așadar nicio licență de cumpărat. Ambele texte furnizează software-ul fără garanție.
Licența acoperă codul. Numele este o altă chestiune: Apache License 2.0 nu acordă niciun drept asupra mărcilor licențiatorului, iar condițiile de utilizare ale ntfy.sh precizează că numele, logoul și identitatea vizuală ntfy sunt mărci ale ntfy LLC, a căror folosire în legătură cu un produs sau un serviciu necesită acordul ei prealabil scris. Acest ghid numește ntfy pentru a descrie software-ul.
Această publicație este independentă de proiectul ntfy și de ntfy LLC și nu este afiliată, sponsorizată sau aprobată de acestea.
Serverul este un singur binar legat static, pentru amd64, armv7 și arm64; imaginea Docker există și pentru armv6. Documentația nu dă nicio cifră pentru memorie sau procesor: pentru un server de acasă, spune ea, scara nu este o grijă. Indică în schimb ce limitează o instanță:
nofile. Serviciul systemd al pachetului o fixează la 10.000.Pe un Managed VPS, descrieți-ne cum îl folosiți, numărul de dispozitive abonate, volumul de mesaje și atașamentele, iar noi vă recomandăm dimensiunea potrivită.
Documentația propune imaginea binwiederhier/ntfy de pe Docker Hub. Ea servește aplicația web și API-ul pe portul 80 al containerului și nu conține niciun fișier server.yml: configurația merge într-un director montat pe /etc/ntfy. Pe un server cu Docker instalat, creați un director și puneți în el acest compose.yaml, pornind de la exemplul din documentație:
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
Apoi fișierul de configurare, în etc/server.yml, cu adresa publică a serverului dumneavoastră:
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
Serverul răspunde {"healthy":true,"role":"active"}. Ce face fiecare setare:
127.0.0.1:2586: exemplele Docker din documentație publică portul 80 pe toate adresele, iar exemplele sale de proxy invers redirecționează către 127.0.0.1:2586. Publicat astfel, portul este accesibil doar de pe serverul însuși, iar API-ul se atinge numai prin proxy-ul invers, în HTTPS.base-url: adresa publică a serviciului. Fișierul server.yml de exemplu o cere pentru atașamente, trimiterea de e-mailuri și notificările iOS de pe un server găzduit de dumneavoastră.cache-file: fără el, mesajele rămân în memorie 12 ore și se pierd la repornire. Acest cache permite telefoanelor cu o conexiune instabilă să recupereze mesajele pe care le-au ratat.attachment-cache-dir: activează atașamentele. ntfy preia controlul deplin asupra acestui director, așa că păstrați-l doar pentru acest scop.auth-file și auth-default-access: deny-all: baza de date a utilizatorilor și permisiunilor, creată la prima pornire, și accesul anonim refuzat implicit. Este setarea pe care documentația o recomandă pentru o instanță privată.behind-proxy: fără el, în spatele unui proxy, toți vizitatorii împart adresa IP a proxy-ului și aceleași limite de rată.enable-login: permite conectarea la aplicația web. Înregistrarea liberă rămâne închisă, deoarece enable-signup are implicit valoarea false.v2.38.1 fixează versiunea; latest urmărește cea mai recentă versiune. Documentația propune și user: UID:GID pentru un cont diferit de root: fișierele din etc și lib îi aparțin atunci acestuia.Proiectul publică și un depozit de pachete, semnat cu cheia cu amprenta 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Pe un server 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
Pachetul citește /etc/ntfy/server.yml. Fișierul de exemplu recomandă /var/cache/ntfy/cache.db pentru cache și /var/lib/ntfy/user.db pentru utilizatori, două directoare pe care pachetul le creează. În spatele unui proxy, adăugați listen-http: "127.0.0.1:2586".
Din start, un server ntfy este deschis: oricine poate citi și scrie în toate topicurile, iar numele topicului ține loc de parolă. Cu auth-file și deny-all, nimic nu trece fără date de acces. ntfy are două roluri: admin, care citește și scrie în toate topicurile, și user, care are doar permisiunile pe care i le acordați.
docker compose exec ntfy ntfy user add --role=admin alice
Comanda cere parola, apoi confirmarea ei. Comenzile ntfy user, ntfy access și ntfy token scriu direct în baza de date a utilizatorilor: ele rulează pe server, aici în interiorul containerului, care citește calea acestei baze din server.yml.
Deocamdată, un token de acces dă acces complet la contul utilizatorului său, cu excepția schimbării parolei și a ștergerii contului. Pentru un script, creați un utilizator dedicat, limitat la topicurile sale, apoi un token pentru el:
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 sau deny, pe un topic anume sau pe un tipar precum alerts-*, singurul caracter wildcard acceptat.everyone, sau *. Pentru UnifiedPush pe o instanță privată, documentația deschide doar la scriere topicurile care încep cu up: ntfy access '*' 'up*' write-only.tk_, pot expira cu --expires=30d, iar fiecare utilizator poate păstra cel mult 60. ntfy token list le afișează, ntfy token remove șterge unul.auth-users, auth-access și auth-tokens creează aceleași obiecte din server.yml, la fiecare pornire. Un utilizator scos din această listă este șters din bază la următoarea repornire.Scriptul publică apoi cu tokenul său, în 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
O parolă în Basic auth este doar codificată în base64, nu criptată: documentația cere HTTPS pe orice server găzduit de dumneavoastră. Despre asta este secțiunea următoare.
ntfy poate servi singur HTTPS, dar în spatele unui proxy documentația recomandă să lăsați terminarea TLS în seama proxy-ului. Două aspecte contează mai mult decât restul:
Upgrade și Connection și lasă aceste conexiuni lungi să trăiască. ntfy trimite implicit un mesaj keepalive la fiecare 45 de secunde, keepalive-interval, pentru ca niciun intermediar să nu le închidă din lipsă de activitate.behind-proxy: true, ntfy citește antetul X-Forwarded-For și păstrează adresa cea mai din dreapta, cea pe care o adaugă proxy-ul dumneavoastră. Limitele de rată se aplică acestei adrese.Documentația notează că Caddy gestionează atât HTTP, cât și WebSocket cu reverse_proxy, fără nicio setare suplimentară. El obține singur certificatul Let’s Encrypt:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Acest bloc urmează configurația din documentație, apropiată de cea pe care o rulează ntfy.sh: bufferul dezactivat pentru fluxuri, timpi de așteptare de 3 minute și nicio limită de dimensiune pentru corpul cererilor, pe care ntfy le limitează singur. Ascultă pe portul 80 pentru ca Certbot să poată instala 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
Odată ce HTTP redirecționează către HTTPS, publicați spre adrese https:// în scripturile dumneavoastră. Pentru mii de abonați, documentația ridică worker_connections în nginx.conf și LimitNOFILE al serviciului Nginx, la dublul conexiunilor vizate.
Aplicațiile ntfy adaugă topicuri de pe serverul dumneavoastră la fel ca de pe ntfy.sh: introduceți adresa lui când adăugați topicul și, pentru un topic protejat, numele de utilizator și parola unui utilizator care are acces la el. Aplicația web este servită chiar la adresa serverului.
ntfy webpush keys și de un certificat HTTPS valid.Adăugați o linie în server.yml, apoi reporniți containerul:
upstream-base-url: "https://ntfy.sh"
Pentru fiecare mesaj, serverul dumneavoastră publică atunci pe ntfy.sh o cerere de interogare, care conține doar ID-ul mesajului și hash-ul SHA-256 al URL-ului topicului. ntfy.sh o transmite dispozitivului prin serviciul de notificări Apple, apoi aplicația preia mesajul de pe serverul dumneavoastră. Textul care trece prin ntfy.sh este mereu același, „New message”, orice ar spune al dumneavoastră. Fără această setare, notificările sosesc totuși, cu o întârziere care poate ajunge la câteva ore, în funcție de starea telefonului. upstream-access-token adaugă un token dacă depășiți limitele de rată ale ntfy.sh.
ntfy limitează fiecare vizitator, identificat prin adresa sa IP, iar în IPv6 prin subrețeaua sa /64. Aceste limite protejează serverul de abuzuri; la o utilizare normală, spune documentația, nu ar trebui să le atingeți. Peste ele, serverul răspunde 429 Too Many Requests. Valorile implicite:
| Setare | Implicit | Ce limitează |
|---|---|---|
visitor-request-limit-burst | 60 | Cererile unui vizitator într-o rafală |
visitor-request-limit-replenish | 5s | Ritmul de reîncărcare: o cerere la fiecare 5 secunde |
visitor-subscription-limit | 30 | Conexiunile deschise per vizitator |
visitor-message-daily-limit | Niciuna | Mesajele pe zi, altfel reglate de limita de cereri |
visitor-email-limit-burst | 16 | E-mailurile într-o rafală, apoi unul pe oră |
visitor-attachment-total-size-limit | 100M | Spațiul pentru atașamente per vizitator |
visitor-attachment-daily-bandwidth-limit | 500M | Traficul de atașamente per vizitator pe zi |
global-topic-limit | 15.000 | Numărul total de topicuri ale serverului |
message-size-limit | 4K | Dimensiunea unui mesaj; peste ea, devine atașament |
visitor-request-limit-exempt-hosts, o listă de adrese IP sau de nume de gazdă.ntfy tier, dau unor conturi limite mai mari.attachment-file-size-limit, implicit 15M, limitează fiecare fișier, attachment-total-size-limit, 5G, spațiul total, iar attachment-expiry-duration, 3h, durata lor de viață. Un atașament nu trăiește niciodată mai mult decât mesajul său: pentru a păstra atașamentele mai mult, măriți și cache-duration.ntfy poate redirecționa un mesaj prin e-mail când cererea de publicare poartă antetul Email, sau X-Email, cu o adresă. Pentru aceasta trece printr-un server SMTP de ieșire, în STARTTLS, cu autentificare PLAIN sau LOGIN: este portul 587. De pe un VPS Simafri, e-mailul pleacă printr-un releu SMTP autentificat pe același port 587: configurați aici adresa unui cont de e-mail pe care îl aveți deja sau pe cea a serviciului dumneavoastră de trimitere a e-mailurilor.
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 și smtp-sender-from sunt obligatorii de îndată ce smtp-sender-addr este setat: fără ele, serverul refuză să pornească.smtp-sender-verify: true limitează trimiterea la adresele pe care fiecare utilizator le-a verificat în contul său și o închide utilizatorilor anonimi.server.yml: păstrați acest fișier lizibil doar pentru proprietarul lui, cu chmod 600.Cu SQLite, ntfy păstrează fiecare tip de date în propriul fișier. În instalarea din acest ghid, totul se află în directoarele etc și lib, lângă compose.yaml:
| Element | Ce păstrează | De salvat |
|---|---|---|
etc/server.yml | Configurația, inclusiv secretele SMTP și cheile Web Push | Da |
lib/user.db | Utilizatorii, intrările de control al accesului, tokenurile și contoarele zilnice | Da |
lib/cache.db | Mesajele din ultimele 12 ore, implicit | Util, durata sa de viață este scurtă |
lib/attachments/ | Atașamentele din ultimele 3 ore, implicit | Util, durata sa de viață este scurtă |
Fișierul web-push-file | Abonamentele Web Push ale browserelor, dacă l-ați activat | Da |
Pentru o copie coerentă a fișierelor SQLite, opriți serviciul cât timp se creează arhiva:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Programați această copie la o oră liniștită și trimiteți-o în afara serverului. Păstrate pe discul lui, aceste arhive intră și în backupurile sale nocturne. Pentru restaurare, puneți directoarele la locul lor, apoi rulați docker compose up -d.
Dacă pierdeți user.db fără nicio copie, utilizatorii și tokenurile declarate în server.yml prin auth-users și auth-tokens sunt recreate la pornire; cele create din linia de comandă trebuie create din nou.
Cu Docker, schimbați eticheta imaginii în compose.yaml, de exemplu de la v2.38.1 la versiunea următoare, apoi:
docker compose pull
docker compose up -d
Directoarele etc și lib rămân pe loc, iar ntfy își migrează singur bazele de date la pornire. Cu pachetul Debian, sudo apt update, apoi sudo apt upgrade fac același lucru.
Notele fiecărei versiuni, pe pagina „Releases” a documentației, grupează sub „Upgrade notes” ce se schimbă pentru o instanță existentă, de pildă, în 2.36.0, o configurație verificată acum integral la pornire sau contoarele zilnice readuse la zero. Citiți-le înainte de actualizare și copiați ambele directoare chiar înainte. Versiunea 2.38.1 este o versiune de securitate, pe care proiectul o recomandă insistent: întărește șabloanele de mesaje împotriva atacurilor de tip denial of service și împiedică încărcările lente de atașamente către S3 și endpointurile web push care nu mai răspund să blocheze memoria și conexiunile. Urmează versiunii 2.38.0, care împarte limitele de rată între nodurile unui cluster și este compilată cu Go 1.27.4.
Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; ntfy rămâne software-ul dumneavoastră, cu setările și datele sale.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul potrivit activității dumneavoastră |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Citirea jurnalelor instanței dumneavoastră |
| ntfy | Urmărire proactivă: erori, încetiniri, conexiuni deschise și spațiu pe disc depistate, corectură recomandată | Instalarea, actualizările și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI |
| Accesul | Serverul care îl poartă, supravegheat și salvat | Utilizatorii, permisiunile pe topicuri și tokenurile scripturilor dumneavoastră |
| Backupurile | În fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusă | Copiile proprii ntfy și cererea de restaurare, când aveți nevoie de ea |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul trecerii |
Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.
Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră ntfy, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.
Da. ntfy are o dublă licență, Apache 2.0 și GPLv2: îl puteți rula în firmă fără nicio licență de cumpărat. Condițiile lor se aplică redistribuirii software-ului. Rămâne costul serverului pe care rulează.
Creați un compose.yaml cu imaginea binwiederhier/ntfy, comanda serve, un director montat pe /etc/ntfy pentru server.yml, altul pe /var/lib/ntfy pentru bazele de date și portul 80 al containerului publicat pe 127.0.0.1:2586. Rulați docker compose up -d, apoi puneți un proxy invers în HTTPS în fața acestui port.
În server.yml, setați auth-file și auth-default-access: deny-all. Creați apoi un administrator cu ntfy user add --role=admin, utilizatori limitați cu ntfy user add și permisiunile lor pe topicuri cu ntfy access.
Creați un token cu ntfy token add pentru un utilizator dedicat scriptului, limitat la topicurile sale, apoi publicați cu curl și antetul Authorization: Bearer urmat de token, în HTTPS. Un token dă acces la întregul cont al utilizatorului său.
În spatele unui proxy invers, fiecare cerere vine de la adresa proxy-ului. Cu behind-proxy: true, ntfy citește antetul X-Forwarded-For pentru a identifica fiecare vizitator; fără el, toți împart aceleași limite de rată.
Da, cu upstream-base-url: "https://ntfy.sh" în server.yml. Serverul dumneavoastră transmite atunci prin ntfy.sh un semnal care conține doar ID-ul mesajului, iar aplicația preia mesajul de pe serverul dumneavoastră. Fără această setare, livrarea poate dura câteva ore.
Salvați server.yml și user.db, care păstrează configurația, utilizatorii, permisiunile și tokenurile, plus fișierul Web Push dacă este activat. Cache-ul de mesaje și atașamentele au o durată de viață scurtă. Opriți serviciul în timpul copierii, pentru fișiere SQLite coerente.
Un Managed VPS acoperă serverul: sistemul, securitatea, monitorizarea și backupurile. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.