SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Własny serwer ntfy: konfiguracja powiadomień push

Dowiedz się, jak uruchomić ntfy w Docker Compose za własnym serwerem TLS. Zabezpiecz tematy za pomocą ACL oraz zintegruj powiadomienia z cron i systemd OnFailure w Linux.

Działanie własnego serwera ntfy

Własny serwer ntfy przekształca żądanie HTTP POST w powiadomienie push na telefonie. Publikacja odbywa się za pomocą curl, a wiadomość dociera do aplikacji na Androida, iOS, karty przeglądarki lub dowolnego innego klienta utrzymującego otwarte połączenie HTTP. Nie ma potrzeby instalowania bibliotek klienckich ani uruchamiania brokera wiadomości.

ntfy adresuje wiadomości za pomocą tematów (topics). Temat to nazwa w ścieżce URL, taka jak https://ntfy.example.com/alerts, która powstaje w momencie pierwszej publikacji. W domyślnej instalacji każdy, kto zna tę nazwę, może odczytywać i zapisywać wiadomości w temacie, dlatego dokumentacja projektu porównuje nazwę tematu do hasła. Ten model sprawdza się w publicznej usłudze ntfy.sh. Nie jest on jednak odpowiedni dla serwera przesyłającego powiadomienia o błędach kopii zapasowych, dlatego niniejszy przewodnik aktywuje uwierzytelnianie przed wysłaniem pierwszej wiadomości.

Wymagania wstępne

Wymagany jest serwer VPS z systemem Ubuntu 24.04 lub Debian 13, zainstalowanym Docker Engine oraz wtyczką Compose, nazwa domenowa oraz niewielka ilość pamięci RAM. Należy utworzyć rekord A w systemie DNS (domain name system), wskazujący ntfy.example.com na publiczny adres IP serwera, a następnie potwierdzić poprawność rozpoznawania nazwy przed wykonaniem jakichkolwiek dalszych czynności.

dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw status

Polecenie dig musi zwrócić adres IP serwera. Wystawienie certyfikatu wymaga, aby nazwa hosta była publicznie rozpoznawana jako adres serwera poprzez rekord A lub AAAA. Port 80 musi pozostać otwarty, ponieważ ACME (automatic certificate management environment), protokół obsługujący Let's Encrypt, wykorzystuje go do weryfikacji HTTP. Sam kontener ntfy nie otrzymuje publicznego portu.

Tworzenie pliku konfiguracyjnego ntfy

Obraz Docker nie zawiera pliku konfiguracyjnego, dlatego należy utworzyć go samodzielnie. Każde polecenie w dalszej części tego przewodnika odwołuje się do tego pliku. Najpierw należy ustalić identyfikator użytkownika (UID) oraz identyfikator grupy (GID), z którymi będzie uruchamiany kontener.

id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.yml
base-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: false

Cztery z tych linii mają kluczowe znaczenie. base-url musi być dokładnym publicznym adresem HTTPS, ponieważ ntfy używa go do generowania linków do załączników oraz powiadomień push dla systemu iOS w instancjach self-hosted. listen-http: ":2586" wiąże usługę ze wszystkimi interfejsami wewnątrz kontenera, co wygląda na niedbałość, ale jest poprawnym rozwiązaniem: kontener posiada własną przestrzeń nazw sieciowych, więc powiązanie z 127.0.0.1 sprawiłoby, że port byłby nieosiągalny z poziomu hosta, a opublikowany port Docker nigdy nie nawiązałby połączenia. auth-default-access: "deny-all" stanowi o całym poziomie bezpieczeństwa, ponieważ odmawia uprawnień do odczytu i zapisu każdemu, kto nie posiada wyraźnego zezwolenia. behind-proxy: true instruuje ntfy, aby pobierało adres klienta z nagłówka X-Forwarded-For, dzięki czemu limity zapytań (rate limits) zliczają rzeczywistych użytkowników, zamiast traktować reverse proxy jako jednego, bardzo aktywnego klienta.

