Găzduirea ntfy pe un Managed VPS: notificări push de pe propriul server

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.

Simon Vasconcelos Lee Autor: Publicat la 21 noiembrie 2026Timp de citire: 15 minute

Toate ghidurile

Esențialul

  1. ntfy primește un mesaj printr-o cerere HTTP PUT sau POST către un topic și îl trimite imediat telefoanelor, browserelor și scripturilor abonate la acel topic.
  2. Dubla sa licență, Apache 2.0 și GPLv2, vă permite să îl rulați liber în firmă; condițiile ei se aplică redistribuirii software-ului.
  3. Instalați-l cu Docker Compose: imaginea 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.
  4. Implicit, oricine poate citi și scrie în toate topicurile: setați auth-default-access: deny-all, creați un administrator cu ntfy user add, apoi dați fiecărui script propriul token și permisiuni limitate.
  5. Faceți backup la 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.

Ce face ntfy

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.

Terminal, un prim mesaj
curl -d "Backup finished" https://ntfy.example.com/backups

Licențele Apache 2.0 și GPLv2, și marca

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.

Resursele de prevăzut

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ță:

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

Instalarea cu Docker Compose

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:

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

Apoi fișierul de configurare, în etc/server.yml, cu adresa publică a serverului dumneavoastră:

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, în directorul fișierului compose.yaml
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Serverul răspunde {"healthy":true,"role":"active"}. Ce face fiecare setare:

Fără Docker: depozitul Debian și Ubuntu

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:

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

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

Utilizatori, controlul accesului și tokenuri

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.

Terminal, primul administrator
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.

Un utilizator și un token pentru fiecare script

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:

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

Scriptul publică apoi cu tokenul său, în HTTPS:

Terminal, pe mașina care publică
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.

HTTPS: proxy-ul invers

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:

Cu Caddy

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:

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

Cu Nginx

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:

/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

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 Android, iOS și web

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.

Notificările instantanee pe iOS

Adăugați o linie în server.yml, apoi reporniți containerul:

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

Limitele de rată și atașamentele

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:

SetareImplicitCe limitează
visitor-request-limit-burst60Cererile unui vizitator într-o rafală
visitor-request-limit-replenish5sRitmul de reîncărcare: o cerere la fiecare 5 secunde
visitor-subscription-limit30Conexiunile deschise per vizitator
visitor-message-daily-limitNiciunaMesajele pe zi, altfel reglate de limita de cereri
visitor-email-limit-burst16E-mailurile într-o rafală, apoi unul pe oră
visitor-attachment-total-size-limit100MSpațiul pentru atașamente per vizitator
visitor-attachment-daily-bandwidth-limit500MTraficul de atașamente per vizitator pe zi
global-topic-limit15.000Numărul total de topicuri ale serverului
message-size-limit4KDimensiunea unui mesaj; peste ea, devine atașament

Notificările prin e-mail

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.

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

Backupurile

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:

ElementCe păstreazăDe salvat
etc/server.ymlConfigurația, inclusiv secretele SMTP și cheile Web PushDa
lib/user.dbUtilizatorii, intrările de control al accesului, tokenurile și contoarele zilniceDa
lib/cache.dbMesajele din ultimele 12 ore, implicitUtil, durata sa de viață este scurtă
lib/attachments/Atașamentele din ultimele 3 ore, implicitUtil, durata sa de viață este scurtă
Fișierul web-push-fileAbonamentele Web Push ale browserelor, dacă l-ați activatDa

Pentru o copie coerentă a fișierelor SQLite, opriți serviciul cât timp se creează arhiva:

Terminal, în directorul fișierului compose.yaml
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.

Actualizările

Cu Docker, schimbați eticheta imaginii în compose.yaml, de exemplu de la v2.38.1 la versiunea următoare, apoi:

Terminal, în directorul fișierului compose.yaml
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.

Cine ce face pe un Managed VPS

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.

SubiectEchipele noastreDumneavoastră
ServerulActualizări de sistem și de securitate, intervenții pe server incluseMomentul potrivit activității dumneavoastră
MonitorizareaServer urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelulCitirea jurnalelor instanței dumneavoastră
ntfyUrmă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
AccesulServerul care îl poartă, supravegheat și salvatUtilizatorii, 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
MigrareaServerul dumneavoastră actual migrat, gratuitMomentul 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.

ntfy, pe un server întreținut pentru dumneavoastră

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

Descoperiți gama Managed VPS

Întrebări frecvente

Este ntfy gratuit pentru o firmă?

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

Cum instalez ntfy cu Docker Compose?

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.

Cum fac privat un server ntfy?

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

Cum public în ntfy dintr-un script cu un token?

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.

De ce să setez behind-proxy în ntfy?

Î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ă.

Ajung notificările ntfy imediat pe un iPhone?

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.

Cum fac backup la ntfy?

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.

Acoperă un Managed VPS și ntfy?

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.

Surse și documentație oficială

Ghiduri conexe

Găzduirea Uptime Kuma pe un Managed VPS: monitorizați-vă serviciile continuuGăzduirea Uptime Kuma pe un Managed VPS înseamnă să vă monitorizați site-urile, API-urile și serverele de pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Uptime Kuma este un software liber sub licență MIT. Acest ghid urmează documentația sa oficială: instalarea cu Docker Compose, HTTPS, baza de date, notificările, backupurile și actualizările.Diferența dintre VPS administrat și neadministrat: cine ce faceDiferența dintre un VPS administrat și unul neadministrat ține de o singură întrebare: cine se ocupă de server după ce acesta funcționează. Totuși, „administrat” (managed) nu are o definiție oficială: de la un furnizor la altul, cuvântul acoperă orice, de la simpla instalare a sistemului până la exploatarea completă a serverului. Acest ghid arată cine ce face, rând cu rând, inclusiv la nivelul intermediar al asistenței, și oferă întrebările care înlătură ambiguitatea înainte de semnare.Backupurile unui VPS: ce trebuie să verificați înainte de a semnaO ofertă de VPS anunță aproape mereu „backupuri incluse”. În spatele acestor două cuvinte se poate afla o copie făcută în fiecare noapte, păstrată în afara mașinii și restaurată de experți, sau un snapshot pus pe același disc ca serverul. Acest ghid prezintă întrebările care fac diferența, ce înseamnă fiecare răspuns și modul de a verifica faptul că un backup se poate restaura.
Contactați-ne