Hosting ntfy na Managed VPS: powiadomienia push z Państwa własnego serwera

Hosting ntfy na Managed VPS oznacza, że wysyłają Państwo powiadomienia push zwykłym żądaniem HTTP, PUT lub POST, z maszyny, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. ntfy to wolne oprogramowanie udostępniane na dwóch licencjach: Apache 2.0 i GPLv2. Ten poradnik podąża za jego oficjalną dokumentacją w wersji 2.38.1: instalacja przez Docker Compose, plik server.yml, użytkownicy i kontrola dostępu, tokeny dostępu, HTTPS, aplikacje mobilne, e-mail, kopie zapasowe i aktualizacje.

Simon Vasconcelos Lee Autor: Opublikowano 21 listopada 2026Czas czytania: 15 minut

Wszystkie poradniki

W skrócie

  1. ntfy przyjmuje wiadomość przez żądanie HTTP PUT lub POST wysłane do tematu i natychmiast przekazuje ją na telefony, do przeglądarek i skryptów, które subskrybują ten temat.
  2. Jego podwójna licencja, Apache 2.0 i GPLv2, pozwala swobodnie uruchamiać go w pracy; jej warunki dotyczą rozpowszechniania oprogramowania.
  3. Proszę zainstalować go przez Docker Compose: obraz binwiederhier/ntfy, plik server.yml z base-url, cache-file i auth-file oraz port opublikowany na 127.0.0.1 za odwrotnym proxy z HTTPS.
  4. Domyślnie każdy może czytać i zapisywać każdy temat: proszę ustawić auth-default-access: deny-all, utworzyć administratora poleceniem ntfy user add, a następnie dać każdemu skryptowi własny token i ograniczone uprawnienia.
  5. Proszę kopiować server.yml i user.db, które przechowują konfigurację, użytkowników, uprawnienia i tokeny; aktualizacja polega na zmianie tagu obrazu, po lekturze informacji o wydaniu.

Co robi ntfy

ntfy, wymawiany „notify”, to usługa powiadomień typu publikacja i subskrypcja, oparta na HTTP. Jego README przedstawia go jako sposób na wysyłanie powiadomień na telefon lub komputer ze skryptów, z dowolnego komputera. Projekt prowadzi publiczną instancję, ntfy.sh, a serwer można hostować samodzielnie: tym zajmuje się ten poradnik.

Terminal, pierwsza wiadomość
curl -d "Backup finished" https://ntfy.example.com/backups

Licencje Apache 2.0 i GPLv2 oraz znak towarowy

README ntfy stwierdza, że projekt jest udostępniany na dwóch licencjach: na licencji Apache 2.0, w pliku LICENSE, oraz na licencji GNU GPL w wersji 2, w pliku LICENSE.GPLv2. Obraz Docker deklaruje obie: Apache-2.0, GPL-2.0.

Uruchomienie ntfy na Państwa serwerze, dla firmy, zespołu czy klientów, nie wymaga więc zakupu żadnej licencji. Oba teksty dostarczają oprogramowanie bez gwarancji.

Licencja obejmuje kod. Nazwa to osobna kwestia: licencja Apache 2.0 nie przyznaje żadnych praw do znaków towarowych licencjodawcy, a warunki korzystania z ntfy.sh stanowią, że nazwa ntfy, logo i identyfikacja wizualna są znakami towarowymi ntfy LLC, których użycie w związku z produktem lub usługą wymaga jej uprzedniej pisemnej zgody. Ten poradnik wymienia nazwę ntfy, aby opisać oprogramowanie.

Ta publikacja jest niezależna od projektu ntfy i od ntfy LLC: nie jest z nimi powiązana ani przez nie sponsorowana czy zatwierdzona.

Zasoby do zaplanowania

Serwer to pojedynczy, statycznie linkowany plik binarny dla amd64, armv7 i arm64; obraz Docker jest dostępny także dla armv6. Dokumentacja nie podaje wartości dla pamięci ani procesora: przy serwerze domowym, jak pisze, skala nie powinna budzić obaw. Wskazuje natomiast, co ogranicza instancję:

