01 · TELEMETRIE · TELEGRAM
Self-hosted · MIT-Lizenz · v1.0 · ★ GitHub

Jeder Server
im Blick.

HawkDNS sitzt auf deinem Server, behält alles im Auge, was sich rührt — Docker, PHP-FPM, deine Domains — und pingt dein Telegram in dem Moment, in dem etwas zuckt. Install-Befehl ist kurz. RAM-Verbrauch noch kürzer.

root@deinserver ~
$ curl -fsSL https://bot.hawkdns.info/install.sh | sudo bash
~60 Sekunden · keine Abhängigkeiten linux · debian · rhel · alpine Quellcode auf GitHub
N
S
O
W
HawkDNS
VERFOLGUNG UPLINK 1.4ms 14 NODES
Überwachte Server
14
alles grün
Domain-Checks · 24h
20.736
⌀ Latenz 184ms
Falsche Alarme
0
Retries · Backoff · clever
Zeit bis zum Alarm
< 60s
Median, echte Ausfälle
02 · WAS DER VOGEL TUT

Spezialisiert auf Server, die zählen.

F·01

Multi-Server-Föderation

Eine Installation auf einem Server. Oder eine Installation auf jedem Server. Oder ein Hub, der sich per SSH mit den anderen verbindet. Gleicher Bot, gleicher Telegram-Chat, einheitlicher Status mit /all.

F·02

Intelligente Ausfall-Alarme

Kennt den Unterschied zwischen einem 3-Sekunden-Aussetzer und einem Dienst, der wirklich gestorben ist. Wiederholt mit Backoff, sendet einen Alarm bei Ausfall, einen bei Wiederherstellung. Kein Flap-Spam um 3 Uhr morgens.

F·03

Boot-Erkennung

Server um 04:17 neu gestartet, ohne dir Bescheid zu geben? Telegram-Nachricht innerhalb von 30 Sekunden: Hostname, Kernel, Uptime. Du weißt es vor deinen Kunden.

F·04

Unabhängiger Watchdog

Ein zweiter Checker läuft per Cron und pollt deine Domains. Wenn der Haupt-Bot abstürzt, spricht der Watchdog trotzdem mit Telegram. Gürtel und Hosenträger. Vögel und Backup-Vögel.

03 · PRE-FLIGHT CHECK

Drei Zeilen, drei Minuten,
kein Babysitter.

01

Mit BotFather sprechen, Token holen.

Telegram öffnen, @BotFather anschreiben, /newbot tippen. Vogel benennen. Token speichern. (Profi-Tipp: @userinfobot nach deiner Chat-ID fragen.)

2:00 min ca.
02

Install-Skript auf dem Server curlen.

Einfügen, Enter drücken, zwei Fragen beantworten. Der Installer erkennt dein OS, installiert Python falls nötig, schreibt die systemd-Unit, plant den Cron-Job, ping-testet den Bot und sendet eine Bestätigung an deinen Chat.

curl -fsSL https://bot.hawkdns.info/install.sh | sudo bash
0:45 sek real
03

Tippe /start in Telegram.

Das Dashboard erscheint als Inline-Tastatur. Server auswählen, Last, RAM, Festplatte, Container-Status und die letzten 20 Log-Zeilen sehen. Oder einfach zurücklehnen — Alarme kommen zu dir, wenn etwas Aufmerksamkeit braucht.

0:05 sek touch
04 · FORMATIONSFLUG

Einen beobachten —
oder den ganzen Schwarm.

Auf einem einzelnen Server installieren und fertig. Du willst eine Flotte? Bestimme einen als Hub, installiere auf jedem Peer mit einem Flag — und der Hub aggregiert alles. Das Telegram-Dashboard zeigt alle auf einen Blick.

# auf dem Primary, beobachtet sich selbst
$ curl -fsSL bot.hawkdns.info/install.sh | sudo bash

# auf dem Hub, beobachtet drei Peers
$ curl -fsSL bot.hawkdns.info/install.sh | sudo bash -s -- \
   --peers="web1:10.0.0.10,db1:10.0.0.11,cache:10.0.0.12"
HUB primary web-1 db-1 cache worker TELEGRAM SSH UPLINK
05 · BETRIEBSANLEITUNG

Spricht mit dir,
direkt im Terminal.

install.sh
# Einzeiler — interaktiv, fragt nach Token + Chat-ID
$ curl -fsSL https://bot.hawkdns.info/install.sh | sudo bash

# Headless, alle Flags von Anfang an
$ curl -fsSL https://bot.hawkdns.info/install.sh | sudo bash -s -- \
    --token="123456:ABC-DEF…" \
    --chat="987654321" \
    --name="web-prod-1" \
    --yes

# Peers hinzufügen (Multi-Server-Hub-Modus)
$ curl -fsSL https://bot.hawkdns.info/install.sh | sudo bash -s -- \
    --peers="db:10.0.0.10,cache:10.0.0.11"
/etc/hawkdns/config.json
// vom Installer generiert, jederzeit editierbar — danach Service neu starten
{
  "bot_token": "123456:ABC-DEF…",
  "chat_whitelist": ["987654321"],
  "server_name": "web-prod-1",
  "peers": [
    { "name": "db",    "host": "10.0.0.10", "port": 22 },
    { "name": "cache", "host": "10.0.0.11", "port": 22 }
  ]
}
/etc/hawkdns/watchdog.conf
# Domain | akzeptierte Codes  — Cron pollt alle 2 Min.
example.com|200
api.example.com|200,401
shop.example.com|200,301,302
internal.tools.example.com|200

# Alarm nach 3 Fehlern (~6 Min.), eine Recovery-Nachricht bei Rückkehr
telegram_alert.txt
🚨 DOWN: shop.example.com → HTTP 502 (seit 6 min)
   [web-prod-1]

--- 8 Minuten später ---

✅ RECOVERED: shop.example.com → HTTP 200 (war ~14 min down)
   [web-prod-1]

--- bei Neustart ---

🔄 Server-Neustart erkannt
   server: web-prod-1
   host: web-prod-1.internal
   kernel: 6.8.0-49-generic
   HawkDNS ist online und beobachtet.
· INSTALLIEREN

Eine Zeile.
Ein Chat.

Keine Accounts. Keine Dashboards. Kein Abo. Der Bot lebt auf deiner Maschine, spricht deine Sprache und hört auf zu reden, wenn du es möchtest.

root@deinserver ~
$ curl -fsSL https://bot.hawkdns.info/install.sh | sudo bash
Open Source · MIT-Lizenz keine Telemetrie verlässt deinen Server
· OPEN SOURCE

Der Code lebt auf
GitHub.

MIT-lizenziert — forke ihn, leg los, schick einen PR. Der ganze Bot ist unter 600 Zeilen reines stdlib-Python, der Installer fügt nochmal 200 dazu. Lies jede Zeile bevor du sie auf deine Server lässt — das ist der Punkt.

⚖️ MIT 🐍 Python 📏 <800 LOC 📦 nur stdlib
Klonen & inspizieren: git clone https://github.com/webhoch-com/hawkdns-bot.git