Caddy – Konzepte und Konfiguration - Versionsgeschichte

Admin am 25. April 2026 um 12:34 Uhr

2026-04-25T12:34:29Z

← Nächstältere Version		Version vom 25. April 2026, 12:34 Uhr
Zeile 51:		Zeile 51:
	Bei Docker-Containern kann der Containername als Hostname verwendet werden:		Bei Docker-Containern kann der Containername als Hostname verwendet werden:

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	reverse_proxy nextcloud:443		reverse_proxy nextcloud:443
	</~~syntaxhighlight~~>		</pre>

	Caddy löst <code>nextcloud</code> über das interne Docker-Netz auf.		Caddy löst <code>nextcloud</code> über das interne Docker-Netz auf.
Zeile 63:		Zeile 63:
	'''Kurzfassung:''' Steuert wie Caddy intern mit dem Zieldienst kommuniziert.		'''Kurzfassung:''' Steuert wie Caddy intern mit dem Zieldienst kommuniziert.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	reverse_proxy nextcloud:443 {		reverse_proxy nextcloud:443 {
	transport http {		transport http {
Zeile 69:		Zeile 69:
	}		}
	}		}
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 88:		Zeile 88:
	'''Kurzfassung:''' Setzt, entfernt oder verändert HTTP-Response-Header – also Header die Caddy an den Browser zurückschickt.		'''Kurzfassung:''' Setzt, entfernt oder verändert HTTP-Response-Header – also Header die Caddy an den Browser zurückschickt.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	header {		header {
	-Server		-Server
Zeile 96:		Zeile 96:
	Referrer-Policy "no-referrer"		Referrer-Policy "no-referrer"
	}		}
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 117:		Zeile 117:
	'''Kurzfassung:''' Setzt Header die Caddy an den '''Zieldienst''' (upstream) weiterleitet – nicht an den Browser.		'''Kurzfassung:''' Setzt Header die Caddy an den '''Zieldienst''' (upstream) weiterleitet – nicht an den Browser.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	reverse_proxy myapp:8080 {		reverse_proxy myapp:8080 {
	header_up X-Real-IP {remote_ip}		header_up X-Real-IP {remote_ip}
	}		}
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 137:		Zeile 137:
	'''Kurzfassung:''' Definiert eine benannte Bedingung die auf Anfragen zutreffen kann oder nicht.		'''Kurzfassung:''' Definiert eine benannte Bedingung die auf Anfragen zutreffen kann oder nicht.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	@xmlrpc path /xmlrpc.php		@xmlrpc path /xmlrpc.php
	respond @xmlrpc 403		respond @xmlrpc 403
