aslan6474 1
aslan6474
romegames 1
romegames
Reklam vermek için turkmmo@gmail.com

Caddy ile Web Uygulaması Yayınlamak: Otomatik HTTPS, Reverse Proxy, Statik Dosya Sunma ve Loglama (Docker)

Caddy Nedir, Neden Bu Kadar Konuşuluyor?

Caddy, Go diliyle yazılmış açık kaynaklı bir web sunucusu. Onu Nginx ve Apache'den ayıran en büyük fark, ayar dosyasının sadeliği ve HTTPS işini tamamen kendi üstlenmesi. Ayar dosyasına alan adınızı yazmanız yeterli; sertifikayı Let's Encrypt'ten kendisi alıyor, süresi dolmadan yeniliyor ve HTTP isteklerini HTTPS'e kendiliğinden yönlendiriyor. HTTP/3 desteği de ek bir ayar gerektirmeden geliyor.

Bu rehberde Caddy'yi Docker üzerinde çalıştıracağız. Önce derlenmiş bir React sitesini yayına alacağız, ardından aynı sunucudaki bir API'yi reverse proxy ile arkaya bağlayacak ve son olarak istek kayıtlarını tutmayı ayarlayacağız.

Docker Compose ile Kurulum

Boş bir klasör açıp içine docker-compose.yml ve Caddyfile adında iki dosya koyuyoruz. Caddy aldığı sertifikaları ve özel anahtarları /data klasöründe, son çalışan ayarı ise /config klasöründe saklıyor. Bu iki klasörü kalıcı birime bağlamazsanız konteyner her yeniden başladığında sertifikaları baştan almak zorunda kalır ve kısa sürede Let's Encrypt'in istek sınırına takılabilirsiniz.

Kod:
services:
  caddy:
    image: caddy:2
    container_name: caddy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./site:/srv
      - caddy_data:/data
      - caddy_config:/config

volumes:
  caddy_data:
  caddy_config:

Sondaki 443/udp satırı HTTP/3 için gerekli. Dosyaları hazırladıktan sonra docker compose up -d komutuyla konteyneri başlatın. Tarayıcıda sunucunun adresini açtığınızda bir sayfa geliyorsa kurulum tamam demektir. Bu aşamada "port is already allocated" hatası alırsanız 80 ya da 443 portunu başka bir program, büyük ihtimalle eski bir Nginx ya da Apache kullanıyordur.

Statik Dosya Sunma

React, Vue ya da düz HTML fark etmez; derlediğiniz dosyaları site klasörüne kopyalayıp Caddyfile'a şunu yazmanız yeterli:

Kod:
:80 {
    root * /srv
    encode gzip zstd
    try_files {path} /index.html
    file_server
}

Buradaki try_files satırı tek sayfalık uygulamalar için hayati. Ziyaretçi /profil gibi bir adresi doğrudan açtığında ya da sayfayı yenilediğinde sunucu bu yolu dosya olarak bulamaz ve 404 hatası verir. Bu satır bulunamayan her yolu index.html'e yönlendirerek sayfa geçişlerini uygulamanın kendi yönlendiricisine bırakıyor. encode satırı ise dosyaları sıkıştırıp sayfaların daha hızlı açılmasını sağlıyor. Ayarı değiştirdikten sonra docker compose restart demeyi unutmayın.

Otomatik HTTPS

Caddy'nin asıl parladığı yer burası. Alan adınızın A kaydını sunucunun IP adresine yönlendirin, 80 ve 443 portlarının güvenlik duvarında açık olduğundan emin olun ve :80 yazan yere alan adınızı yazın:

Kod:
ornek-sitem.com {
    root * /srv
    encode gzip zstd
    try_files {path} /index.html
    file_server
}

Konteyneri yeniden başlattığınızda loglarda "obtaining certificate" satırını göreceksiniz. Birkaç saniye içinde site HTTPS üzerinden açılır ve kilit simgesi belirir. Sertifika yenileme de arka planda kendiliğinden yapıldığı için takip etmeniz gereken bir son kullanma tarihi kalmıyor. /data klasörünü kalıcı birime bağladığımız için sertifika, konteyner silinip yeniden kurulsa bile korunuyor.

Reverse Proxy ile API Bağlamak

Diyelim ki aynı sunucuda Node.js ile yazılmış bir API çalışıyor ve 3000 portunu dinliyor. Bu servisi compose dosyasına backend adıyla eklediğinizde Caddy, aynı Docker ağındaki konteynere doğrudan adıyla ulaşabilir. API portunu dışarıya açmanıza gerek kalmaz. /api ile başlayan istekleri API'ye, geri kalan her şeyi statik siteye göndermek için Caddyfile şöyle olur:

Kod:
ornek-sitem.com {
    handle_path /api/* {
        reverse_proxy backend:3000
    }

    handle {
        root * /srv
        try_files {path} /index.html
        file_server
    }
}

handle_path, isteği API'ye iletmeden önce /api ön ekini siliyor. Böylece API tarafındaki rotalarınızı /api eklemeden, sade biçimde yazabilirsiniz. Trafik arttığında API'nin birden fazla kopyasını çalıştırırsanız reverse_proxy satırına adresleri art arda yazmanız yeterli; Caddy gelen yükü bu kopyalar arasında paylaştırıyor.

İstek Kayıtlarını Tutmak

Caddy varsayılan olarak gelen istekleri kaydetmiyor. Site bloğunun içine küçük bir log bölümü eklemek bunu değiştiriyor:

Kod:
log {
    output file /data/access.log {
        roll_size 10mb
        roll_keep 5
    }
    format json
}

Bu ayarla her istek JSON biçiminde kaydediliyor; dosya 10 MB'a ulaşınca yenisi açılıyor ve son beş dosya saklanıyor. Kayıtları terminalde anlık izlemek isterseniz output satırına stdout yazıp docker compose logs -f komutunu kullanabilirsiniz. JSON biçimi sayesinde bu kayıtları Grafana Loki, Vector ya da benzeri bir araca aktarıp hata ve yavaşlık uyarıları kurmak da oldukça kolay.

1_caddy.png


Sonuç

Caddy, özellikle tek sunucuda birkaç proje barındıranlar için ciddi zaman kazandırıyor. Sertifika yenileme betikleriyle ve uzun ayar dosyalarıyla uğraşmak yerine birkaç satırlık bir Caddyfile ile siteyi HTTPS üzerinden yayına almak mümkün. Çok özel önbellek ya da yük dengeleme senaryolarında Nginx hâlâ güçlü bir seçenek, ama sıfırdan başlayan bir proje için Caddy'yi denemenizi kesinlikle öneririm.
 

Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)

Geri
Üst