Komprimierung aktivieren

Einrichtung

Über die UI

Der Toggle sitzt im Route-Wizard in Step 2 — Transport, neben Force HTTPS und Backend HTTPS.

1. Route erstellen oder bearbeiten
2. In Step 2 Compression Toggle aktivieren
3. Speichern

Es gibt keine weiteren Optionen — Zstd, Brotli und Gzip sind automatisch aktiv.

Über die API

# Compression aktivieren
curl -X PUT https://gatecontrol.example.com/api/v1/routes/1 \
  -H "Authorization: Bearer gc_..." \
  -H "Content-Type: application/json" \
  -d '{
    "compress_enabled": true
  }'

Wichtige Hinweise

• Nicht empfohlen für bereits komprimierte Inhalte. Bilder (JPEG, PNG, WebP), Videos (MP4, WebM), Archive (ZIP, tar.gz) und Schriftarten (WOFF2) sind bereits komprimiert. Compression verschwendet CPU-Zeit und vergrößert sie manchmal sogar minimal.
• Caddy komprimiert nur wenn der Client Accept-Encoding sendet. Alte oder spezialisierte HTTP-Clients ohne diesen Header bekommen unkomprimierte Antworten.
• Compression erhöht die CPU-Auslastung auf dem GateControl-Server minimal. Bei sehr hohem Traffic und großen Antworten kann das relevant werden.
• Streaming-Responses (z.B. Server-Sent Events, chunked Transfer) werden ebenfalls komprimiert, können aber höhere Latenz haben da der Encoder auf genügend Daten zum Komprimieren wartet.
• Compression ist nur für HTTP-Routen verfügbar, nicht für L4 (TCP/UDP).
• Wenn das Backend selbst bereits komprimierte Antworten liefert (Content-Encoding: gzip), komprimiert Caddy nicht doppelt.

Siehe auch

• concepts/routing.md — Handler-Reihenfolge im HTTP-Pipeline