Dokümantasyon
KEYDAL

Bunny CDN ve keydal.io

Her siteye otomatik kurulan Bunny CDN'i, medya adreslerinin site.keydal.io olmasını ve bu dağıtımın getirdiği hız kazancını anlatır.

Son güncelleme: 5 Eylül 2026

Genel bakış

Bir içerik dağıtım ağı (CDN), görsellerinizi ziyaretçiye en yakın sunucudan sunan bir hızlandırma katmanıdır. KEYDAL, görsellerinizi ve medya dosyalarınızı Bunny adlı CDN üzerinden dağıtır. Siteniz kurulduğu anda bu dağıtım sizin için otomatik hazırlanır; ayrı bir hesap açmanız, kart tanımlamanız veya ayar yapmanız gerekmez.

Kurulum tamamlandığında her sitenin bir CDN adresi olur: site-kodunuz.keydal.io. Yüklediğiniz görseller bu adres üzerinden yayınlanır ve dünya genelindeki edge (kenar) sunuculardan servis edilir.

Otomatik kurulum

CDN kurulumu siparişten sonra arka planda çalışır. Siteniz ayağa kalkıp erişilebilir olduktan sonra sistem, sizin için gereken Bunny kaynaklarını sırayla ve tekrar-güvenli (idempotent) biçimde oluşturur. Bu adımlar sizin müdahalenizi beklemez ve panelde bir işlem yapmanızı gerektirmez.

Kurulum sırasında bir aksaklık olsa bile siteniz yayında kalır. CDN katmanı, sitenin çalışması için zorunlu değildir; oluşturma başarısız olursa siteniz doğrudan sunucudan (Traefik yönlendirmesiyle) yine erişilebilir olur. CDN daha sonra yeniden denendiğinde devreye girer.

Not: Bu bölüm siparişten sonra otomatik işler. Kurulumun tamamlanması birkaç dakika sürebilir; bu sürede görselleriniz doğrudan sunucudan sunulur.

Medya adresleri neden keydal.io ile biter

Her siteye, site kodundan türetilen sabit bir CDN alt alanı verilir:

site-kodunuz.keydal.io

Bir görsel yüklediğinizde dosya, sitenizin CDN deposuna kaydedilir ve size şu biçimde bir adres döner:

https://site-kodunuz.keydal.io/medya/YYYYAA/dosya-adi

Buradaki YYYYAA, yüklemenin yapıldığı yıl ve aydır (örneğin 202609). Bu adres HTTPS ile sunulur; CDN alt alanına ücretsiz SSL sertifikası (Let’s Encrypt) otomatik bağlanır ve tüm istekler güvenli bağlantıya zorlanır.

Bu adres kalıcıdır ve site koduna bağlıdır; değişmez. Haber içeriğinize eklediğiniz görsel bağlantıları da bu adresi kullanır.

Nasıl çalışır

Arka planda üç ana Bunny kaynağı birlikte çalışır:

  • Pull Zone (CDN katmanı): Ziyaretçinin isteğini karşılayan asıl dağıtım katmanıdır. İçeriği kaynağınızdan (sitenizin sunucusu) çeker, edge sunucularda önbelleğe alır ve sonraki ziyaretçilere oradan sunar.
  • Storage Zone (medya deposu): Yüklediğiniz görsellerin fiziksel olarak saklandığı depodur. Her sitenin kendi deposu olur.
  • keydal.io kaydı: site-kodunuz.keydal.io adresini CDN katmanına bağlayan DNS kaydıdır. SSL sertifikası bu kayıt oluştuktan sonra çözümlenir.

CDN katmanı, kaynağınızdan aldığı yanıtın önbellek süresine (Cache-Control) uyar. Ayrıca “güncellenirken eskiyi sun” ve “kaynak çevrimdışıyken eskiyi sun” davranışları açıktır: kısa süreli bir kesinti olsa bile ziyaretçi, önbellekteki sürümü görmeye devam eder.

Her site için oluşturulan kaynaklar

KaynakNe işe yararVarsayılan
Pull Zone (CDN)İçeriği edge sunuculardan dağıtırHer sitede açık
Storage ZoneYüklenen medya dosyalarını saklarHer sitede açık
keydal.io adresisite.keydal.io + ücretsiz SSLHer sitede açık
DNS bölgesiKendi alan adınızın yönetimiYalnız özel alan adında
Shield (WAF/DDoS)Saldırı ve bot korumasıKapalı, talep üzerine

Dağıtım ağı iki katmanda sunulur. Paketinize göre sitenize Standard veya bütçe dostu Volume ağı atanır; temel pakette Volume, üst paketlerde Standard kullanılır. İkisi de aynı CDN altyapısını kullanır, kapsama ayrıntılarında farklılaşır.

Not: Shield (web uygulaması güvenlik duvarı ve DDoS koruması) varsayılan olarak kapalıdır ve talep üzerine açılır. Modülde hazırdır; otomatik açılmamasının nedeni, bu katmanın ayrı ücretli olması ve ayrı yönetim gerektirmesidir.

Coğrafi dağıtım ve hız

CDN, içeriğinizi tek bir sunucudan değil, birden çok bölgedeki edge sunuculardan sunar. Bu sayede ziyaretçi, görseli kendisine en yakın noktadan indirir; bekleme süresi kısalır.

Varsayılan olarak açık bölgeler:

  • Avrupa (Türkiye buraya dahildir) — Türk haber siteleri için ana bölge
  • Kuzey Amerika
  • Asya

Güney Amerika ve Afrika bölgeleri varsayılan olarak kapalıdır. Bu dağıtımın pratik faydaları:

  • Görseller ziyaretçiye en yakın edge sunucudan gelir, sayfa daha hızlı açılır.
  • Aynı görsel tekrar tekrar sunucunuzdan çekilmez; önbellekten servis edilir, sunucunuzun yükü azalır.
  • Yoğun trafik anlarında (öne çıkan bir haber gibi) CDN katmanı isteğin büyük kısmını karşılar.

Kendi alan adınızı kullanırsanız

Sitenizde kendi alan adınızı (örneğin haberim.com) kullanıyorsanız, CDN kurulumu bu alan adı için ayrıca bir DNS bölgesi oluşturur. keydal.io alt alanınız yine açık kalır; kendi alan adınız buna ek olarak yönetilir.

keydal.net altındaki bir alt alan kullanan sitelerde ayrı DNS bölgesi oluşturulmaz; bu durumda CDN adresi olarak yalnızca keydal.io alt alanı yeterlidir.

Sık karşılaşılan durumlar

Görsellerim hemen CDN’den gelmiyor. Site yeni kurulduysa CDN hazırlığı birkaç dakika sürebilir. Bu sürede görselleriniz doğrudan sunucudan sunulur; hazırlık bittiğinde otomatik olarak CDN adresine geçilir.

SSL sertifikası hemen görünmüyor. Ücretsiz sertifika, keydal.io kaydı oluşturulduktan sonra asenkron çözümlenir. Kısa bir süre sonra bağlantı güvenli hale gelir.

CDN kurulamadı ama sitem çalışıyor. Beklenen davranış budur. CDN katmanı sitenin ayakta kalması için zorunlu değildir; kurulum başarısız olsa da siteniz doğrudan sunucudan erişilebilir kalır.

İlgili sayfalar

  • CDN kredisi, kullanım ölçümü ve önbellek temizleme konuları için CDN kredi ve faturalandırma sayfasına bakın.
  • Görsel yükleme ve medya kütüphanesi konuları için medya yönetimi sayfasına bakın.