Skip to main content

Reverse Proxy (Caddy)

Reverse Proxy (Caddy)

Caddy serves as the primary ingress point for all web services in the Flora Family homelab. It handles SSL termination (ACME), local CA management, and request routing.

🏗️ Structure

  • Location: /srv/caddy
  • User: 51004:61004 (Caddy Service Account)
  • Snippets Path: /main/appdata/caddy/files/snippets (Mapped internally to /etc/caddy/snippets)

📝 Caddyfile Strategy

The Caddyfile is organized into modular sites located in sites-enabled/. This mimics traditional Apache/Nginx structures for clean management.

Common Snippets

  1. security_headers.caddy: Implements HSTS, X-Frame-Options (DENY), and nosniff.
  2. common_tls_internal.caddy: Uses tls internal for services only accessible on the LAN, backed by the local Caddy CA.
  3. common_tls_external.caddy: Standard ACME/Let's Encrypt for public-facing services.

🔀 Typical Route Block

searxng.flora.family {
    reverse_proxy searxng:8080
    import /etc/caddy/snippets/security_headers.caddy
    import /etc/caddy/snippets/common_tls_internal.caddy
}