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.
Geprüft von adrian
am
Als der Website-Container (damals eine Astro-App in Podman) auf 127.0.0.1:4321 antwortete, fehlten noch HTTPS und ein einziger kanonischer Hostname. Caddy statt nginx habe ich aus einem Grund genommen: Der eingebaute ACME-Client erspart mir certbot-Timer und Cronjobs für die Erneuerung.
Caddy installieren
Caddy ist nicht in den Standard-Repositories von Debian, also habe ich den Stable-Kanal von Cloudsmith eingebunden:
sudo apt update
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list >/dev/null
sudo apt update
sudo apt install -y caddy
Reverse Proxy und kanonischer Host
Zwei DNS-Namen zeigten auf den VPS, adrian-altner.de und www.adrian-altner.de. Öffentlich sollte genau einer davon sein, der andere sollte mit einem 301 antworten. Die Site-Blöcke von Caddy erledigen beides auf einmal, TLS und die Umleitung, ohne weitere Konfiguration:
# /etc/caddy/Caddyfile
www.adrian-altner.de {
redir https://adrian-altner.de{uri} permanent
}
adrian-altner.de {
encode zstd gzip
reverse_proxy 127.0.0.1:4321
}
Beim ersten Start holt Caddy Zertifikate von Let's Encrypt für beide Hostnamen, liefert adrian-altner.de über den Reverse Proxy aus und beantwortet www.adrian-altner.de mit einer dauerhaften Umleitung.
Prüfen und neu laden
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl restart caddy
sudo systemctl enable caddy
sudo systemctl status caddy --no-pager
Eine Warnung zur Formatierung bei validate ist harmlos. caddy fmt räumt die Datei an Ort und Stelle auf:
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
Das Ergebnis prüfen
curl -I http://adrian-altner.de
curl -I https://adrian-altner.de
curl -I https://www.adrian-altner.de
Worauf ich geachtet habe:
- HTTP leitet auf HTTPS um (das macht Caddy von selbst, sobald TLS steht).
wwwliefert einen 301 auf die Domain ohnewww.- Das Zertifikat ist gültig und von Let's Encrypt ausgestellt.
Den Port der App schließen
Wenn Caddy der einzige öffentliche Zugang ist, muss Port 4321 von außen nicht erreichbar sein. Die Bindung an localhost in der Compose-Datei macht diese Tür zu:
ports:
- '127.0.0.1:4321:4321'
Jetzt lauscht die App nur noch auf dem Loopback-Interface, und 80 und 443 gehören allein Caddy.
Zum Mitnehmen
- Binde den App-Container an
127.0.0.1, sobald ein Proxy davor steht. Ihn öffentlich zu lassen bringt nichts. - Ein kanonischer Hostname, auf den der andere umleitet, erspart dir später doppelte Inhalte in Suchmaschinen.
Beruht auf
-
Caddy for Astro + Podman (HTTPS and Canonical Host)
(
raw/2026/2026-03-03/caddy-for-astro-podman-https-and-canonical-host.md) [post]
Mehr dazu
Thema
- Self-Hosting Dienste auf einem Server betreiben, über den du selbst verfügst, statt die gehostete Fassung eines Anbieters zu nutzen.
Grundlage für
- 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.
Nutzt
- Caddy Webserver und Reverse Proxy, der TLS-Zertifikate selbst holt und erneuert, eingerichtet in einem kurzen Caddyfile.
- Podman Container-Engine ohne Hintergrunddienst, unter Linux standardmäßig rootless, mit denselben Befehlen auf dem Mac und auf dem Server.
Erwähnt in
- Einen Compose-Stack nach einem Neustart weiterlaufen lassen Eine systemd-Unit, die einen Podman-Compose-Stack beim Booten startet, damit die Website nach einem Neustart des VPS von selbst wiederkommt.