Na Managed VPS wystarczy opisać nam swoje użycie, liczbę subskrybujących urządzeń, wolumen wiadomości i załączniki, a polecimy odpowiedni rozmiar.

Instalacja przez Docker Compose

Dokumentacja proponuje obraz binwiederhier/ntfy z Docker Hub. Udostępnia on aplikację webową i API na porcie 80 kontenera i nie zawiera pliku server.yml: konfiguracja trafia do katalogu zamontowanego w /etc/ntfy. Na serwerze z zainstalowanym Dockerem proszę utworzyć katalog i umieścić w nim ten compose.yaml, oparty na przykładzie z dokumentacji:

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

Następnie plik konfiguracyjny, w etc/server.yml, z publicznym adresem Państwa serwera:

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

Serwer odpowiada {"healthy":true,"role":"active"}. Co robi każde ustawienie:

Bez Dockera: repozytorium dla Debiana i Ubuntu

Projekt publikuje też repozytorium pakietów, podpisane kluczem o odcisku 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Na serwerze 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

Pakiet odczytuje /etc/ntfy/server.yml. Przykładowy plik zaleca /var/cache/ntfy/cache.db dla pamięci podręcznej i /var/lib/ntfy/user.db dla użytkowników, dwa katalogi, które tworzy pakiet. Za proxy proszę dodać listen-http: "127.0.0.1:2586".

Użytkownicy, kontrola dostępu i tokeny

Po instalacji serwer ntfy jest otwarty: każdy może czytać i zapisywać każdy temat, a nazwa tematu pełni rolę hasła. Z auth-file i deny-all nic nie przechodzi bez danych uwierzytelniających. ntfy ma dwie role: admin, która czyta i zapisuje wszystkie tematy, oraz user, która ma tylko przyznane jej uprawnienia.

Terminal, pierwszy administrator
docker compose exec ntfy ntfy user add --role=admin alice

Polecenie prosi o hasło, a potem o jego potwierdzenie. Polecenia ntfy user, ntfy access i ntfy token zapisują bezpośrednio do bazy użytkowników: działają na serwerze, tu wewnątrz kontenera, który odczytuje ścieżkę tej bazy z server.yml.

Jeden użytkownik i jeden token na skrypt

Token dostępu daje obecnie pełny dostęp do konta swojego użytkownika, z wyjątkiem zmiany hasła i usunięcia konta. Dla skryptu proszę utworzyć dedykowanego użytkownika, ograniczonego do jego tematów, a następnie token dla niego:

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

Skrypt publikuje następnie ze swoim tokenem, po HTTPS:

Terminal, na maszynie, która publikuje
curl \
  -H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
  -H "Title: Backup finished" \
  -H "Priority: high" \
  -d "The nightly backup went fine." \
  https://ntfy.example.com/backups

Hasło Basic auth jest jedynie zakodowane w base64, a nie zaszyfrowane: dokumentacja wymaga HTTPS na każdym serwerze hostowanym samodzielnie. Tym zajmuje się następna sekcja.

HTTPS: odwrotne proxy

ntfy potrafi sam obsługiwać HTTPS, ale za proxy dokumentacja zaleca pozostawienie terminacji TLS po stronie proxy. Dwie kwestie są ważniejsze od pozostałych:

Z Caddy

Dokumentacja zauważa, że Caddy obsługuje zarówno HTTP, jak i WebSocket dyrektywą reverse_proxy, bez dodatkowych ustawień. Sam uzyskuje certyfikat Let’s Encrypt:

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

Z Nginx

Ten blok podąża za konfiguracją z dokumentacji, bliską tej, której używa ntfy.sh: buforowanie wyłączone dla strumieni, limity czasu 3 minuty i brak limitu rozmiaru treści żądań, które ntfy ogranicza sam. Nasłuchuje na porcie 80, aby Certbot mógł skonfigurować 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

Gdy HTTP przekierowuje na HTTPS, proszę publikować w skryptach na adresy https://. Dla tysięcy subskrybentów dokumentacja podnosi worker_connections w nginx.conf i LimitNOFILE usługi Nginx do dwukrotności docelowej liczby połączeń.

