Kılavuzlar

Cloudflare R2 için dosya yöneticisi: Nubbo'ya bağlayın

Bir Cloudflare R2 bucket'ını Nubbo'ya bağlama: API token, Account ID, adım adım sihirbaz, CORS kuralı ve bir sorun çıkarsa yapmanız gerekenler.

Nubbo, Cloudflare R2’ye bir R2 API token’ı ve hesabınızın Account ID’si ile bağlanır. Birkaç dakika içinde bucket’larınız doğrudan yüklemeler, paylaşım bağlantıları ve galerilerle bir dosya gezgininde olur. Bu kılavuz Nubbo sihirbazını adım adım, iki yoluyla birlikte izler: otomatik veya tek bir bucket ile sınırlı bir anahtarla.

Neler elde edersiniz

  • Bucket’a bir sürücü gibi göz atın: klasörler, görünümler, arama, çöp kutusu, etiketler ve favoriler.
  • Dosyaları doğrudan tarayıcınız ile Cloudflare R2 arasında yükleyin ve indirin. Dosyalar asla Nubbo sunucularından geçmez.
  • Dosya ve klasörleri şifre, son kullanma tarihi ve indirme sınırıyla paylaşın, bucket’ınıza dosya alın ve galeriler oluşturun.
  • Anahtarlarınız AES-256-GCM ile şifrelenmiş olarak saklanır ve bucket’ın bağlantısını istediğiniz zaman kesebilirsiniz.

Başlamadan önce

Bir Cloudflare R2 hesabına ve bir Nubbo hesabına ihtiyacınız var. Bağladığınız her bucket plan sınırınıza dahil edilir: Ücretsiz plan 2, Personal 5 bucket’a izin verir, Pro’da sınır yoktur. İlk bucket’ınızdan önce Cloudflare, R2 aboneliğini kontrol panelinden etkinleştirmenizi ister. Bucket’ınızın bir yargı bölgesi varsa (EU, FedRAMP veya US), bunu sihirbazda seçersiniz ve Nubbo o yargı bölgesinin uç noktasını kullanır.

Bağlantı şeklini seçin

Nubbo sihirbazı iki yol sunar. İkisi de aynı şekilde sonuçlanır: bucket bağlanmış ve tarayıcıdan yüklemelere hazır olur.

OtomatikSınırlı bir anahtarla
AnahtarTüm hesaba erişimTek bir bucket ile sınırlı
BucketNubbo sizinkilerden birini kullanır veya yeni bir tane oluştururÖnce siz oluşturursunuz
CORSNubbo kuralı sizin için eklerKuralı siz eklersiniz
Ne zaman seçilmeliEn hızlı yolTüm hesaba erişim vermek istemediğinizde

Sınırlı anahtar, Nubbo’nun ihtiyaç duyduğu en az erişimdir: tek bir bucket üzerinde Object Read & Write. Bununla Nubbo bucket’larınızı listeleyemez veya yeni bir tane oluşturamaz; bu yüzden bucket adını yazar ve CORS kuralını kendiniz eklersiniz.

Otomatik bağlantı

Adım 1: anahtarı Cloudflare R2’de oluşturun

  1. dash.cloudflare.com adresinde oturum açın ve R2 object storage bölümünü açın. Panel menüleri sizin dilinizde gösterebilir.
  2. API Tokens bölümünü açın ve Create Account API token düğmesine basın. Buraya Overview içinden, Account Details, Manage altından da ulaşabilirsiniz.
  3. Admin Read & Write iznini seçin ve token’ı oluşturun.
  4. Access Key ID ve Secret Access Key’i kopyalayın. Cloudflare gizli anahtarı yalnızca bir kez gösterir. Token değerini değil, bu iki anahtarı kullanın.
  5. R2 Overview sayfasında gösterilen Account ID’nizi de kopyalayın.