Zeile 148:		Zeile 148:
	reverse_proxy backend:8080		reverse_proxy backend:8080
	}		}
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 170:		Zeile 170:
	'''Kurzfassung:''' Führt Direktiven nur dann aus wenn ein Matcher zutrifft. Nicht-passende Anfragen fallen durch zum nächsten Block.		'''Kurzfassung:''' Führt Direktiven nur dann aus wenn ein Matcher zutrifft. Nicht-passende Anfragen fallen durch zum nächsten Block.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	@static path /static/*		@static path /static/*
	handle @static {		handle @static {
Zeile 179:		Zeile 179:
	reverse_proxy backend:8080		reverse_proxy backend:8080
	}		}
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 201:		Zeile 201:
	'''Kurzfassung:''' Leitet den Browser auf eine andere URL um.		'''Kurzfassung:''' Leitet den Browser auf eine andere URL um.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	redir https://new.example.com{uri} 301		redir https://new.example.com{uri} 301
	redir https://new.example.com{uri} 308		redir https://new.example.com{uri} 308
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 229:		Zeile 229:
	'''Kurzfassung:''' Antwortet direkt mit einem HTTP-Statuscode – ohne den Zieldienst zu kontaktieren.		'''Kurzfassung:''' Antwortet direkt mit einem HTTP-Statuscode – ohne den Zieldienst zu kontaktieren.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	@xmlrpc path /xmlrpc.php		@xmlrpc path /xmlrpc.php
	respond @xmlrpc 403		respond @xmlrpc 403

	respond 404		respond 404
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 263:		Zeile 263:
	'''Kurzfassung:''' Liefert statische Dateien aus einem Verzeichnis aus.		'''Kurzfassung:''' Liefert statische Dateien aus einem Verzeichnis aus.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	root * /var/www/html		root * /var/www/html
	file_server		file_server
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 278:		Zeile 278:
	'''Kurzfassung:''' Steuert TLS-Einstellungen für eine Domain.		'''Kurzfassung:''' Steuert TLS-Einstellungen für eine Domain.

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	tls {		tls {
	alpn http/1.1		alpn http/1.1
	}		}
	</~~syntaxhighlight~~>		</pre>

	'''Erklärung:'''		'''Erklärung:'''
Zeile 296:		Zeile 296:
	Am Anfang des Caddyfiles können globale Einstellungen gesetzt werden:		Am Anfang des Caddyfiles können globale Einstellungen gesetzt werden:

	<~~syntaxhighlight lang="caddy"~~>		<pre>
	{		{
	admin 127.0.0.1:2019		admin 127.0.0.1:2019
	}		}
	</~~syntaxhighlight~~>		</pre>

	<code>admin</code> aktiviert die Caddy-Admin-API auf dem angegebenen Port. Mit <code>127.0.0.1:2019</code> ist sie nur lokal erreichbar – nicht von außen. Über diese API kann Caddy zur Laufzeit neu geladen werden:		<code>admin</code> aktiviert die Caddy-Admin-API auf dem angegebenen Port. Mit <code>127.0.0.1:2019</code> ist sie nur lokal erreichbar – nicht von außen. Über diese API kann Caddy zur Laufzeit neu geladen werden:
Zeile 306:		Zeile 306:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	caddy reload --config /etc/caddy/Caddyfile		caddy reload --config /etc/caddy/Caddyfile
	</~~syntaxhighlight~~>		</pre>

	----		----

Admin: /* Das Caddyfile */

2026-04-25T12:25:11Z

Das Caddyfile

← Nächstältere Version		Version vom 25. April 2026, 12:25 Uhr
Zeile 20:		Zeile 20:
	Grundstruktur:		Grundstruktur:

	<~~syntaxhighlight lang="caddy"~~>		<pre>

	example.com {		example.com {
	# Direktiven für diese Domain		# Direktiven für diese Domain
	}		}
	</~~syntaxhighlight~~>		</pre>

	Alles innerhalb der geschweiften Klammern gilt nur für diese Domain. Mehrere Domains können in derselben Datei konfiguriert werden.		Alles innerhalb der geschweiften Klammern gilt nur für diese Domain. Mehrere Domains können in derselben Datei konfiguriert werden.

Admin: /* Caddy – Konzepte und Konfiguration */

2026-04-25T12:17:45Z

Caddy – Konzepte und Konfiguration

← Nächstältere Version		Version vom 25. April 2026, 12:17 Uhr
Zeile 19:		Zeile 19:

	Grundstruktur:		Grundstruktur:

			<syntaxhighlight lang="caddy">

	example.com {		example.com {
	# Direktiven für diese Domain		# Direktiven für diese Domain
	}		}
			</syntaxhighlight>

	Alles innerhalb der geschweiften Klammern gilt nur für diese Domain. Mehrere Domains können in derselben Datei konfiguriert werden.		Alles innerhalb der geschweiften Klammern gilt nur für diese Domain. Mehrere Domains können in derselben Datei konfiguriert werden.

Admin am 25. April 2026 um 12:15 Uhr

2026-04-25T12:15:39Z

← Nächstältere Version		Version vom 25. April 2026, 12:15 Uhr
Zeile 20:		Zeile 20:
	Grundstruktur:		Grundstruktur:

	~~<syntaxhighlight lang="caddy">~~
	example.com {		example.com {
	# Direktiven für diese Domain		# Direktiven für diese Domain
	}		}
	~~</syntaxhighlight>~~

	Alles innerhalb der geschweiften Klammern gilt nur für diese Domain. Mehrere Domains können in derselben Datei konfiguriert werden.		Alles innerhalb der geschweiften Klammern gilt nur für diese Domain. Mehrere Domains können in derselben Datei konfiguriert werden.
