Worum es geht
Am Ende jeder Überwachungs-Pipeline steht die Benachrichtigung: Der Collector hat Feeds geholt, die Klassifikation hat gefiltert, und jetzt soll dein Telefon vibrieren. Viele greifen dafür zu einem Telegram-Bot. Das funktioniert, verlangt aber einen Bot-Token, eine Chat-ID und eine Bibliothek oder eigenen Code für die API.
ntfy.sh geht einen anderen Weg. Ein Topic ist nur ein Name. Wer einen HTTP-POST an dieses Topic schickt, löst eine Push-Meldung auf allen Geräten aus, die es abonniert haben. Es gibt keinen Bot, keine Registrierung und keinen Chat.
Wie ntfy funktioniert
Du wählst einen Topic-Namen, abonnierst ihn in der ntfy-App und schickst Nachrichten per HTTP an die Adresse des Servers, gefolgt vom Topic. Der Body des Requests ist der Nachrichtentext. Titel, Priorität und Tags gehen als Header mit.
curl -H "Title: Heartbeat" \
-H "Priority: default" \
-H "Tags: white_check_mark" \
-d "Pipeline läuft, 3 neue Meldungen" \
ntfy.example.org/mein-topic
Der Hostname im Beispiel ist ein Platzhalter. Du kannst den öffentlichen Dienst nutzen oder einen eigenen Server betreiben.
Einbindung in Python
In der Pipeline reicht ein einzelner Funktionsaufruf. Wichtig sind ein Timeout und ein Fehlerpfad, damit ein Ausfall des Push-Dienstes die Verarbeitung nicht blockiert.
import logging
import requests
log = logging.getLogger("notify")
def push(base_url: str, topic: str, text: str,
title: str = "", priority: int = 3, tags: str = "") -> bool:
headers = {"Priority": str(priority)}
if title:
headers["Title"] = title
if tags:
headers["Tags"] = tags
try:
r = requests.post(f"{base_url}/{topic}", data=text.encode("utf-8"),
headers=headers, timeout=10)
r.raise_for_status()
return True
except requests.RequestException as exc:
log.warning("ntfy nicht erreichbar: %s", exc)
return False
Die Rückgabe False erlaubt es dem Aufrufer, die Meldung später erneut zu versuchen oder auf einen zweiten Kanal wie E-Mail auszuweichen.
Prioritäten und Tags nutzen
ntfy kennt fünf Prioritätsstufen. Sinnvoll ist eine feste Zuordnung: Routine-Meldungen bekommen die Standardstufe, echte Alarme die höchste, und der tägliche Heartbeat die niedrigste, damit er nicht klingelt. Tags werden als Emojis dargestellt und helfen, Meldungen auf einen Blick zu unterscheiden.
Ein Topic pro Zweck hält die Abos übersichtlich: eines für Alarme, eines für den Heartbeat, eines für Informationen. So lässt sich auf dem Telefon jedes Topic getrennt stummschalten.
Zugriffsschutz
Ein Topic ist kein Geheimnis, sondern nur ein Name. Auf einem öffentlichen Server kann jeder mitlesen und schreiben, der ihn errät. Für harmlose Meldungen ist das akzeptabel, für alles andere nicht. Drei Maßnahmen helfen:
- Einen langen, zufälligen Topic-Namen verwenden und ihn wie ein Passwort behandeln.
- Keine sensiblen Inhalte in den Text schreiben, sondern nur eine Kurzinfo und einen Hinweis, wo die Details liegen.
- Einen eigenen Server mit Zugriffsregeln und Anmeldung betreiben, wenn mehr Schutz nötig ist.
Der Topic-Name gehört wie jedes Secret in eine Umgebungsdatei und nicht in den Code.
Grenzen im Vergleich zu Telegram
ntfy ist eine Einbahnstraße: Es sendet Meldungen, aber du kannst nicht direkt im Chat antworten oder Befehle an die Pipeline schicken. Wer Rückfragen, Buttons oder Bestätigungen braucht, ist mit einem Bot besser bedient. Dafür entfallen Token-Verwaltung, Rate-Limits der Bot-API und die Abhängigkeit von einem einzelnen Anbieter.
Auch die Zustellung unterscheidet sich. Bei einem selbst betriebenen Server hängt sie davon ab, wie das Telefon Push-Dienste zulässt. Prüfe deshalb einmal bewusst, ob Meldungen auch bei aktivem Energiesparmodus ankommen.
Wann sich das lohnt (und wann nicht)
ntfy lohnt sich, wenn deine Pipeline nur senden soll: Alarme, Statusmeldungen, Heartbeats. Der Aufwand ist minimal, der Code kurz, und es gibt keinen Bot, der ablaufen oder gesperrt werden kann.
Bleib bei Telegram, wenn du interaktiv arbeiten willst, etwa Meldungen per Knopfdruck quittieren oder Befehle senden. Ein sinnvoller Mittelweg ist ein Dispatcher mit mehreren Backends: ntfy als Standard, Telegram oder E-Mail als Ausweichkanal.