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
Bir bucket oluştur
Cloudflare panelinde R2 Object Storage'ı aç ve Create bucket'a tıkla.
screenshotsgibi kısa bir ad seç ve konumu otomatik bırak. - 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
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
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
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 |
|---|---|
| Provider | Cloudflare R2 |
| Profile Name | Personalİstediğin herhangi bir ad. |
| Account ID | 3f9a71c0e2b8…R2 genel bakış sayfasından. |
| Region | autoVarsayılanı koru. |
| Access Key ID | a1b2c3d4…R2 API token'ından. |
| Secret Access Key | ••••••••macOS Anahtar Zinciri'nde saklanır. |
| Bucket | screenshots |
| Public Base URL | files.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.