enable-login: true umożliwia użytkownikom logowanie się przez aplikację webową lub API. enable-signup pozostaje ustawione na false, ponieważ samodzielne tworzenie kont na prywatnym serwerze stanowiłoby niepotrzebne ryzyko otwartego dostępu.

sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.yml

Uruchomienie ntfy za pomocą Docker Compose

Umieść to w /opt/ntfy/compose.yaml, zastępując 1000:1000 dwiema liczbami id -u i id -g podanymi powyżej.

services:
  ntfy:
    image: binwiederhier/ntfy:v2.36.0
    container_name: ntfy
    command: serve
    user: "1000:1000"
    environment:
      - TZ=UTC
    volumes:
      - /etc/ntfy:/etc/ntfy
      - /var/cache/ntfy:/var/cache/ntfy
      - /var/lib/ntfy:/var/lib/ntfy
    ports:
      - "127.0.0.1:2586:2586"
    restart: unless-stopped
cd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/health

Poprawnie działający serwer odpowiada {"healthy":true,"role":"active"}. Dwa szczegóły w tym pliku compose są zamierzone. Obraz jest przypięty do v2.36.0, czyli bieżącego stabilnego wydania na dzień 1 listopada 2026, zamiast latest, ponieważ przy latest następne docker compose pull pobiera bieżący obraz, a kolejne docker compose up -d odtwarza kontener z jego użyciem; samo pobranie nie zmienia wersji działającego serwera. Przypięcie nadal wymaga aktualizacji. Sam październik 2026 przyniósł dziesięć wydań: v2.29.0 w dniu 7 października, v2.30.0 w dniu 12 października, v2.31.0 i v2.31.1 w dniu 16 października, v2.32.0 w dniu 18 października, v2.33.0 i v2.33.1 w dniu 23 października, v2.34.0 w dniu 24 października, v2.35.0 w dniu 30 października oraz v2.36.0 w dniu 31 października. Wersja v2.31.0 naprawia błąd utraty wiadomości, gdy klient łączył się ponownie przed dotarciem do pamięci podręcznej wiadomości, ale przy ponownych połączeniach z since=<message ID> odczytywała ona każdą wiadomość w temacie z bazy danych, dlatego ntfy.sh wycofało tę wersję. Wersja v2.31.1 naprawia to obciążenie za pomocą nowego indeksu, a v2.34.0 naprawia problem, w którym cofnięci lub usunięci użytkownicy zachowywali niektóre subskrypcje. Wersja v2.35.0 naprawia błąd, w którym jednoczesne żądania traktowały poprawne poświadczenia jako anonimowe, oraz obejście autoryzacji bramki push Matrix w SQLite, więc należy zaktualizować starsze przypięcia do v2.36.0. Port jest publikowany jako 127.0.0.1:2586:2586, dzięki czemu kontener jest osiągalny tylko z adresu loopback hosta. Wpisanie 2586:2586 spowoduje, że Docker wstawi własne reguły firewalla przed Twoimi, co oznacza, że port odpowiada z Internetu, mimo że ufw status wskazuje, iż port jest zamknięty. Oba nawyki przenoszą się na kolejny dodawany kontener: własny przekaźnik RustDesk przypina tag obrazu w ten sam sposób, ale nie może ukryć się za loopbackiem, ponieważ jego porty sygnałowe i przekaźnikowe muszą odpowiadać z Internetu.

Jeśli curl wyświetla Connection refused, sprawdź dziennik kontenera. Błąd uprawnień na /var/lib/ntfy/user.db oznacza, że linia user: nie pasuje do właściciela tych katalogów, więc proces nie może utworzyć własnej bazy danych i kończy działanie. Podstawowy przewodnik po Docker Compose dla VPS omawia kwestie własności wolumenów i polityki restartu bardziej szczegółowo.

Zastosowanie Caddy jako terminatora TLS

Caddy automatycznie żąda i odnawia certyfikaty, co stanowi najszybszą drogę do wdrożenia TLS (transport layer security).

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy

Zastąp zawartość /etc/caddy/Caddyfile trzema liniami.

ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}
sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/health

Ten sam {"healthy":true,"role":"active"} dostępny przez HTTPS oznacza, że cała ścieżka działa poprawnie. Błąd 502 zwracany przez Caddy zazwyczaj oznacza, że ntfy nie nasłuchuje: sprawdź to za pomocą sudo ss -lntp | grep 2586. Jeśli ntfy nasłuchuje, a 502 nadal występuje, Caddy zapisze w logach błąd backendu, na przykład reset połączenia. Błąd certyfikatu zazwyczaj oznacza błędny rekord DNS lub brak możliwości zweryfikowania certyfikatu przez serwer na porcie 80 lub 443; sprawdź sudo journalctl -u caddy -n 50 pod kątem błędów walidacji. Dodanie kolejnej usługi w przyszłości wymaga jedynie dodania kolejnego bloku nazwy hosta w tym samym pliku Caddyfile; w ten sposób na przykład Halcyon, interfejs w stylu wypożyczalni kaset wideo z lat 90. dla biblioteki Jellyfin może zostać uruchomiony na drugiej subdomenie tego samego serwera.

Jeśli używasz już nginx, skopiuj ustawienia proxy udokumentowane dla ntfy: proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for oraz ustaw limity czasu odczytu i wysyłania na co najmniej trzy minuty. Subskrybent utrzymuje otwarte połączenie HTTP tak długo, jak długo nasłuchuje. Domyślny parametr proxy_read_timeout w nginx wynoszący 60 sekund liczy czas tylko między dwoma odczytami, a ntfy domyślnie wysyła komunikat keepalive co 45 sekund (keepalive-interval) właśnie po to, aby pośrednicy nie zamykali połączenia z powodu braku aktywności. Cichy subskrybent pozostaje zatem połączony nawet za standardowym nginx, a dłuższe limity czasu stanowią margines bezpieczeństwa, a nie mechanizm podtrzymujący połączenie. Jeśli zwiększysz keepalive-interval, utrzymuj tę wartość poniżej limitu czasu odczytu ustawionego w proxy.

Tworzenie użytkowników i ograniczanie dostępu do tematów

Uwierzytelnianie jest aktywne, a dostęp do zasobów pozostaje zablokowany, co jest zamierzonym działaniem. Należy utworzyć jedno konto administratora dla użytkownika oraz jedno konto maszynowe dla skryptów. Poniższe polecenia odczytują /etc/ntfy/server.yml z wnętrza kontenera, dlatego plik konfiguracyjny jest zamontowany jako wolumen.

sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user list

Każde polecenie user add wywołuje monit o podanie hasła. Administrator ignoruje listę kontroli dostępu i posiada uprawnienia do odczytu oraz zapisu wszystkich tematów, dlatego to konto powinno być zarezerwowane dla użytkownika i aplikacji mobilnej. robot to zwykły użytkownik, który nie posiada żadnych uprawnień, dopóki nie zostaną one nadane.

sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy access

Wpis na liście kontroli dostępu (ACL) składa się z użytkownika, tematu oraz uprawnienia. Temat może być nazwą własną lub wzorcem, w którym * dopasowuje dowolny ciąg znaków, dzięki czemu alerts_* obejmuje alerts_backup oraz alerts_db bez konieczności tworzenia osobnego polecenia dla każdego hosta. Uprawnienie write oznacza wyłącznie możliwość publikowania, co zapobiega sytuacji, w której token skradziony z zadania cron może subskrybować i odczytywać wysłane dane. Specjalna nazwa użytkownika everyone określa uprawnienia dla nieuwierzytelnionych gości. Przy ustawieniu deny-all jako wartości domyślnej, opcja ta jest używana głównie do udostępniania zasobów publicznych, takich jak ntfy access everyone status read; akceptuje ona również deny, gdy wymagana jest jawna reguła blokująca dostęp anonimowy do danego tematu.

Skrypty powinny korzystać z tokena, a nie z hasła użytkownika.