Aplikacje na Androida, iOS i w przeglądarce

Aplikacje ntfy dodają tematy z Państwa serwera tak samo jak z ntfy.sh: przy dodawaniu tematu wystarczy wpisać adres serwera, a w przypadku tematu chronionego nazwę i hasło użytkownika, który ma do niego dostęp. Aplikacja webowa jest udostępniana pod adresem samego serwera.

Natychmiastowe powiadomienia na iOS

Proszę dodać jeden wiersz do server.yml, a następnie zrestartować kontener:

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

Przy każdej wiadomości Państwa serwer publikuje wtedy w ntfy.sh żądanie odpytania, które zawiera tylko identyfikator wiadomości i skrót SHA-256 adresu URL tematu. ntfy.sh przekazuje je urządzeniu przez usługę powiadomień Apple, a następnie aplikacja pobiera wiadomość z Państwa serwera. Tekst, który przechodzi przez ntfy.sh, jest zawsze ten sam, „New message”, bez względu na treść Państwa wiadomości. Bez tego ustawienia powiadomienia nadal docierają, z opóźnieniem, które w zależności od stanu telefonu może sięgać kilku godzin. upstream-access-token dodaje token, jeśli przekroczą Państwo limity żądań ntfy.sh.

Limity żądań i załączniki

ntfy ogranicza każdego odwiedzającego, rozpoznawanego po adresie IP, a w IPv6 po podsieci /64. Te limity chronią serwer przed nadużyciami; przy normalnym użyciu, jak podaje dokumentacja, nie powinni Państwo na nie trafić. Po ich przekroczeniu serwer odpowiada 429 Too Many Requests. Wartości domyślne:

UstawienieDomyślnieCo ogranicza
visitor-request-limit-burst60Żądania odwiedzającego w jednej serii
visitor-request-limit-replenish5sTempo uzupełniania: jedno żądanie co 5 sekund
visitor-subscription-limit30Otwarte połączenia na odwiedzającego
visitor-message-daily-limitBrakWiadomości dziennie, poza tym regulowane limitem żądań
visitor-email-limit-burst16E-maile w jednej serii, potem jeden na godzinę
visitor-attachment-total-size-limit100MMiejsce na załączniki na odwiedzającego
visitor-attachment-daily-bandwidth-limit500MRuch załączników na odwiedzającego dziennie
global-topic-limit15 000Łączna liczba tematów na serwerze
message-size-limit4KRozmiar wiadomości; powyżej staje się ona załącznikiem

Powiadomienia e-mail

ntfy może przekazać wiadomość e-mailem, gdy żądanie publikacji zawiera nagłówek Email, lub X-Email, z adresem. Korzysta przy tym z serwera SMTP poczty wychodzącej, przez STARTTLS, z uwierzytelnianiem PLAIN lub LOGIN: to port 587. Z VPS Simafri poczta wychodzi przez uwierzytelniony przekaźnik SMTP na tym samym porcie 587: proszę skonfigurować tutaj adres konta e-mail, które Państwo już mają, albo adres swojej usługi wysyłkowej.

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

Kopie zapasowe

Z SQLite ntfy przechowuje każdy rodzaj danych we własnym pliku. W instalacji z tego poradnika wszystko znajduje się w katalogach etc i lib, obok compose.yaml:

ElementCo przechowujeKopia zapasowa
etc/server.ymlKonfigurację, w tym sekrety SMTP i klucze Web PushTak
lib/user.dbUżytkowników, wpisy kontroli dostępu, tokeny i liczniki dzienneTak
lib/cache.dbWiadomości z ostatnich 12 godzin, domyślniePrzydatna, czas życia danych jest krótki
lib/attachments/Załączniki z ostatnich 3 godzin, domyślniePrzydatna, czas życia danych jest krótki
Plik web-push-fileSubskrypcje Web Push przeglądarek, jeśli je Państwo włączyliTak

