admin 0.0.0.0:2019 erlaubt jedem, der Port 2019 erreicht, deine gesamte Caddy-Konfiguration ohne Passwort zu ersetzen. Ein file_server ohne root liefert den Ordner aus, in dem Caddy läuft, einschließlich .git und .env. Dieser Skill findet diese und zehn weitere Fehler in der Caddy-Konfiguration, bevor du sie neu lädst oder bereitstellst, und zeigt dir, wie du sie behebst.

Dein Agent führt einen Scanner für dein Projekt aus: Dateien namens Caddyfile (auch Caddyfile.prod und ähnliche), .caddyfile und .caddy sowie Caddy-JSON-Konfigurationen. Er liest die Caddyfile-Syntax wie Caddy: den globalen Optionsblock, Snippets und import (auch für andere Dateien im Ordner, sodass import sites/*.caddy verfolgt wird), mehrere Adressen pro Website, eine einzelne Website ohne geschweifte Klammern, Matcher, Kommentare, Zeichenfolgen in Anführungszeichen, Heredocs und {env.*}-Platzhalter. Er berücksichtigt die tatsächlichen Caddy-Standardeinstellungen: die Admin-API auf localhost:2019, keine Sicherheitsheader und kein HSTS, sofern du sie nicht ergänzt hast, sowie die vor file_server verborgene aktive Caddyfile, während andere Dateien mit führendem Punkt sichtbar bleiben. Die minimalen Caddyfiles aus der Caddy-Dokumentation und die Standard-Caddyfile des Docker-Images bestehen die Prüfung ohne Befund. Er führt niemals Caddy aus und ruft dessen Admin-API nicht auf. Er liefert BLOCK, REVIEW oder NOT FLAGGED mit Datei, Zeile, Begründung und sichererem Vorgehen. Geheimnisse werden niemals ausgegeben.

Was geprüft wird

BLOCK (vor der Auslieferung beheben)

• C01: die Admin-API auf :2019, 0.0.0.0, einer LAN-IP oder einem Hostnamen statt auf localhost oder einem Unix-Socket

• C02: tls_insecure_skip_verify für ein reverse_proxy-Backend und insecure_secrets_log

• C03: file_server für /, /etc, /var, einen Home-Ordner, einen .ssh-Ordner oder Caddys eigenen Zertifikatsspeicher

• C04: in der Konfiguration hinterlegte DNS-Provider-Tokens, API-Schlüssel, Passwörter, EAB-Schlüssel und Authorization-Header

REVIEW (vor der Veröffentlichung prüfen)

• C11: tls internal, local_certs oder eine ACME-Staging-CA für eine öffentliche Domain

• C12: öffentliche Websites mit http:// oder :80, die Inhalte ausliefern, und auto_https off

• C13: file_server ohne root oder mit root ., während .git und .env nicht verborgen werden

• C14: CORS, das jeden Origin in Access-Control-Allow-Origin kopiert und dabei Zugangsdaten zulässt

• C15: eine öffentliche Website ohne die Sicherheitsheader, die andere Websites in der Konfiguration senden

• C16: trusted_proxies mit dem Wert 0.0.0.0/0 oder ::/0

• C17: log_credentials, das Cookies und Authorization-Header in das Zugriffsprotokoll schreibt

• C18: protocols tls1.0 oder tls1.1, die Caddy v2 nicht unterstützt und daher nicht lädt

Im Lieferumfang enthalten

• Der Scanner (Python 3.9+, nur Standardbibliothek)

• Ein Regelhandbuch mit Begründung und sichererem Vorgehen für jede Regel

• Ein unsicheres und ein sicheres Beispielprojekt (eine Caddyfile mit importierten Website-Dateien und eine Caddy-JSON-Konfiguration) sowie der tatsächliche Scanner-Bericht für das unsichere Beispiel

Grenzen

Der Scanner liest die Konfigurationsdateien so, wie sie vorliegen. Werte aus Umgebungsvariablen (CADDY_ADMIN, {env.*}), Befehlszeilenoptionen, über die Admin-API übertragene Konfigurationen, caddy-docker-proxy-Labels und Importe von Dateien außerhalb des gescannten Ordners werden nicht geprüft. Header, die die Anwendung hinter reverse_proxy sendet, sind für ihn nicht sichtbar. NOT FLAGGED ist keine Garantie.

Inhalt des Archivs

Ein ZIP-Archiv mit 15 Dateien: SKILL.md, der Scanner in scripts/ (4 Python-Dateien), references/rules.md (alle Regeln mit Begründung und sichererem Vorgehen) und examples/ (8 Beispieldateien sowie report.md, die tatsächliche Scanner-Ausgabe für das unsichere Beispiel).

Verwendung: Dies ist ein Agent-Skill: ein Ordner mit einer SKILL.md-Datei und Python-Skripten, die ein KI-Programmieragent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacke das Archiv in den Skills-Ordner deines Agenten (für Claude Code: ~/.claude/skills/) und bitte deinen Agenten anschließend, dein Projekt zu prüfen. Die Skripte lassen sich auch eigenständig mit Python 3.9 oder neuer ausführen, ohne zusätzliche Installation. Sie lesen ausschließlich deine Dateien: kein Netzwerkzugriff, und es werden keine Daten versendet.