sudo docker compose exec ntfy ntfy token add robot

Polecenie wyświetla token rozpoczynający się od tk_. Token dziedziczy dokładnie te uprawnienia, które posiada przypisany do niego użytkownik, więc w tym przypadku może on jedynie publikować w tematach alerts i nie wykonywać żadnych innych operacji. ntfy token list wyświetla istniejące tokeny, a ntfy token remove unieważnia wybrany token bez zmiany hasła użytkownika.

Wysłanie pierwszej wiadomości i weryfikacja działania blokady

Rozpocznij od sprawdzenia, czy drzwi są zamknięte.

curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alerts

Polecenie to wyświetla 403, a 403 jest poprawną odpowiedzią: auth-default-access: "deny-all" odrzuca anonimowe publikacje. Teraz wyślij właściwą wiadomość.

curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
  -H "Title: Nightly backup finished" \
  -H "Priority: default" \
  -H "Tags: white_check_mark" \
  -d "42 GB copied in 11 minutes" \
  https://ntfy.example.com/alerts

Serwer odpowiada zapisaną wiadomością w formacie JSON, co potwierdza, że została ona zaakceptowana, a nie odrzucona. Title to pogrubiona pierwsza linia. Priority przyjmuje wartości od 1 do 5 lub nazwy od min do urgent i decyduje o tym, czy telefon wyemituje dźwięk. Tags zamieniają się w emoji w powiadomieniu, jeśli nazwa odpowiada znanemu krótkiemu kodowi emoji, w przeciwnym razie pozostają zwykłym tekstem.

Aby monitorować temat z poziomu terminala, przesyłaj go strumieniowo:

curl -s -u admin https://ntfy.example.com/alerts/raw

curl wyświetli monit o podanie hasła. Każda wiadomość dociera jako pojedyncza linia, a pojawiające się od czasu do czasu puste linie to sygnały podtrzymujące połączenie (keepalives). Otwarcie https://ntfy.example.com w przeglądarce i zalogowanie się na to samo konto zapewnia dostęp do wersji webowej tego samego strumienia.

Ustawienie limitów prędkości, aby jeden skrypt nie zalał serwera

Domyślnie każdy odwiedzający otrzymuje pulę 60 żądań, uzupełnianą o jedno żądanie co 5 sekund. Jest to wartość wystarczająca dla prywatnego serwera, a skrypt zablokowany w pętli ponawiania prób wykorzysta ją w całości. Dodaj limity do server.yml.

visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500
sudo docker compose restart ntfy

Odwiedzający przekraczający limit otrzymuje HTTP 429 zamiast dostarczonej wiadomości. Limit jest liczony na adres odwiedzającego, co jest powodem, dla którego behind-proxy: true ma tak duże znaczenie: bez tego ntfy widzi tylko adres Caddy, każdy klient jest liczony jako ten sam odwiedzający, a jeden uciążliwy skrypt wyczerpuje pulę, z której korzysta Twój telefon i inne serwery. Od wersji v2.36.0 dzienne liczby przetrwają restarty w bazie danych użytkowników, a limit każdego odwiedzającego resetuje się w jego własnym 24-godzinnym cyklu, zamiast o północy czasu UTC.

Powiadomienie o błędzie zadania cron

Nie należy umieszczać tokena w wierszu poleceń. ps aux wyświetla pełny wiersz poleceń każdego uruchomionego procesu wszystkim użytkownikom w systemie, więc token przekazany za pomocą -H jest możliwy do odczytania przez dowolne konto lokalne przez cały czas działania curl. Plik konfiguracyjny curl pozwala uniknąć tego problemu.

sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrc

Teraz należy przygotować skrypt zadania. Zapisz go jako /usr/local/bin/backup-with-alert.sh i nadaj mu uprawnienia chmod 750.

#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
  printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
    -H "Title: backup.sh failed with exit $code" \
    -H "Priority: high" \
    -H "Tags: warning" \
    --data-binary @- \
    https://ntfy.example.com/alerts
fi
exit "$code"
17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1

