CaddyShack — Hüpattl! Software

CaddyShack liest die JSONL-Zugriffsprotokolle eines Caddy-Servers und zeigt sie als Dashboard im Browser. Betreibe es neben Caddy auf deinem Server oder lokal auf deinem Rechner und zieh eine Logdatei hinein. Es braucht keine Datenbank und keine Konfiguration, stellt keine Anfragen an andere und trackt niemanden. Die Logs bleiben auf dem Rechner, auf dem es läuft.

Funktionen

Was das Dashboard zeigt und wie du es eingrenzt.

Hochladen oder hineinziehen

Caddy-JSONL-Zugriffslog mit „Upload log file“ auswählen oder irgendwo auf die Seite ziehen. Neben Caddy erscheinen die Logs des Servers von selbst.

Filter

Alles eingrenzen nach Site, Datum, Status, Land, Browser, System, URI, Methode oder einer Suche über URI, IP und Referrer. Ein Satz sagt, was du gerade siehst.

Besucher*innen statt Rauschen

Uptime-Monitore, Bots, statische Dateien und Bilder sind standardmäßig ausgeblendet; ein Klick zeigt sie wieder. Skripte und Scanner bleiben sichtbar, damit du die Angriffsversuche siehst.

Einzelereignisse

Eine zweite Ansicht listet die einzelnen Anfragen hinter den Diagrammen, nachgeladen beim Scrollen.

Traffic im Zeitverlauf

Anfragen pro Tag, sodass Muster und Spitzen sichtbar werden.

Weltkarte

Anfragen pro Land, mit der optionalen kostenlosen DB-IP-Lite-Datenbank.

Browser und Systeme

Sortierte Balken, in denen jeder Browser und jedes System seine eigene Farbe behält; Bots und Skripte bleiben grau.

Externe Referrer

Woher Besucher*innen kommen — ohne die Klicks zwischen deinen eigenen Sites.

Statuscodes

Erfolgreiche Anfragen, Weiterleitungen und Fehler auf einen Blick.

Datenschutz

IP-Adressen werden gekürzt, bevor sie den Browser erreichen. Hochgeladene Logs werden nach einer Stunde ohne Nutzung gelöscht.

Screenshots

Das Dashboard und die Liste der Einzelereignisse.

CaddyShack-Statistikansicht mit Filtern, Kennzahlen, Weltkarte, Ländertabelle, Balken für Browser und Systeme, Traffic pro Tag und Statuscodes — **Statistik**Filter, Kennzahlen, Karte, Browser, Traffic im Zeitverlauf

CaddyShack-Ansicht der Einzelereignisse mit Zeit, URI, Status, Größe, IP, Land und Browser je Anfrage — **Einzelereignisse**Einzelne Anfragen, nachgeladen beim Scrollen

Installation

Binärdatei auf dem Server oder lokal starten und im Browser öffnen:

./caddyshack

Verfügbar für Linux, macOS ab Version 13 (Intel und Apple Silicon) und Windows.

Oder als Container ausführen:

docker run -p 8080:8080 ghcr.io/bjblazko/caddyshack:latest

Oder mit Docker Compose / Podman Compose:

docker compose up -d

Images für linux/amd64 und linux/arm64, veröffentlicht auf GHCR. Optionen wie -logdir, -geodb und -upload-ttl beschreibt die README.

Neueste Version herunterladen Auf GitHub ansehen

Ohne Gewährleistung, soweit gesetzlich zulässig. Die Projekte, auf denen CaddyShack aufbaut, stehen in der App unter About → Licenses and thanks.