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.
Autor: Simon Vasconcelos Lee
Opublikowano 21 listopada 2026Czas czytania: 15 minut
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.auth-default-access: deny-all, utworzyć administratora poleceniem ntfy user add, a następnie dać każdemu skryptowi własny token i ograniczone uprawnienia.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.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.
curl, skryptu, zadania cyklicznego czy innej aplikacji. Wiadomość może mieć tytuł, priorytet od 1 do 5, tagi i emoji, załącznik, przyciski akcji lub opóźniony czas dostarczenia.ntfy lub API, przez WebSocket albo strumień HTTP, który pozostaje otwarty.curl -d "Backup finished" https://ntfy.example.com/backups
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.
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ę:
nofile. Usługa systemd z pakietu ustawia go na 10 000.Na Managed VPS wystarczy opisać nam swoje użycie, liczbę subskrybujących urządzeń, wolumen wiadomości i załączniki, a polecimy odpowiedni rozmiar.
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:
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:
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
Serwer odpowiada {"healthy":true,"role":"active"}. Co robi każde ustawienie:
127.0.0.1:2586: przykłady Docker w dokumentacji publikują port 80 na wszystkich adresach, a jej przykłady odwrotnego proxy przekazują ruch do 127.0.0.1:2586. Tak opublikowany port jest osiągalny tylko z samego serwera, a do API dociera się wyłącznie przez odwrotne proxy, po HTTPS.base-url: publiczny adres usługi. Przykładowy plik server.yml wymaga go dla załączników, wysyłania e-maili i powiadomień iOS z serwera hostowanego samodzielnie.cache-file: bez niego wiadomości pozostają w pamięci przez 12 godzin i giną przy restarcie. Ta pamięć podręczna pozwala telefonom z niestabilnym połączeniem pobrać wiadomości, które je ominęły.attachment-cache-dir: włącza załączniki. ntfy przejmuje pełną kontrolę nad tym katalogiem, dlatego proszę przeznaczyć go wyłącznie do tego celu.auth-file i auth-default-access: deny-all: baza użytkowników i uprawnień, tworzona przy pierwszym uruchomieniu, oraz domyślna odmowa dostępu anonimowego. To ustawienie dokumentacja zaleca dla prywatnej instancji.behind-proxy: bez niego, za proxy, wszyscy odwiedzający dzielą adres IP proxy i te same limity żądań.enable-login: pozwala logować się do aplikacji webowej. Otwarta rejestracja pozostaje zamknięta, ponieważ enable-signup ma domyślnie wartość false.v2.38.1 przypina wersję; latest podąża za najnowszym wydaniem. Dokumentacja proponuje też user: UID:GID dla konta innego niż root: pliki w etc i lib należą wtedy do niego.Projekt publikuje też repozytorium pakietów, podpisane kluczem o odcisku 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Na serwerze 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
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".
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.
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.
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:
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 lub deny, dla konkretnego tematu albo dla wzorca takiego jak alerts-*, jedynego obsługiwanego symbolu wieloznacznego.everyone, czyli *. Dla UnifiedPush na prywatnej instancji dokumentacja otwiera tematy zaczynające się od up tylko do zapisu: ntfy access '*' 'up*' write-only.tk_, mogą wygasać dzięki --expires=30d, a każdy użytkownik może mieć ich do 60. ntfy token list je wyświetla, ntfy token remove usuwa jeden z nich.auth-users, auth-access i auth-tokens tworzą te same obiekty z server.yml, przy każdym uruchomieniu. Użytkownik usunięty z tej listy zostaje usunięty z bazy przy następnym restarcie.Skrypt publikuje następnie ze swoim tokenem, po 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
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.
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:
Upgrade i Connection i pozwala tym długim połączeniom trwać. ntfy domyślnie wysyła wiadomość podtrzymującą co 45 sekund, keepalive-interval, aby żaden pośrednik nie zamknął ich z powodu bezczynności.behind-proxy: true ntfy odczytuje nagłówek X-Forwarded-For i bierze z niego adres skrajnie prawy, ten, który dodaje Państwa proxy. Limity żądań dotyczą tego adresu.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:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
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:
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
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 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.
ntfy webpush keys i ważnego certyfikatu HTTPS.Proszę dodać jeden wiersz do server.yml, a następnie zrestartować kontener:
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.
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:
| Ustawienie | Domyślnie | Co ogranicza |
|---|---|---|
visitor-request-limit-burst | 60 | Żądania odwiedzającego w jednej serii |
visitor-request-limit-replenish | 5s | Tempo uzupełniania: jedno żądanie co 5 sekund |
visitor-subscription-limit | 30 | Otwarte połączenia na odwiedzającego |
visitor-message-daily-limit | Brak | Wiadomości dziennie, poza tym regulowane limitem żądań |
visitor-email-limit-burst | 16 | E-maile w jednej serii, potem jeden na godzinę |
visitor-attachment-total-size-limit | 100M | Miejsce na załączniki na odwiedzającego |
visitor-attachment-daily-bandwidth-limit | 500M | Ruch załączników na odwiedzającego dziennie |
global-topic-limit | 15 000 | Łączna liczba tematów na serwerze |
message-size-limit | 4K | Rozmiar wiadomości; powyżej staje się ona załącznikiem |
visitor-request-limit-exempt-hosts, listy adresów IP lub nazw hostów.ntfy tier, dają niektórym kontom wyższe limity.attachment-file-size-limit, domyślnie 15M, ogranicza każdy plik, attachment-total-size-limit, 5G, cały magazyn, a attachment-expiry-duration, 3h, ich czas życia. Załącznik nigdy nie żyje dłużej niż jego wiadomość: aby dłużej przechowywać załączniki, proszę podnieść także cache-duration.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.
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 są wymagane, gdy tylko ustawiono smtp-sender-addr: bez nich serwer odmawia uruchomienia.smtp-sender-verify: true ogranicza wysyłkę do adresów, które każdy użytkownik zweryfikował na swoim koncie, i zamyka ją dla użytkowników anonimowych.server.yml: proszę zostawić ten plik do odczytu tylko dla właściciela, poleceniem chmod 600.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:
| Element | Co przechowuje | Kopia zapasowa |
|---|---|---|
etc/server.yml | Konfigurację, w tym sekrety SMTP i klucze Web Push | Tak |
lib/user.db | Użytkowników, wpisy kontroli dostępu, tokeny i liczniki dzienne | Tak |
lib/cache.db | Wiadomości z ostatnich 12 godzin, domyślnie | Przydatna, czas życia danych jest krótki |
lib/attachments/ | Załączniki z ostatnich 3 godzin, domyślnie | Przydatna, czas życia danych jest krótki |
Plik web-push-file | Subskrypcje Web Push przeglądarek, jeśli je Państwo włączyli | Tak |
Aby uzyskać spójną kopię plików SQLite, proszę zatrzymać usługę na czas tworzenia archiwum:
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.
Przy Dockerze proszę zmienić tag obrazu w compose.yaml, na przykład z v2.38.1 na następną wersję, a następnie:
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.
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.
| Temat | Nasze zespoły | Państwo |
|---|---|---|
| Serwer | Aktualizacje systemu i zabezpieczeń, w tym interwencje na serwerze | Moment dogodny dla Państwa działalności |
| Nadzór | Serwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefon | Czytanie dzienników Państwa instancji |
| ntfy | Proaktywna 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ęp | Serwer, który go utrzymuje, nadzorowany i objęty kopiami zapasowymi | Użytkownicy, uprawnienia do tematów i tokeny Państwa skryptów |
| Kopie zapasowe | Co noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenie | Kopie właściwe dla ntfy oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne |
| Migracja | Migracja Państwa obecnego serwera, bezpłatna | Moment 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ą.
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.
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.
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.
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.
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.
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ń.
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.
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.
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.
Simafri
Porozmawiajmy o Państwa projekcie
Proszę powiedzieć nam w kilku słowach, czego Państwo potrzebują: odpowiemy szybko.
Dziękujemy! Państwa zapytanie zostało wysłane. Wkrótce się odezwiemy.
Wolą Państwo e-mail? Proszę napisać do nas na support@simafri.com.