Adım 2: bucket’ı Nubbo’ya bağlayın

  1. Nubbo’da Bucket’lar sayfasını açın ve Bucket bağla’ya basın. Cloudflare R2’yi seçin ve Devam et’e basın.

    Nubbo sihirbazının Sağlayıcı adımında Cloudflare R2 seçili Nubbo sihirbazının Sağlayıcı adımında Cloudflare R2 seçili
  2. Otomatik seçeneğini seçin ve Devam et’e basın.

    Otomatik ve Sınırlı bir anahtarla seçeneklerini gösteren Bağlantı şekli adımı Otomatik ve Sınırlı bir anahtarla seçeneklerini gösteren Bağlantı şekli adımı
  3. Anahtarınız adımında Access Key ID, Secret Access Key ve Account ID’yi yapıştırın. Nubbo hesabınızın endpoint’ini Account ID’den oluşturur. R2 bölgesi her zaman auto’dur. Anahtarı kontrol et düğmesine basmadan önce bucket’ınızın Yargı bölgesi değerini seçin: çoğu bucket için Varsayılan (yargı bölgesi yok), ya da EU, FedRAMP veya US. Uç nokta onunla birlikte değişir (AB için https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com) ve liste yalnızca o yargı bölgesindeki bucket’ları gösterir. Anahtarı kontrol et’e basın. Nubbo anahtarın çalıştığını ve tüm hesaba erişimi olduğunu kontrol eder.

    Cloudflare R2 için hızlı kılavuz ve anahtar alanlarıyla Anahtarınız adımı Cloudflare R2 için hızlı kılavuz ve anahtar alanlarıyla Anahtarınız adımı
  4. Bucket’larınızdan birini seçip Bu bucket’ı kullan’a basın ya da Yeni oluştur’u seçin, bir ad yazın (istenirse bölgeyi de seçin) ve Oluştur ve hazırla’ya basın. Nubbo bucket’a yalnızca uygulamadan yükleme ve indirmeye izin veren bir CORS kuralı ekler ve mevcut kuralları korur.

    Bucket listesi ve Yeni oluştur seçeneğiyle Bucket'ınız adımı Bucket listesi ve Yeni oluştur seçeneğiyle Bucket'ınız adımı
  5. Üç kontrolü gözden geçirin, isterseniz Nubbo’daki ad’ı değiştirin ve Bitir’e basın. Bucket, Bucket’lar sayfasında görünür ve onu gezginde açabilirsiniz.

    Bağlantı, bucket ve CORS kontrolleriyle Bitti adımı Bağlantı, bucket ve CORS kontrolleriyle Bitti adımı

Nubbo anahtarınızla CORS kuralını ekleyemezse sihirbaz sizi CORS adımına götürür. Bu durumda CORS kuralını ekleyin bölümünü izleyin.

Sınırlı bir anahtarla bağlantı

Adım 1: bucket’ı ve anahtarı Cloudflare R2’de hazırlayın

  1. R2, Overview bölümünde Create bucket’a basın ve bir ad verin (küçük harf, rakam ve tire). Seçilecek bir bölge yoktur. Veriler AB’de kalmalıysa EU yargı bölgesini seçin: uç nokta onunla birlikte değişir.
  2. API Tokens bölümünü açın ve Create Account API token düğmesine basın.
  3. Object Read & Write iznini seçin ve bucket’ınızla sınırlayın.
  4. Access Key ID, Secret Access Key ve Account ID’nizi kopyalayın.

Adım 2: bucket’ı Nubbo’ya bağlayın

  1. Bucket’lar sayfasında Bucket bağla’ya basın, Cloudflare R2’yi ve ardından Sınırlı bir anahtarla seçeneğini seçin.
  2. Access Key ID, Secret Access Key ve Account ID’yi yapıştırın. Anahtarı kontrol et düğmesine basmadan önce bucket ile aynı Yargı bölgesi değerini seçin. Anahtarı kontrol et’e basın.
  3. Bucket’ın tam adını yazın ve Erişimi kontrol et’e basın.
  4. Sihirbaz, eklemeniz gereken kuralla birlikte CORS adımına geçer.

CORS kuralını ekleyin

CORS kuralı, tarayıcının https://nubbo.app üzerinde bucket’ınıza dosya yüklemesine ve oradan dosya indirmesine izin verir. Sihirbazın CORS adımında gösterdiği kuralın aynısıdır.

  1. R2’de bucket’ı açın ve Settings’e gidin.
  2. CORS Policy altında Add CORS policy’ye basın ve JSON sekmesini seçin.
  3. Kuralı yapıştırın ve Save’e basın. Cloudflare’in kuralı uygulaması 30 saniyeyi bulabilir.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Bucket'a eklenecek kuralla CORS adımı Bucket'a eklenecek kuralla CORS adımı

