RadarGitHub Radarai üretimi

GitHub Radar — Caddy

Varsayılan otomatik HTTPS, modüler Go eklenti sistemi ve Etag tabanlı sıfır kesintili JSON Admin API sunan açık kaynaklı HTTP/3 web sunucusu.

Caddy, geleneksel web sunucuları ve ters vekil katmanlarında geliştiricileri harici Certbot cron betikleriyle boğuşmaktan, karmaşık OpenSSL C bağımlılıklarından ve yapılandırma yenilemelerinde bağlantı düşüren hantal süreç yeniden başlatmalarından kurtarmak amacıyla saf Go ile geliştirilmiş, genişletilebilir ve varsayılan olarak otomatik HTTPS sunan açık kaynaklı bir HTTP/1-2-3 web sunucusudur 1. Nginx ve Apache HTTP Server gibi on yıllardır statik metin dosyalarına ve kırılgan C modüllerine dayanan eski mimarilere karşı Caddy; dahili ACME sertifika otomasyonu, ad alanı tabanlı modüler Go çekirdeği ve Etag iyimser eşzamanlılık denetimiyle çalışan canlı JSON yapılandırma API’si sayesinde hem uç sunucu hem de API ağ geçidi olarak kullanılan devrimci bir sistem altyapısıdır 2.

Web altyapısı, ters vekil mimarisi ve sıfır bakım TLS otomasyonu çevrelerinde 79 bin yıldız ve son commit 1 gün önce düzeyinde küresel bir geliştirici benimsemesine ulaşan depo, aktif olarak yönetilen 201 açık issue ve güvenlik yamalarını içeren son sürüm v2.11.6 (Ekim 2026) metrikleriyle canlılığını kanıtlamaktadır.

Mimari Deep-Dive: Caddy

Caddy’nin sistem mimarisinde yarattığı en büyük mühendislik sıçraması, web sunucusunu statik bir dosya okuyucu olmaktan çıkarıp çalışma zamanında dinamik olarak yeniden şekillendirilebilen, tek bir çekirdek JSON şeması ve modüler Go arayüzleri etrafında dönen bir uygulama platformu olarak tasarlamasıdır. Proje bütünüyle saf Go diliyle geliştirilmiştir 1. Go seçimi; C/C++ tabanlı OpenSSL kütüphanelerindeki bellek taşması (buffer overflow) risklerini tamamen bertaraf etmek, standart crypto/tls ve quic-go yığınlarıyla HTTP/3 protokolünü harici C bağımlılığı olmadan sunabilmek ve goroutine tabanlı eşzamanlılıkla on binlerce TLS el sıkışmasını alt milisaniyelik gecikmelerle yürütebilmek amacıyla yapılmıştır.

Sistemin kalbinde yer alan ilk temel mimari sütun varsayılan Automatic HTTPS motorudur 3. Yapılandırmada bir alan adı eşleştiricisi (host matcher) tanımlandığı anda Caddy, harici hiçbir ek araca ihtiyaç duymadan Let’s Encrypt veya ZeroSSL ile ACME protokolü üzerinden konuşur; TLS-ALPN-01 ve HTTP-01 doğrulamalarını otomatik tamamlar, OCSP zımbalamasını (stapling) yönetir ve sertifikaları süresi dolmadan arka planda yeniler. Çok düğümlü kümelerde aynı alan adı için mükerrer sertifika istenmesini önlemek amacıyla varsayılan file_system depolama modülü yerine Redis veya S3 uyumlu dağıtık depolama eklentileri takılabilir.

İkinci kritik sütun ad alanı tabanlı CaddyModule eklenti mimarisidir 2. Caddy içindeki her işlev (http.handlers.reverse_proxy, http.handlers.file_server) kendi yaşam döngüsüne sahip bir Go modülüdür. Modüller ana sunucu tarafından Provision ve Validate aşamalarından geçirilerek belleğe alınır. Geliştiriciler xcaddy derleyicisiyle özel WAF filtrelerini veya kimlik doğrulama katmanlarını doğrudan tek bir statik ikili dosyanın içine gömebilir.

Üçüncü sütun ise canlı yapılandırma sunan RESTful Admin API katmanıdır 4. Geliştiricilerin sevdiği sade Caddyfile sözdizimi aslında yalnızca bir ön uç adaptörüdür; çalıştırıldığında arka planda tek bir JSON belgesine derlenir. /config/... uç noktaları üzerinden yapılan dinamik güncellemelerde süreç yeniden başlatılmaz ve açık TCP/WebSocket bağlantıları kesilmez. Eşzamanlı API güncellemelerinde çarpışmaları önlemek için Etag ve If-Match başlıklarıyla iyimser eşzamanlılık denetimi (optimistic concurrency control) uygulanır; çakışma anında sistem HTTP 412 döndürerek tutarlılığı korur.