$? jest przechwytywane w wierszu bezpośrednio po poleceniu, ponieważ kolejne uruchomione polecenie nadpisałoby tę wartość. Dane wyjściowe są przetwarzane przez tail -c 1000, ponieważ ntfy wymusza maksymalny rozmiar wiadomości, a powiadomienie nie służy do przeglądania logów. Zamykające exit "$code" zachowuje oryginalny kod wyjścia, dzięki czemu każdy inny proces monitorujący to zadanie nadal wykryje błąd. Przetestuj całość, kierując skrypt na /bin/false podczas jednego uruchomienia.

Gałąź obsługi błędów, która nigdy się nie wykonuje, jest gorsza niż brak powiadomień, ponieważ sprawia wrażenie, że brak informacji oznacza sukces. Cron zapewnia zadaniu niemal puste środowisko i znacznie krótszą zmienną PATH niż powłoka logowania, więc skrypt działający poprawnie przy ręcznym uruchomieniu może zakończyć się przed dotarciem do linii z curl. Przewodnik dotyczący przyczyn nieuruchamiania się zadań cron omawia te pułapki środowiskowe. Należy wszędzie stosować ścieżki bezwzględne i po pierwszym zaplanowanym uruchomieniu sprawdzić plik logu, zamiast zakładać poprawne działanie.

Powiadamianie o awarii jednostki systemd

Cron obsługuje zadania zaplanowane. Usługi działające w tle wymagają OnFailure=, które systemd uruchamia, gdy jednostka przechodzi w stan failed. Należy utworzyć jedną jednostkę szablonową i używać jej dla każdej usługi w systemie. Plik należy zapisać jako /etc/systemd/system/ntfy-unit-failed@.service.

[Unit]
Description=Send an ntfy alert because %i failed