Aby uzyskać spójną kopię plików SQLite, proszę zatrzymać usługę na czas tworzenia archiwum:

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

Proszę zaplanować tę kopię na spokojną porę i wysyłać ją poza serwer. Przechowywane na jego dysku, te archiwa wchodzą też w skład jego nocnych kopii zapasowych. Aby przywrócić dane, proszę odłożyć katalogi na miejsce, a następnie uruchomić docker compose up -d.

Jeśli utracą Państwo user.db bez kopii, użytkownicy i tokeny zadeklarowane w server.yml przez auth-users i auth-tokens zostaną odtworzone przy uruchomieniu; te utworzone w wierszu poleceń trzeba utworzyć ponownie.

Aktualizacje

Przy Dockerze proszę zmienić tag obrazu w compose.yaml, na przykład z v2.38.1 na następną wersję, a następnie:

Terminal, w katalogu z compose.yaml
docker compose pull
docker compose up -d

Katalogi etc i lib pozostają na miejscu, a ntfy sam migruje swoje bazy przy uruchomieniu. Przy pakiecie Debiana to samo robią sudo apt update, a potem sudo apt upgrade.

Informacje o każdej wersji, na stronie „Releases” dokumentacji, zbierają w części „Upgrade notes” to, co zmienia się dla istniejącej instancji, na przykład w 2.36.0 konfigurację sprawdzaną odtąd w całości przy uruchomieniu czy wyzerowane liczniki dzienne. Proszę przeczytać je przed aktualizacją i tuż przed nią skopiować oba katalogi. Wersja 2.38.1 to wydanie bezpieczeństwa, które projekt usilnie zaleca: wzmacnia szablony wiadomości przed atakami odmowy usługi i nie pozwala, by powolne przesyłanie załączników do S3 oraz nieodpowiadające punkty końcowe web push blokowały pamięć i połączenia. Następuje po wersji 2.38.0, która współdzieli limity żądań między węzłami klastra i jest zbudowana z Go 1.27.4.

Kto za co odpowiada na Managed VPS

Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; ntfy pozostaje Państwa oprogramowaniem, z jego ustawieniami i danymi.

TematNasze zespołyPaństwo
SerwerAktualizacje systemu i zabezpieczeń, w tym interwencje na serwerzeMoment dogodny dla Państwa działalności
NadzórSerwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefonCzytanie dzienników Państwa instancji
ntfyProaktywna opieka: wychwytujemy błędy, spowolnienia, otwarte połączenia i brak miejsca na dysku oraz polecamy poprawkęInstalacja, aktualizacje i ustawienia, które wdrażają Państwo sami albo Państwa asystent AI
DostępSerwer, który go utrzymuje, nadzorowany i objęty kopiami zapasowymiUżytkownicy, uprawnienia do tematów i tokeny Państwa skryptów
Kopie zapasoweCo noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenieKopie właściwe dla ntfy oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne
MigracjaMigracja Państwa obecnego serwera, bezpłatnaMoment przełączenia

Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.

ntfy na serwerze prowadzonym za Państwa

Z Managed VPS od Simafri nasze zespoły utrzymują serwer Państwa instancji ntfy w aktualności, nadzorują go dniem i nocą i interweniują bez czekania na Państwa telefon; proaktywnie czuwają także nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami albo Państwa asystent AI. Kopie zapasowe są szyfrowane co noc i przechowywane poza maszyną, ich przywracanie jest w cenie, a migracja obecnego serwera jest bezpłatna.

Poznaj Managed VPS

Częste pytania

Czy ntfy jest bezpłatny dla firmy?

Tak. ntfy jest udostępniany na dwóch licencjach, Apache 2.0 i GPLv2: mogą Państwo uruchamiać go w firmie bez zakupu licencji. Ich warunki dotyczą rozpowszechniania oprogramowania. Pozostaje koszt serwera, na którym działa.

Jak zainstalować ntfy przez Docker Compose?

