n8n-nodes-ntfy-client | Tomasz Wyderka

O projekcie

n8n-nodes-ntfy-client to community node dla platformy n8n, który integruje ntfy — prosty serwis powiadomień pub-sub oparty na HTTP. Obsługuje wysyłanie powiadomień i nasłuchiwanie tematów w obu kierunkach, z autoryzacją zgodną z konwencjami n8n.

Działa zarówno z publicznym serwerem ntfy.sh, jak i z własną instalacją self-hosted.

Węzły

Ntfy Send

Wysyła powiadomienie na wybrany temat ntfy. Wykonuje się raz na każde uruchomienie workflow.

Parametr	Wymagany	Opis
Topic	Tak	Nazwa tematu (np. `moje-alerty`)
Message	Tak	Treść powiadomienia
Title	Nie	Tytuł powiadomienia
Priority	Nie	`Min (1)` / `Low (2)` / `Default (3)` / `High (4)` / `Urgent (5)`
Tags	Nie	Tagi lub emoji oddzielone przecinkami (np. `warning,📦`)

Ntfy Trigger

Subskrybuje jeden lub więcej tematów ntfy przez trwały strumień JSON. Wyzwala workflow dla każdej przychodzącej wiadomości.

Parametr	Wymagany	Opis
Topics	Tak	Nazwa tematu lub kilka oddzielonych przecinkami: `alerty,backup,system`
Since	Nie	`Tylko nowe` (domyślnie) / `Ostatnie 10 minut` / `Ostatnia godzina` / `Wszystkie z cache`

Format wyjściowy — pełny obiekt wiadomości ntfy:

{
  "id": "abc123",
  "time": 1716000000,
  "topic": "alerty",
  "event": "message",
  "message": "Serwer nie odpowiada",
  "title": "Alert",
  "priority": 5,
  "tags": ["warning"]
}

W przypadku utraty połączenia trigger automatycznie wznawia subskrypcję z wykładniczym backoff (do 5 prób). Błędy autoryzacji (401/403) są natychmiastowo zwracane bez ponownych prób.

Autoryzacja (Ntfy API)

Po instalacji utwórz nowe poświadczenie typu Ntfy API:

Pole	Opis
Server URL	`https://ntfy.sh` dla serwera publicznego lub adres własnej instalacji
Authentication Type	`None` / `Basic Auth` / `Access Token`
Username / Password	Widoczne przy wyborze `Basic Auth`
Access Token	Widoczne przy wyborze `Access Token`

Poświadczenie jest testowane automatycznie przez GET /v1/health przy zapisywaniu.

Instalacja

W instancji n8n przejdź do Settings → Community Nodes → Install i wpisz:

n8n-nodes-ntfy-client

Wymagania

n8n >=1.0.0
Serwer ntfy (self-hosted lub publiczny ntfy.sh)

Licencja

Projekt udostępniony na licencji MIT.