Caddy 2.9 Reverse Proxy Kurulumu: Otomatik HTTPS ile Modern Web Sunucusu (2026)

Ubuntu / Debian Üzerinde Kurulum

# Caddy resmi APT deposunu ekle
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https

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

# Paket listesini güncelle ve Caddy'yi kur
sudo apt update
sudo apt install -y caddy

# Versiyon kontrolü
caddy version

# Servis durumu
sudo systemctl status caddy

Diğer Sistemler İçin Kurulum

# macOS (Homebrew)
brew install caddy

# CentOS / RHEL
sudo dnf install -y 'dnf-command(copr)'
sudo dnf copr enable -y @caddy/caddy
sudo dnf install -y caddy

# Docker ile (en taşınabilir)
docker run -d --name caddy \
  -p 80:80 -p 443:443 \
  -v $PWD/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  caddy:2.9

En Basit Caddyfile (Hello World)

# /etc/caddy/Caddyfile

example.com {
    respond "Merhaba Alesta Web!"
}

Bu kadar! Caddy bu dosyayı okuduğunda example.com için otomatik olarak HTTPS sertifikası alır, HTTP'den HTTPS'e yönlendirir ve cevap olarak metin döndürür. Hiçbir ek yapılandırma gerekmez (no additional configuration needed).

Statik Dosya Sunma

site.example.com {
    root * /var/www/site
    file_server
}

Yapılandırmayı Yeniden Yükleme

# Caddyfile değiştirildikten sonra
sudo systemctl reload caddy

# Veya manuel olarak
sudo caddy reload --config /etc/caddy/Caddyfile

# Yapılandırmayı kontrol et (validate)
caddy validate --config /etc/caddy/Caddyfile

Tek Backend için Reverse Proxy

app.example.com {
    reverse_proxy localhost:3000
}

Evet, sadece bu kadar. Caddy şunları otomatik yapar:

• Let's Encrypt'ten ücretsiz HTTPS sertifikası alır
• HTTP'den HTTPS'e otomatik yönlendirme
• HTTP/2 ve HTTP/3 etkinleştirir
• WebSocket'leri proxy'ler
• Sertifikayı otomatik yeniler (cron yok!)

Path Bazlı Yönlendirme (Path-Based Routing)

api.example.com {
    # /api/* istekleri Node backend'e
    handle /api/* {
        reverse_proxy localhost:3000
    }

    # /admin/* istekleri Python backend'e
    handle /admin/* {
        reverse_proxy localhost:8000
    }

    # Geri kalanı statik dosya
    handle {
        root * /var/www/frontend
        file_server
    }
}

Header Manipülasyonu (Header Manipulation)

api.example.com {
    reverse_proxy localhost:3000 {
        # Backend'e ek header gönder
        header_up X-Real-IP {remote_host}
        header_up X-Forwarded-For {remote_host}

        # Backend'den gelen response'a header ekle
        header_down Strict-Transport-Security "max-age=31536000;"
    }
}

Wildcard Sertifika (DNS Challenge)

*.example.com {
    tls {
        dns cloudflare {env.CLOUDFLARE_API_TOKEN}
    }

    @api host api.example.com
    handle @api {
        reverse_proxy localhost:3000
    }

    @app host app.example.com
    handle @app {
        reverse_proxy localhost:4000
    }
}

Bu yapılandırma *.example.com için tek bir wildcard sertifika alır ve subdomain'leri ayrı ayrı yönetir. alestaweb.com gibi subdomain yoğun projelerde çok kullanışlı (very useful for subdomain-heavy sites).

Çoklu Backend ile Load Balancing

api.example.com {
    reverse_proxy {
        to localhost:3001
        to localhost:3002
        to localhost:3003

        lb_policy least_conn
        health_uri /health
        health_interval 10s
        health_timeout 5s
    }
}

HTTP/3 Aktivasyonunu Doğrulama

# HTTP/3 desteğini test et (curl 7.66+ gerekir)
curl --http3 -I https://example.com

# Tarayıcı (Chrome) DevTools → Network → Protocol sütunu
# 'h3' veya 'h3-29' gibi değerler görmelisiniz

Caddy vs Nginx

❌ "challenge failed" — Sertifika alınamıyor

Genelde DNS veya port engelinden kaynaklanır.

# DNS doğru mu kontrol et
dig example.com +short

# Portlar açık mı?
sudo ufw status
sudo iptables -L

# Port 80 ve 443 açık olmalı
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

❌ "rate limit exceeded" — Let's Encrypt limiti

Test sırasında sürekli sertifika denerseniz limit aşılabilir.

example.com {
    tls {
        # Test ortamında staging server kullanın
        ca https://acme-staging-v02.api.letsencrypt.org/directory
    }
    respond "test"
}

❌ Caddy başlatılamıyor — port 80 kullanımda

Apache veya başka bir web sunucusu zaten 80 portunu dinliyor olabilir.

# 80 portunda ne çalışıyor?
sudo lsof -i :80

# Apache'yi durdur
sudo systemctl stop apache2
sudo systemctl disable apache2

# Caddy'yi başlat
sudo systemctl start caddy