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.

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).
  • www liefert einen 301 auf die Domain ohne www.
  • 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.

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
Schlagwörter

In der Graph-Ansicht zeigen →