Security-Header in Caddy
Eine strikte Content Security Policy, HSTS und no-referrer in einem Caddy-Siteblock, geprüft mit Webbkoll, securityheaders.com und dem Mozilla Observatory.
Geprüft von adrian
am
Nachdem die Seite lief, habe ich sie durch drei Scanner geschickt. Null Cookies, null Anfragen an Dritte, HTTPS als Standard. Aber keine Content Security Policy, kein HSTS und keine Referrer-Policy. Diese Anleitung geht durch, was die Scans fanden, was ich geändert habe und was herauskam.
Die Scanner
- Webbkoll von der schwedischen Bürgerrechtsorganisation Dataskydd.net. Zu jedem Punkt nennt es den Artikel der DSGVO dahinter: Art. 5.1.c (Datenminimierung) für die Referrer-Policy und Anfragen an Dritte, Art. 25 (Privacy by Design und by Default) für keine Cookies und keine Drittanbieter-Aufrufe, Art. 32 (Sicherheit der Verarbeitung) für HSTS, CSP und die übrigen Header. Damit ist es mein Scanner, wenn ich belegen will, dass die Seite DSGVO-konform gebaut ist.
- securityheaders.com für eine schnelle Note von A+ bis F.
- Mozilla HTTP Observatory für die gründlichste Prüfung der CSP.
Warum eine statische Seite das braucht
Eine Seite ohne Login, Formulare oder Eingaben wirkt wie ein langweiliges Ziel. Drei Header zählen trotzdem:
- Content Security Policy ist die Versicherung für den Tag, an dem fremdes HTML auf der Seite landet: eine kompromittierte Abhängigkeit, eine Fehlkonfiguration, ein Tippfehler im Template. Mit einer strengen CSP führt der Browser eingeschleustes JavaScript nicht aus.
- HSTS schützt vor Downgrade-Angriffen, etwa wenn jemand im offenen WLAN die Domain ohne
https://eintippt. - Referrer-Policy verhindert, dass bei jedem Klick auf einen externen Link die URL mitgeht, auf der deine Leser gerade waren.
Das Setup
- VPS bei Hetzner, Debian.
- Caddy als Reverse-Proxy (so eingerichtet) vor einem Container, in dem nginx den statischen Astro-Build auf
127.0.0.1:4321ausliefert.
Der Header-Block
Caddy schickt von sich aus nur das Nötigste. Alles kommt in einen header-Block der Site:
adrian-altner.de, www.adrian-altner.de {
encode zstd gzip
@www host www.adrian-altner.de
redir @www https://adrian-altner.de{uri} permanent
header /fonts/* Cache-Control "public, max-age=31536000, immutable"
header /_astro/* Cache-Control "public, max-age=31536000, immutable"
header /images/* Cache-Control "public, max-age=604800"
header {
Content-Security-Policy "default-src 'none'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; script-src 'self'; font-src 'self'; connect-src 'self'; frame-ancestors 'none'; base-uri 'self'; form-action 'self'; object-src 'none'"
Referrer-Policy "no-referrer"
Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
X-Content-Type-Options "nosniff"
X-Frame-Options "DENY"
X-XSS-Protection "0"
Permissions-Policy "geolocation=(), microphone=(), camera=(), interest-cohort=()"
Cross-Origin-Opener-Policy "same-origin"
-Server
}
reverse_proxy 127.0.0.1:4321
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I auf die Seite zeigt danach den vollen Satz. Die weniger offensichtlichen Zeilen:
default-src 'none'ist strenger als'self': Jede Direktive muss bewusst erlaubt werden, nichts fällt auf einen lockeren Standard zurück.X-XSS-Protection: 0folgt der aktuellen OWASP-Empfehlung. Der alte XSS-Auditor älterer Browser hat mehr Lücken geöffnet als geschlossen,0schaltet ihn ab.X-Frame-Options: DENYwiederholtframe-ancestors 'none'für ältere Browser ohne CSP Level 2.-Serverentfernt denServer-Header, ein kleiner Hinweis für Fingerprinting weniger.interest-cohort=()lehnt Googles FLoC ab, auch wenn das Feature praktisch tot ist.
Inline-Skripte unter der CSP
Der nächste Scan zeigte einen neuen Fehler: Die Kontaktseite zeigte die E-Mail-Adresse nicht mehr. Die Adresse steht als Base64 im HTML und wird im Browser decodiert, und das Skript dafür stand inline in der .astro-Datei. Astro machte daraus ein Inline-<script type="module">, und script-src 'self' blockte es, wie es soll. Drei Möglichkeiten:
'unsafe-inline': macht die CSP fast wertlos.- Ein SHA-256-Hash des Skripts in der CSP: muss nach jedem Build geprüft werden, fragil.
- Das Skript in eine eigene Datei auslagern und importieren: Astro bündelt Modul-Importe als externe Dateien, die
script-src 'self'erlaubt.
Ich habe die dritte genommen. Das Skript liegt jetzt in src/scripts/decode-obf.ts, die Seite importiert es nur:
<script>
import '~/scripts/decode-obf';
</script>
Nach dem Build ist es eine gehashte Datei _astro/….js, per src geladen und mit dem langen Cache-Control-Header gecacht.
style-src 'unsafe-inline' bleibt. Astro schreibt Scoped-<style>-Tags, die @font-face-Regeln und die Keyframes der View Transitions inline. Ohne eine Nonce pro Anfrage gibt es auf einer statischen Seite keinen sauberen Weg drumherum. Eingeschleuste Styles können keinen Code ausführen, also nehme ich das hin.
Referrer-Policy: no-referrer
Meine erste Version nutzte strict-origin-when-cross-origin, das nur den Origin schickt. Webbkoll markierte das trotzdem gelb, weil der Origin bei HTTPS-zu-HTTPS-Anfragen mitgeht. Die Seite hat keine Analyse und niemand braucht den Referrer, also habe ich umgestellt:
Referrer-Policy "no-referrer"
Browser schicken bei ausgehenden Links jetzt gar keinen Referer mehr. Kartendienste, die den Referer prüfen, brauchen dann eine Ausnahme am Element, siehe Leaflet und Stadia Maps hinter einer strikten CSP.
Das Ergebnis
Webbkoll: HTTPS als Standard, „Gute Richtlinie“ für die CSP, „Referrer werden nicht übermittelt“, 0 Cookies, 0 Anfragen an Dritte. securityheaders.com: A+. Der einzige rote CSP-Punkt ist style-src 'unsafe-inline'.
Was offen blieb
Externe Avatarbilder aus Webmentions wurden von img-src 'self' data: geblockt. Gelöst habe ich das, indem ich die Avatare beim Build lokal zwischenspeichere.
Zum Mitnehmen
- Security-Header in Caddy sind ein paar Zeilen. Es gibt keinen guten Grund, sie wegzulassen.
- Mit
default-src 'none'lernst du, was deine Seite wirklich lädt. - Halte Skripte aus dem HTML heraus. Sobald die CSP streng ist, müssen sie ohnehin umziehen.
no-referrerkostet eine Seite ohne Tracking nichts.- Die Scanner sind Belege: Webbkoll nennt zu jedem Befund den passenden DSGVO-Artikel.
Beruht auf
-
Security-Header für eine Astro-Seite hinter Caddy
(
raw/2026/2026-04-22/security-header-fuer-eine-astro-seite-hinter-caddy.md) [post]
Mehr dazu
Thema
- Webentwicklung Wie diese und andere Websites entstehen und gefunden werden: statische Seiten, Suchmaschinen, IndieWeb und Karten im Browser.
Grundlage für
- Astro-Client-Islands unter strikter CSP Warum Astro-Islands unter script-src 'self' still scheitern, wie ich die zwei Hydrations-Inlines per sha256-Hash erlaubt habe und ein Drift-Check beim Deploy.
- Leaflet und Stadia Maps hinter einer strikten CSP Zwei Korrekturen, mit denen die Foto-Weltkarte in Produktion lief: der Tile-Host in img-src und eine Referrer-Policy origin an den Kacheln.
- Webmention-Avatare lokal cachen Ein Astro-Helper lädt Webmention-Avatare beim Build herunter, dedupliziert und räumt sie auf. Die CSP bleibt strikt, Leser rufen den Avatar-Host nie auf.
- YouTube DSGVO-konform einbetten Eine Astro-Komponente, die YouTube erst nach einem Klick lädt: einmalig, zustimmen und merken oder nur der Link. Kein Cookie, kein Request an Google vorher.
Baut auf
- Caddy als Reverse Proxy mit HTTPS und kanonischem Host Caddy vor einem Container auf einem VPS: TLS von Let's Encrypt ohne Zutun, www leitet auf die Domain um, der Port der App ist von außen zu.
Nutzt
- Caddy Webserver und Reverse Proxy, der TLS-Zertifikate selbst holt und erneuert, eingerichtet in einem kurzen Caddyfile.
Erwähnt in
- Google Maps DSGVO-konform einbetten Eine Astro-Komponente, die Google Maps erst nach Zustimmung lädt, die Entscheidung in localStorage merkt und aus Koordinaten Links zu Google und Apple Maps baut.