Kaydettikten sonra Nubbo’ya dönün ve Ekledim, kontrol et’e basın. Anahtarınızın CORS’u değiştirme izni varsa Benim için yapılandırmayı dene bunu sizin yerinize yapar.

Bir sorun çıkarsa

Nubbo’daki mesajNe yapmalı
“Bu anahtar tek bir bucket ile sınırlı görünüyor. Sınırlı yoldan devam edebilir veya tam erişimli bir anahtar oluşturabilirsiniz.”Sınırlı anahtarla devam et’e basın veya tüm hesaba erişimi olan bir anahtar oluşturup Başka bir anahtar dene’ye basın.
“Anahtarınızın bucket oluşturma izni yok.”Tam erişimli bir anahtar kullanın veya bucket’ı panelinizde oluşturup Panelimde oluşturdum’a basın.
“Bu ad bu sağlayıcıda zaten kullanılıyor; başka bir ad deneyin.”Bucket adları sağlayıcının tamamında benzersizdir: başka bir ad seçin.
“Anahtarınızın bunu ayarlama izni yok.”CORS kuralını yukarıda açıklandığı gibi elle ekleyin.
“Henüz çalışmıyor. Kuralı gözden geçirip tekrar kontrol edin; bazı sağlayıcıların kuralı uygulaması bir dakika sürer.”Kaynağın sonunda eğik çizgi olmadan tam olarak https://nubbo.app olduğunu kontrol edin, bir dakika bekleyin ve tekrar kontrol edin.
“Bu bucket zaten kullanımda.”Bu bucket Nubbo’da sizin hesabınızda veya başka bir hesapta zaten bağlı.
“Kimlik bilgileri geçersiz. Erişim anahtarını ve gizli erişim anahtarını kontrol edin.”Cloudflare API token değerini değil, token’ın Access Key ID ve Secret Access Key değerlerini yapıştırdığınızı kontrol edin.
“Bucket bulunamadı. Adı ve bölgeyi doğrulayın.”Adı ve Nubbo’daki yargı bölgesinin bucket’ınkiyle aynı olup olmadığını kontrol edin (R2 bunu bucket’ın Settings bölümünde gösterir).

Maliyeti ne kadar

R2 çıkış için ücret almaz ve aylık bir ücretsiz katmanı vardır. Bunu Cloudflare R2 ücretsiz katmanı makalesinde açıklıyoruz.

Sıkça sorulan sorular

Cloudflare Account ID'mi nerede bulurum?

R2 Overview sayfasında, Account Details altında. Rakamlardan ve a ile f arasındaki harflerden oluşan 32 karakterlik bir dizedir.

R2 token'ının hangi izne ihtiyacı var?

Nubbo'nun ihtiyaç duyduğu en az erişim, sınırlı anahtar yoluyla bucket'ınızla sınırlı Object Read & Write'tır: bucket adını yazar ve CORS kuralını kendiniz eklersiniz. Otomatik yol Admin Read & Write gerektirir; Nubbo bununla bucket'larınızı listeler, yeni bir tane oluşturur ve CORS'unu ayarlar.

R2 ile hangi bölgeyi kullanırım?

Hiçbirini: R2 auto bölgesini kullanır ve Nubbo bunu sizin için ayarlar. Cloudflare konum ipuçları bucket'ın bağlanma şeklini değiştirmez.

AB gibi bir yargı bölgesine sahip R2 bucket bağlayabilir miyim?

Evet. Anahtarınız adımında bucket'ın yargı bölgesini seçin (EU, FedRAMP veya US). Her birinin https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com gibi kendi uç noktası vardır ve yalnızca içinde oluşturulan bucket'ları gösterir.

Nubbo'dan indirmeler R2'de çıkış ücreti doğurur mu?

Hayır. R2 dışarı veri aktarımı için ücret almaz. İndirmeler ise okuma işlemi olarak sayılır.

Kaynaklar

Fiyatlar ve sınırlar aşağıdaki resmi sayfalardan alınmıştır. Sağlayıcılar bunları değiştirebilir, karar vermeden önce kontrol edin.