Cloudflare R2 Custom Domain Nasıl Bağlanır?

R2 bucket'ındaki herkese açık görselleri kendi medya alt alan adınızdan yayınlamak için bucket'a custom domain bağlayın. Gizli belgeler veya müşteri dosyaları bulunan bucket'ı bu yöntemle halka açmayın.

1. Bucket kapsamını kontrol edin

Public sunulacak nesneleri ayrı bucket'a koyun. Nesne adlarını, Content-Type ve Cache-Control metadata'sını kontrol edin. R2 API erişim anahtarı tarayıcıya gönderilmemelidir.

2. Domain bağlayın

R2 → bucket → Settings → Custom Domains bölümünden Cloudflare hesabınızdaki zone'a ait örneğin media.example.com ekleyin. Panelin bağlantı/DNS akışını tamamlayın. R2 S3 API endpoint'ine rastgele CNAME yazmak public custom domain kurulumunun yerine geçmez.

3. Bir nesneyi test edin

curl -I https://media.example.com/urunler/ornek.webp

200, uygun Content-Type: image/webp ve beklenen cache başlıklarını arayın. 404 varsa dosya adı/büyük-küçük harf/bucket eşleşmesini kontrol edin. Domain durumunun aktif olmasını bekleyin. Sertifika sorunu varsa bağlantı durumu ve DNS'i inceleyin.

4. Siteyi kademeli taşıyın

Önce tek görselin URL'sini değiştirin. Tarayıcı Network panelinden yüklemeyi doğrulayın. Çapraz origin fetch veya canvas kullanıyorsanız CORS'u ayrıca yapılandırın; yalnız img etiketiyle görünmesi CORS testinin geçtiği anlamına gelmez.

5. Güncelleme ve geri dönüş

Dosya içeriği değişiyorsa sürümlenmiş nesne adı kullanın. Aynı URL'yi değiştiriyorsanız ilgili cache'i purge edin. Eski medya kaynağını tüm linkler doğrulanmadan kaldırmayın. API anahtarlarını public paylaşmayın; public domain nesne okuma içindir, yönetim erişimi değildir.

Metadata yanlışsa belirtiyi ayırın

Nesne adındaki klasör görünümü gerçek sunucu dizini olmak zorunda değildir; /urunler/a.webp anahtarını birebir kullanın. Önce tek nesneyi düzeltip uygulama içindeki yeni URL'yi test edin, sonra toplu taşıyın.