Kod ve Topluluk Sağlığı

Caddy, kurucu Matt Holt ve baş bakımcı Francis Lavoie liderliğinde yetkin bir çekirdek mühendislik ekibi ve yüzlerce küresel açık kaynak katkıcısı tarafından sürdürülmektedir 1. ZeroSSL ortaklığı ve kurumsal destek anlaşmalarıyla finansal sürdürülebilirliğini koruyan proje, bağımsız açık kaynak yönetişimiyle kararlı bir yol haritası izlemektedir.

Depodaki 201 açık issue sayısı, 79 bin yıldıza sahip devasa bir web altyapısı için olağanüstü derecede düşük ve sıkı yönetilen bir envanteri temsil eder. Bakımcı ekibi topluluktan gelen kritik ağ hatalarına saatler içinde müdahale etmektedir; örneğin 2026 yılındaki proxy_protocol ve h2c çakışması (#7529) raporlandıktan yalnızca birkaç gün içinde düzeltilip v2.11.2 ile yayımlanmıştır 5. Benzer şekilde yıl içindeki WebSocket başlık sızıntısı ve dosya yolu normalizasyonu zafiyetleri (CVE-2026-52844, CVE-2026-55458) hızla yamalanarak v2.11.4, v2.11.5 ve v2.11.6 sürümleriyle kapatılmıştır. Çekirdek depoya sunulan her çekme isteği (PR); otomatik yarışma denetleyicisi (race detector) ve TLS entegrasyon testlerinden geçer. health_score bu bölümden türer: issue kapanma hızı, sürüm düzeni, bakımcı ekibi. Ajanın tahminidir; künyede öyle yazılır. Projenin yüksek issue kapatma hızı, güvenlik tepki süresi ve sade mimarisi dikkate alınarak health_score: 9.4 takdir edilmiştir.

Production Riski: Gerçekten Kullanılır mı?

Caddy’yi kurumsal üretim hatlarına dahil etmeyi değerlendiren sistem mimarları için lisanslama açısından hiçbir hukuki risk bulunmamaktadır; proje son derece özgür Apache 2.0 lisansı ile dağıtılmakta olup şirket içi sunucularda, gömülü sistemlerde veya ticari SaaS ürünlerinde kısıtlamasız kullanım serbestisi sunar 6.

Caddy’nin üretimde hayat kurtardığı senaryolar oldukça belirgindir: Binlerce özel müşteri alan adına (custom domain) sahip SaaS platformları için On-Demand TLS ile anlık sertifika üretmek, Docker ve Kubernetes konteynerleri önünde sıfır kesintiyle çalışan otomatik HTTPS ters vekili kurmak ve harici C kütüphanesi barındırmayan güvenli API ağ geçitleri işletmek. Tek bir statik ikili dosya olarak çalışabilmesi operasyonel bakım maliyetini sıfıra indirir.

Buna karşın, operasyonel olarak yönetilmesi gereken belirgin sınırlar vardır. İlk kısıt çok düğümlü (clustered) yapılardaki paylaşımlı depolama gereksinimidir; arkada yük dengeleyici bulunan birden fazla Caddy örneği yerel disk yerine paylaşımlı bir Redis veya S3 depolama modülüne bağlanmazsa Let’s Encrypt hız sınırlarına (rate limit) takılabilir. İkinci kısıt ise mutlak ham performans ve bellek tavanıdır; saniyede yüz binlerce statik dosya sunan veya milisaniye altı çekirdek katmanı C/Rust hızına ihtiyaç duyan ekstrem uç noktalarda Go çöp toplayıcısının (GC) getirdiği küçük bellek maliyeti Nginx veya Pingora’nın gerisinde kalabilir. Doğru iş yüklerinde kullanıldığında Caddy, modern web altyapıları için geliştirilmiş en güvenli, ergonomik ve zahmetsiz açık kaynak sunucudur.

Kaynaklar

  1. Caddy GitHub Ana Kod Deposu
  2. Caddy Resmi Sistem ve Eklenti Mimarisi Dokümantasyonu
  3. Caddy Otomatik HTTPS Hızlı Başlangıç Kılavuzu
  4. Caddy JSON Admin API ve Eşzamanlılılık Denetimi Dokümantasyonu
  5. Caddy proxy_protocol ve h2c Hata Çözümü Issue #7529
  6. Caddy Apache 2.0 Açık Kaynak Lisans Dosyası