[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %i

Następnie należy wykonać /usr/local/bin/ntfy-unit-failed z uprawnieniami 750:

#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
  -H "Title: $unit failed on $(hostname -s)" \
  -H "Priority: urgent" \
  -H "Tags: rotating_light" \
  --data-binary @- \
  https://ntfy.example.com/alerts

Należy przypisać go do usługi za pomocą pliku typu drop-in, aby aktualizacja pakietu nie nadpisała wprowadzonych zmian.

sudo systemctl edit myapp.service
[Unit]
OnFailure=ntfy-unit-failed@%n.service

%n rozwija się do pełnej nazwy jednostki, więc instancja jednostki przyjmuje nazwę ntfy-unit-failed@myapp.service.service, a %i wewnątrz szablonu przekazuje myapp.service do skryptu jako pierwszy argument. Dzięki temu jeden szablon obsługuje każdą jednostkę. Działanie można zweryfikować za pomocą jednostki, która celowo kończy się błędem, zapisanej jako /etc/systemd/system/ntfy-selftest.service.

[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service

[Service]
Type=oneshot
ExecStart=/bin/false
sudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.service

Polecenie startowe kończy się kodem innym niż zero i wypisuje Job for ntfy-selftest.service failed because the control process exited with error code, a powiadomienie powinno pojawić się około sekundę później. Po zakończeniu testu należy usunąć jednostkę testową.

Należy zwrócić uwagę na jedną pułapkę. OnFailure= uruchamia się tylko wtedy, gdy jednostka osiągnie stan failed, a RestartMode=direct pomija ten stan podczas automatycznych restartów, więc pomija również procedurę obsługi awarii. Przy domyślnym ustawieniu RestartMode=normal, automatyczne restarty przechodzą przez stan awarii. StartLimitBurst oraz StartLimitIntervalSec kontrolują moment, w którym ponowne uruchomienia są odrzucane; należy je skonfigurować tak, aby pętla awarii ostatecznie została przerwana. Timery stanowią czystszy zamiennik dla powyższego wzorca cron, ponieważ jednostka usługi timera obsługuje ten sam plik typu drop-in OnFailure=, a przewodnik po usługach i timerach systemd na VPS zawiera instrukcję konwersji.

Integracja monitora dostępności z tym samym tematem

Uptime Kuma, self-hosted monitor statusu, posiada wbudowany typ powiadomień ntfy. Otwórz Settings, następnie Notifications, wybierz Setup Notification, wskaż Ntfy, ustaw adres URL serwera na https://ntfy.example.com oraz temat na alerts, wybierz priorytet i wklej token dostępu robot. Przed zapisaniem wyślij powiadomienie testowe, ponieważ błędna nazwa tematu zwraca błąd przy uprawnieniu write, które go nie obejmuje.

Realne ograniczenie tego rozwiązania: monitor działający na tym samym VPS nie poinformuje o awarii tego VPS, a ntfy nie dostarczy powiadomienia o awarii samego ntfy. Uruchom monitor na innej maszynie i skonfiguruj drugi kanał powiadomień, na przykład e-mail, dla monitora sprawdzającego ntfy. Typ monitora Push w Uptime Kuma rozwiązuje inny problem: zadanie cron wywołuje adres URL typu push po poprawnym zakończeniu pracy, a Kuma wysyła alert, gdy wywołania przestają docierać. Gałąź obsługi błędu uruchamia się tylko wtedy, gdy zadanie wystartuje, więc nie informuje o zadaniu, które w ogóle się nie rozpoczęło.

Czy samodzielnie hostowany ntfy działa na Androidzie i iPhone?

Na Androidzie tak, bez żadnych zastrzeżeń. Zainstaluj aplikację ze sklepu Google Play lub F-Droid, otwórz ustawienia, ustaw domyślny serwer na https://ntfy.example.com, dodaj swoje konto w ekranie zarządzania użytkownikami, a następnie zasubskrybuj alerts. Funkcja natychmiastowego dostarczania utrzymuje działającą usługę na pierwszym planie, dzięki czemu wiadomości docierają nawet wtedy, gdy telefon znajduje się w trybie uśpienia (doze mode), a towarzyszące temu stałe powiadomienie jest wymogiem systemu Android dla usług działających na pierwszym planie, a nie błędem. Wersja z F-Droid nie zawiera żadnego kodu Firebase, więc każda subskrypcja korzysta z natychmiastowego dostarczania. ntfy może również pełnić rolę dystrybutora UnifiedPush, czyli otwartego zamiennika usługi powiadomień Google, dzięki czemu inne aplikacje wspierające UnifiedPush mogą również dostarczać powiadomienia przez Twój serwer.

W oficjalnej aplikacji na iOS rozwiązanie to działa z jedną zależnością, której nie można usunąć. System iOS zawiesza aplikacje działające w tle, a tryby pracy w tle dozwolone przez Apple (odtwarzanie dźwięku, odbieranie aktualizacji lokalizacji, przetwarzanie zaplanowanych zadań) nie pozwalają aplikacji na oczekiwanie na wiadomość z Twojego serwera. Dlatego szybkie wybudzenie musi nastąpić za pośrednictwem APNs (Apple push notification service). Tylko dostawca z poświadczeniami autoryzowanymi dla danej aplikacji może wysyłać do niej powiadomienia, więc Twój serwer nie ma możliwości bezpośredniego połączenia z oficjalną aplikacją. ntfy rozwiązuje ten problem za pomocą przekaźnika (relay): Twój serwer wysyła poll_request zawierający identyfikator wiadomości do ntfy.sh, który przekazuje go przez Firebase i APNs w celu wybudzenia aplikacji, a następnie aplikacja pobiera treść wiadomości z Twojego serwera.

upstream-base-url: "https://ntfy.sh"

Należy mieć świadomość kosztów tego rozwiązania. Treść wiadomości pozostaje na Twoim serwerze, ale fakt nadejścia wiadomości oraz jej identyfikator przechodzą przez infrastrukturę, której nie zarządzasz. Bez tego ustawienia powiadomienia na iPhone z samodzielnie hostowanego serwera nadal docierają, ale dokumentacja ntfy ostrzega, że opóźnienie może wynosić nawet kilka godzin, ponieważ nic nie wybudza aplikacji w trybie natychmiastowym. Aby korzystać z natywnej aplikacji na iOS bez przekaźnika ntfy.sh, należy samodzielnie zbudować i udostępnić aplikację, korzystając z własnego konta Apple Developer oraz własnych kluczy APNs, co wiąże się z roczną opłatą oraz koniecznością przebudowy aplikacji przy każdej aktualizacji. Inną drogą jest użycie PWA ntfy w systemie iOS 16.4 lub nowszym: dodaj aplikację do ekranu głównego i skonfiguruj Web Push na swoim serwerze. Pozwala to uniknąć przekaźnika ntfy.sh, ale nadal korzysta z infrastruktury powiadomień przeglądarki. Jeśli korzystanie z przekaźnika jest nieakceptowalne, należy ograniczyć powiadomienia do systemu Android lub desktopowej aplikacji webowej.

Kopie zapasowe, aktualizacje i przypinanie obrazu

Dwie ścieżki nie mogą zostać wygenerowane ponownie: /etc/ntfy/server.yml oraz /var/lib/ntfy/user.db. Druga przechowuje każdego użytkownika, skrót hasła, wpis ACL i token, więc traktuj ją jak klucz prywatny.

sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgz

Skopiuj ten plik z serwera. cache.db przechowuje ostatnie wiadomości, przez 12 godzin przy użyciu cache-duration powyżej, plus każdą wiadomość zaplanowaną do późniejszego dostarczenia, która pozostaje do 12 godzin po dostarczeniu. O ile nie planujesz wiadomości z wyprzedzeniem, utrata tego pliku nie wiąże się z żadną stratą wartą ochrony. Aktualizacja oznacza edycję tagu w pliku compose, pobranie obrazu i odtworzenie kontenera.

sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/health

Najpierw przeczytaj informacje o wydaniu. Bazy danych SQLite migrują przy starcie, więc wycofanie do starszego tagu po zmianie schematu nie jest bezpieczne. Wersja v2.31.1 na przykład przeniosła pamięć podręczną wiadomości do wersji schematu 17, a jej notatki aktualizacji mówią, że przejście na v2.31.0 lub starszą wymaga ręcznego ustawienia tej wersji z powrotem na 16. Aktualizacja do v2.36.0 jednorazowo resetuje istniejące dzienne limity wszystkich użytkowników. Zachowaj wykonaną przed chwilą kopię zapasową, dopóki nowa wersja nie będzie działać przez dobę. Notatki wskazują również na zmiany w zachowaniu. Od wersji v2.31.0 klient, który łączy się ponownie z since=<message ID>, otrzymuje również wiadomości opublikowane w tej samej sekundzie, więc może zobaczyć duplikat. Aplikacje ntfy oraz aplikacja webowa odrzucają duplikaty według identyfikatora wiadomości, ale własny skrypt odtwarzający temat musi robić to samo. Każda usługa na serwerze ma własną krótką listę ścieżek, których nie można wygenerować ponownie, a porównanie PhotoPrism i Immich opracowuje tę listę oraz polecenia kopii zapasowych, które się z nią wiążą, dla biblioteki zdjęć na tego samego typu VPS.

Gotify oraz Apprise

Gotify stanowi bardziej kompaktowe rozwiązanie: pojedynczy plik binarny z interfejsem WWW oraz aplikacją na system Android. Wiadomości są grupowane według aplikacji, co sprawdza się w przypadku prywatnych serwerów, gdzie jedynym odbiorcą jest urządzenie z systemem Android. Apprise to biblioteka języka Python oraz narzędzie wiersza poleceń, dostępne również jako osobny serwer API. Narzędzie to pozwala na rozsyłanie pojedynczej wiadomości do ponad stu usług, w tym ntfy, co jest przydatne w skryptach wymagających powiadomienia wielu odbiorców jednocześnie. ntfy oferuje własny serwer, API HTTP oraz aplikacje na obie platformy mobilne, dlatego jest to najczęściej wybierane rozwiązanie do obsługi alertów z serwerów wynajmowanych.

FAQ

Dlaczego publikowanie na moim serwerze ntfy zwraca błąd 403?

Przy ustawieniu auth-default-access: "deny-all" w pliku server.yml, anonimowe publikowanie jest odrzucane i jest to zamierzone zachowanie. Należy wysłać poświadczenia za pomocą -u user:pass lub -H "Authorization: Bearer tk_...". Jeśli wysyłasz już token, a nadal otrzymujesz 403, sprawdź, czy użytkownik posiada wpis ACL zezwalający na zapis w danym temacie: brak pasującego wpisu, read-only lub deny powoduje odrzucenie publikacji. W wersji v2.34.0 równoległe żądania z tego samego adresu IP mogły powodować, że poprawne poświadczenia były traktowane jako anonimowe; wersja v2.35.0 naprawia ten błąd, więc zaktualizuj oprogramowanie przed uznaniem sporadycznego 403 za dowód problemu z ACL. Uruchom ntfy access, aby wyświetlić pełną listę. Pamiętaj, że uprawnienie write nie pozwala na subskrypcję, więc konto, które poprawnie publikuje, nadal otrzyma odmowę przy próbie odczytu tego samego tematu.

Czy powiadomienia działają na iPhone z własnym serwerem ntfy?

Działają one poprzez przekaźnik (relay), gdy używasz oficjalnej aplikacji na iOS. Szybkie wybudzenie aplikacji na iPhone wymaga użycia APNs (Apple push notification service), a wysyłanie do oficjalnej aplikacji wymaga poświadczeń jej wydawcy, dlatego ntfy przesyła poll_request zawierające identyfikator wiadomości do ntfy.sh, który przekazuje je dalej na urządzenie. Ustaw upstream-base-url: "https://ntfy.sh" w server.yml i zrestartuj kontener. Treść wiadomości jest nadal pobierana bezpośrednio z Twojego serwera. Bez tego ustawienia powiadomienia na iOS nadal docierają, ale dokumentacja ntfy ostrzega, że opóźnienie może wynosić nawet kilka godzin. PWA oferuje inną drogę na systemie iOS 16.4 lub nowszym, gdy Web Push jest skonfigurowany na Twoim serwerze.

Dlaczego alert ntfy z mojego zadania cron nie dotarł?

Uruchom najpierw linię curl samodzielnie, aby potwierdzić, że token i temat są poprawne. Jeśli działa ręcznie, a nie działa z crona, przyczyna leży przed wysłaniem alertu: cron uruchamia zadania w minimalnym środowisku z krótkim PATH, więc skrypt wywołujący polecenie po samej nazwie może zakończyć działanie przed dotarciem do linii curl. Używaj ścieżek bezwzględnych, przekieruj wyjście zadania do pliku dziennika i odczytaj ten plik po kolejnym uruchomieniu. Odpowiedź 429 zamiast dostarczenia oznacza, że limit odrzucił żądanie. Zazwyczaj skrypt ponawia próby zbyt szybko, ale użytkownik, który wyczerpał dzienny limit, taki jak ustawiony powyżej limit wiadomości, otrzymuje odmowę nawet przy pojedynczym żądaniu.

Czy powinienem wystawiać ntfy na publiczny Internet?

Aplikacje mobilne muszą mieć dostęp do serwera z sieci komórkowych, więc publiczny punkt końcowy HTTPS z auth-default-access: "deny-all" i ACL dla poszczególnych tematów jest standardową konfiguracją. Jest to bezpieczne, o ile żaden temat nie jest dostępny do odczytu dla everyone. Instancja dostępna tylko przez VPN jest rozsądna, gdy każdy subskrybent jest maszyną pod Twoją kontrolą. Jest to słabe rozwiązanie dla telefonów, ponieważ aplikacja odbiera dane tylko wtedy, gdy tunel jest aktywny, więc alerty są kolejkowane do momentu ponownego połączenia telefonu.

Czy ten artykuł był przydatny?