Zeile 36:		Zeile 34:
	'''Kurzfassung:''' Leitet eingehende Anfragen an einen anderen Dienst weiter.		'''Kurzfassung:''' Leitet eingehende Anfragen an einen anderen Dienst weiter.

	~~<syntaxhighlight lang="caddy">~~
	reverse_proxy localhost:8080		reverse_proxy localhost:8080
	reverse_proxy myapp:3000		reverse_proxy myapp:3000
	~~</syntaxhighlight>~~

	'''Erklärung:'''		'''Erklärung:'''

Admin: /* Siehe auch */

2026-04-17T11:23:43Z

Siehe auch

← Nächstältere Version		Version vom 17. April 2026, 11:23 Uhr
Zeile 344:		Zeile 344:
	=== Siehe auch ===		=== Siehe auch ===

			* [[Webserver, Reverse Proxy und Container – wie die Schichten zusammenspielen]] – Konzepte hinter Reverse Proxy, Pfad-Whitelist, Security-Header und Container-Netzwerken
	* [[Hairpin-NAT – Collabora und Nextcloud hinter Caddy]]		* [[Hairpin-NAT – Collabora und Nextcloud hinter Caddy]]
	* [https://caddyserver.com/docs Caddy-Dokumentation (englisch)]		* [https://caddyserver.com/docs Caddy-Dokumentation (englisch)]

Admin am 17. April 2026 um 11:08 Uhr

2026-04-17T11:08:22Z

← Nächstältere Version		Version vom 17. April 2026, 11:08 Uhr
Zeile 109:		Zeile 109:
	* <code>Referrer-Policy "no-referrer"</code> – Der Browser sendet beim Klick auf einen Link keine Information woher der Nutzer kam. '''Konkret:''' Die externe Seite erfährt nicht, woher du kommst.		* <code>Referrer-Policy "no-referrer"</code> – Der Browser sendet beim Klick auf einen Link keine Information woher der Nutzer kam. '''Konkret:''' Die externe Seite erfährt nicht, woher du kommst.

	~~Gemeinsam~~ bilden ~~die drei Schichten~~ eine Defense in Depth – ~~jede Schicht unabhängig~~, ~~jede macht eine andere Angriffsart schwerer~~. 🏰		Diese Header bilden gemeinsam eine erste Verteidigungslinie: Jeder schützt gegen eine andere Angriffsart, jeder unabhängig vom anderen. Das Prinzip dahinter heißt '''Defense in Depth''' – Sicherheit durch mehrere unabhängige Schichten. Fällt eine aus, stehen die anderen noch. 🏰


Zeile 340:		Zeile 340:

	Docker's internes DNS löst myAwesomeContainer zur richtigen IP auf – automatisch. Das ist die unsichtbare Brücke zwischen beiden Files.		Docker's internes DNS löst myAwesomeContainer zur richtigen IP auf – automatisch. Das ist die unsichtbare Brücke zwischen beiden Files.
	Und das gemeinsame ~~docker_network~~ ist der Raum in dem alle miteinander reden dürfen. Wer nicht drin ist, hört nichts. 🏰		Und das gemeinsame Docker-Netzwerk ist der Raum in dem alle miteinander reden dürfen. Wer nicht drin ist, hört nichts. 🏰

	=== Siehe auch ===		=== Siehe auch ===

Admin: /* Abschluss-"Meditation" */

2026-04-17T11:02:28Z

Abschluss-"Meditation"

← Nächstältere Version		Version vom 17. April 2026, 11:02 Uhr
Zeile 330:		Zeile 330:
	Beispiel (yml):		Beispiel (yml):

	~~# compose: Container heißt "collabora"~~		<code>container_name: myAwesomeContainer</code>
	container_name: myAwesomeContainer


	Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an:		Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an:

			<code>reverse_proxy myAwesomeContainer:12345</code>
	~~# compose: Container heißt "myAwesomeContainer"~~		''(-> 12345 = Portnummer, unter der der Container erreichbar ist)''
	reverse_proxy myAwesomeContainer:12345
	# -> 12345 = Portnummer, unter der der Container erreichbar ist

Admin: /* Abschluss-"Meditation" */

2026-04-17T11:00:45Z

Abschluss-"Meditation"

← Nächstältere Version		Version vom 17. April 2026, 11:00 Uhr
Zeile 330:		Zeile 330:
	Beispiel (yml):		Beispiel (yml):

	~~<syntaxhighlight lang="caddy">~~
	# compose: Container heißt "collabora"		# compose: Container heißt "collabora"
	container_name: myAwesomeContainer		container_name: myAwesomeContainer
	~~</syntaxhighlight>~~

	Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an:		Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an:

	~~<syntaxhighlight lang="caddy">~~
	# compose: Container heißt "myAwesomeContainer"		# compose: Container heißt "myAwesomeContainer"
	reverse_proxy myAwesomeContainer:12345		reverse_proxy myAwesomeContainer:12345
	# -> 12345 = Portnummer, unter der der Container erreichbar ist		# -> 12345 = Portnummer, unter der der Container erreichbar ist
	~~</syntaxhighlight>~~

	Docker's internes DNS löst myAwesomeContainer zur richtigen IP auf – automatisch. Das ist die unsichtbare Brücke zwischen beiden Files.		Docker's internes DNS löst myAwesomeContainer zur richtigen IP auf – automatisch. Das ist die unsichtbare Brücke zwischen beiden Files.
	Und das gemeinsame docker_network ist der Raum in dem alle miteinander reden dürfen. Wer nicht drin ist, hört nichts. 🏰		Und das gemeinsame docker_network ist der Raum in dem alle miteinander reden dürfen. Wer nicht drin ist, hört nichts. 🏰


	=== Siehe auch ===		=== Siehe auch ===

Admin am 17. April 2026 um 11:00 Uhr

2026-04-17T11:00:09Z

← Nächstältere Version		Version vom 17. April 2026, 11:00 Uhr
Zeile 330:		Zeile 330:
	Beispiel (yml):		Beispiel (yml):

	<~~code~~>		<syntaxhighlight lang="caddy">
	# compose: Container heißt "collabora"		# compose: Container heißt "collabora"
	container_name: myAwesomeContainer		container_name: myAwesomeContainer
	</~~code~~>		</syntaxhighlight>

	Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an:		Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an:

	<~~code~~>		<syntaxhighlight lang="caddy">
	# compose: Container heißt "myAwesomeContainer"		# compose: Container heißt "myAwesomeContainer"
	reverse_proxy myAwesomeContainer:12345		reverse_proxy myAwesomeContainer:12345
	# -> 12345 = Portnummer, unter der der Container erreichbar ist		# -> 12345 = Portnummer, unter der der Container erreichbar ist
	</~~code~~>		</syntaxhighlight>

	Docker's internes DNS löst myAwesomeContainer zur richtigen IP auf – automatisch. Das ist die unsichtbare Brücke zwischen beiden Files.		Docker's internes DNS löst myAwesomeContainer zur richtigen IP auf – automatisch. Das ist die unsichtbare Brücke zwischen beiden Files.

Admin am 17. April 2026 um 10:58 Uhr

2026-04-17T10:58:34Z

← Nächstältere Version		Version vom 17. April 2026, 10:58 Uhr
Zeile 327:		Zeile 327:
	Compose definiert wer existiert und wie die Container heißen		Compose definiert wer existiert und wie die Container heißen
	Caddy nutzt genau diese Namen als interne Adressen.		Caddy nutzt genau diese Namen als interne Adressen.

	Beispiel (yml):		Beispiel (yml):

	<code>		<code>
	# compose: Container heißt "collabora"		# compose: Container heißt "collabora"
Zeile 333:		Zeile 335:
	</code>		</code>

	Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an		Im Caddyfile spricht Caddy myAwesomeContainer mit diesem Namen an:

	<code>		<code>