Proszę utworzyć compose.yaml z obrazem binwiederhier/ntfy, poleceniem serve, katalogiem zamontowanym w /etc/ntfy na server.yml, drugim w /var/lib/ntfy na bazy danych oraz portem 80 kontenera opublikowanym na 127.0.0.1:2586. Proszę uruchomić docker compose up -d, a następnie postawić przed tym portem odwrotne proxy z HTTPS.

Jak uczynić serwer ntfy prywatnym?

W server.yml proszę ustawić auth-file i auth-default-access: deny-all. Następnie proszę utworzyć administratora poleceniem ntfy user add --role=admin, użytkowników z ograniczonym dostępem poleceniem ntfy user add, a ich uprawnienia do tematów poleceniem ntfy access.

Jak publikować w ntfy ze skryptu za pomocą tokenu?

Proszę utworzyć token poleceniem ntfy token add dla użytkownika przeznaczonego dla skryptu, ograniczonego do jego tematów, a następnie publikować przez curl z nagłówkiem Authorization: Bearer, po którym następuje token, po HTTPS. Token daje dostęp do całego konta swojego użytkownika.

Po co ustawiać behind-proxy w ntfy?

Za odwrotnym proxy każde żądanie przychodzi z adresu proxy. Z behind-proxy: true ntfy odczytuje nagłówek X-Forwarded-For, aby rozpoznać każdego odwiedzającego; bez tego wszyscy dzielą te same limity żądań.

Czy powiadomienia ntfy docierają na iPhone’a od razu?

Tak, z upstream-base-url: "https://ntfy.sh" w server.yml. Państwa serwer zleca wtedy ntfy.sh przekazanie sygnału, który zawiera tylko identyfikator wiadomości, a aplikacja pobiera wiadomość z Państwa serwera. Bez tego ustawienia dostarczenie może trwać kilka godzin.

Jak wykonać kopię zapasową ntfy?

Proszę kopiować server.yml i user.db, które przechowują konfigurację, użytkowników, uprawnienia i tokeny, a także plik Web Push, jeśli jest włączony. Pamięć podręczna wiadomości i załączniki mają krótki czas życia. Na czas kopiowania proszę zatrzymać usługę, aby pliki SQLite były spójne.

Czy Managed VPS obejmuje ntfy?

Managed VPS obejmuje serwer: system, bezpieczeństwo, nadzór i kopie zapasowe. Nasze zespoły proaktywnie czuwają też nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami. Interwencja w aplikacji jest rozliczana godzinowo lub ryczałtowo.

Źródła i oficjalna dokumentacja

Powiązane poradniki

Hosting Uptime Kuma na Managed VPS: Państwa usługi pod stałym nadzoremHosting Uptime Kuma na Managed VPS oznacza, że Państwa strony, API i serwery są monitorowane z maszyny, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. Uptime Kuma to wolne oprogramowanie na licencji MIT. Ten poradnik podąża za jego oficjalną dokumentacją: instalacja przez Docker Compose, HTTPS, baza danych, powiadomienia, kopie zapasowe i aktualizacje.Różnica między VPS zarządzanym a niezarządzanym: kto co robiRóżnica między VPS zarządzanym a niezarządzanym sprowadza się do jednego pytania: kto zajmuje się serwerem, gdy już działa. Samo słowo „zarządzany” nie ma przy tym oficjalnej definicji: u różnych firm hostingowych oznacza wszystko, od samej instalacji systemu po pełne prowadzenie serwera. Ten poradnik pokazuje, kto co robi, punkt po punkcie, łącznie z pośrednim poziomem, jakim jest wsparcie, i podaje pytania, które rozwiewają wątpliwości przed podpisaniem umowy.Kopie zapasowe VPS: co sprawdzić przed podpisaniem umowyOferta VPS prawie zawsze zapowiada „kopie zapasowe w cenie”. Za tymi słowami może kryć się kopia wykonywana co noc, przechowywana poza maszyną i przywracana przez ekspertów, albo migawka zapisana na tym samym dysku co serwer. Ten poradnik podaje pytania, które robią różnicę, wyjaśnia, co oznacza każda odpowiedź, i pokazuje, jak sprawdzić, czy kopię da się przywrócić.
Skontaktuj się z nami