Yaklaşık 5 dakika

Cloudflare R2 ile Aktar nasıl kullanılır

Cloudflare R2, Aktar için harika bir eşleşme: veri çıkışı (egress) ücreti yok, ücretsiz kotası ekran görüntüsü kullanımının çoğunu karşılıyor ve özel alan adları Cloudflare'in ağı üzerinden sunuluyor. Aktar'ın R2 için özel bir hazır ayarı var; yalnızca Account ID'ne, bir API token'a ve bir bucket'a ihtiyacın var.

Neye ihtiyacın var

  • R2'nin etkin olduğu bir Cloudflare hesabı
  • Bağlantıların kendi alan adında olmasını istiyorsan Cloudflare'de bir alan adı (isteğe bağlı)
  • Mac'inde kurulu Aktar

Adım adım

  1. 1

    Bir bucket oluştur

    Cloudflare panelinde R2 Object Storage'ı aç ve Create bucket'a tıkla. screenshots gibi kısa bir ad seç ve konumu otomatik bırak.

  2. 2

    Bucket'a herkese açık bir adres ver

    Bucket'ın Settings sekmesini aç. Custom Domains altında, Cloudflare'de yönettiğin bir alan adını ya da alt alan adını bağla, örneğin files.example.com. Gerçek kullanım için en iyi seçenek budur.

    Hızlı bir deneme için bunun yerine Public Development URL'yi (pub-….r2.dev) etkinleştirebilirsin. Cloudflare bu URL'ye hız sınırı uygular ve canlı kullanım için önermez.

  3. 3

    Bir API token oluştur

    R2 genel bakış sayfasına dönüp Manage API tokens'ı aç ve yalnızca kendi bucket'ınla sınırlı, Object Read & Write izni olan bir token oluştur. Access Key ID ve Secret Access Key değerlerini kopyala: secret yalnızca bir kez gösterilir.

    Account ID'n aynı sayfada görünür; ayrıca S3 uç noktası https://<ACCOUNT_ID>.r2.cloudflarestorage.com'un ilk kısmıdır.

  4. 4

    Hedefi Aktar'a ekle

    Aktar'da Settings → Destinations → Add Destination'ı aç, Cloudflare R2'yi seç ve alanları aşağıdaki tabloya göre doldur. Aktar uç noktayı Account ID'nden türetir.

  5. 5

    Test et ve kaydet

    Test Connection'a tıkla. Aktar küçük bir test dosyası yükler, herkese açık adresin üzerinden erişilebildiğini kontrol eder ve dosyayı yeniden siler. Her şey yeşil olduğunda Save'e tıkla ve ilk dosyanı menü çubuğu simgesine bırak.

Aktar ayarları

Bu değerleri Settings → Destinations → Add Destination bölümüne gir. Alan adları uygulamadakiyle aynıdır.

AlanÖrnek değer
ProviderCloudflare R2
Profile NamePersonalİstediğin herhangi bir ad.
Account ID3f9a71c0e2b8…R2 genel bakış sayfasından.
RegionautoVarsayılanı koru.
Access Key IDa1b2c3d4…R2 API token'ından.
Secret Access Key••••••••macOS Anahtar Zinciri'nde saklanır.
Bucketscreenshots
Public Base URLfiles.example.comÖzel alan adın ya da r2.dev URL'si.
Object Path{year}/{month}/{uuid}.{ext}İsteğe bağlı, dosya adları ve klasörlere bak.

İpuçları

  • API token'ı Aktar'ın kullandığı tek bir bucket'la sınırla. Token bir gün sızsa bile başka hiçbir şey açığa çıkmaz.
  • Özel alan adı Cloudflare tarafından önbelleğe alınır, böylece çok açılan bağlantılar ek maliyet olmadan dünyanın her yerinde hızlı yüklenir.
  • Düzenli klasörler mi istiyorsun? Nesne yolunu değiştir, örneğin shots/{date}/{filename}-{random}.{ext} yap. Bkz. dosya adları ve klasörler.

Sorun giderme

Bağlantı Access Denied ya da 403 döndürüyor

Public Base URL'nin özel alan adın ya da r2.dev URL'si olduğundan emin ol. …r2.cloudflarestorage.com uç noktası yalnızca API içindir ve hiçbir zaman herkese açık dosya sunmaz. Ayrıntılar Access Denied hataları sayfasında.

Test Connection kimlik bilgilerinin geçersiz olduğunu söylüyor

Normal bir Cloudflare API token'ı ya da Global API Key değil, R2 API token'ının Access Key ID ve Secret Access Key değerlerini kullan. Account ID'de fazladan boşluk olmadığını kontrol et.

Yüklemeler çalışıyor ama bağlantılar yavaş ya da hız sınırına takılıyor

Büyük ihtimalle r2.dev geliştirme URL'sini kullanıyorsun. Canlı kullanım için özel bir alan adı bağla.

Hâlâ takıldın mı?SSS'ye göz at ya da GitHub'da sor.