Kılavuzlar

MinIO ve kendi barındırdığınız S3 için dosya yöneticisi: Nubbo'ya bağlayın

MinIO, Ceph veya SeaweedFS gibi kendi S3 uyumlu depolamanızı Nubbo'ya bağlama: endpoint, anahtar, bölge, CORS ve bir sorun çıkarsa yapmanız gerekenler.

Nubbo, Signature V4 ile imzalayan her S3 uyumlu depolamaya bağlanır: kendi sunucunuzdaki veya başka bir sağlayıcıdaki MinIO, Ceph ya da SeaweedFS gibi. Tek ihtiyacınız endpoint URL’si, bir anahtar ve bölge. 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 sunucunuz 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

S3 uyumlu bir depolamaya 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. Endpoint, hem Nubbo sunucularının hem de tarayıcının ulaşabildiği herkese açık bir URL olmalı ve HTTPS kullanmalıdır, çünkü tarayıcı https://nubbo.app üzerinden HTTP içerik yüklemez. Nubbo özel veya yerel adreslere işaret eden endpoint’leri reddeder. Sunucunuzda bölge yoksa us-east-1 olarak bırakın.

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

Otomatik bağlantı

Adım 1: anahtarı sunucunuzda oluşturun

  1. Sunucunuzun S3 API’sini V4 imzalarıyla herkese açık bir HTTPS URL’sinde sunduğunu kontrol edin, örneğin https://s3.your-domain.com.
  2. Bucket oluşturabilen ve CORS ayarlarını değiştirebilen bir anahtar oluşturun.
  3. Endpoint URL’sini ve bölgeyi not edin. Sunucunuzda bölge yoksa us-east-1 kullanı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. Özel S3 / Kendi barındırılan seçeneğini seçin ve Devam et’e basın.

    Nubbo sihirbazının Sağlayıcı adımında Özel S3 / Kendi barındırılan seçili Nubbo sihirbazının Sağlayıcı adımında Özel S3 / Kendi barındırılan 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 erişim anahtarını, gizli anahtarı, endpoint URL’sini ve bölgeyi yapıştırın. Anahtarı kontrol et’e basın. Nubbo anahtarın çalıştığını ve tüm hesaba erişimi olduğunu kontrol eder.

    Özel S3 / Kendi barındırılan için hızlı kılavuz ve anahtar alanlarıyla Anahtarınız adımı Özel S3 / Kendi barındırılan 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ı sunucunuzda hazırlayın

  1. Bucket’ı sunucunuzda oluşturun (örneğin MinIO’da mc mb ile).
  2. O bucket üzerinde okuma ve yazma izinlerine sahip bir anahtar oluşturun.
  3. Endpoint URL’sini ve bölgeyi not edin.

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

  1. Bucket’lar sayfasında Bucket bağla’ya basın, Özel S3 / Kendi barındırılan seçeneğini ve ardından Sınırlı bir anahtarla seçeneğini seçin.
  2. Erişim anahtarını, gizli anahtarı, endpoint’i ve bölgeyi yapıştırın. 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.

CORS’un nasıl ayarlanacağı yazılıma bağlıdır:

  • MinIO (topluluk sürümü) bucket başına CORS kabul etmez: varsayılan olarak her kaynağa izin veren genel bir ayar (MINIO_API_CORS_ALLOW_ORIGIN) kullanır. Bunu değiştirmediyseniz yapacak bir şey yok: Ekledim, kontrol et’e basın, kontrol başarılı olur. Değiştirdiyseniz https://nubbo.app adresini ekleyin.
  • Ceph ve SeaweedFS S3 API üzerinden bucket başına CORS kabul eder. Bu kuralı alışık olduğunuz araçla uygulayın (örneğin endpoint’inizle aws s3api put-bucket-cors) veya otomatik yolda Nubbo’nun yapmasına izin verin.
[
  {
    "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ı

Kural hazır olduğunda Nubbo’ya dönün ve Ekledim, kontrol et’e basın. Ceph ve SeaweedFS’te anahtarınız CORS’u değiştirebiliyorsa Benim için yapılandırmayı dene bunu sizin yerinize yapar.

Bir sorun çıkarsa

Nubbo’daki mesajNe yapmalı
“Kimlik bilgileri geçersiz. Erişim anahtarını ve gizli erişim anahtarını kontrol edin.”İki anahtarı da başında veya sonunda boşluk olmadan yeniden kopyalayın.
“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.
“Bucket bulunamadı. Adı ve bölgeyi doğrulayın.”Bucket’ın tam adını ve seçilen bölgenin bucket’ın bölgesi olduğunu kontrol edin.
“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ı.
“S3 uç noktasına ulaşılamadı. Uç nokta URL’sini doğrulayın.”URL’nin herkese açık olduğunu, HTTPS kullandığını ve yalnızca ağınızdan değil internetten de yanıt verdiğini kontrol edin.
“Uç nokta URL’si geçerli değil. Biçimi kontrol edin.”URL’yi https:// ile ve bucket adı olmadan eksiksiz yazın. Bu mesaj URL özel veya yerel bir adrese işaret ettiğinde ya da ad çözümlenemediğinde de görünür.
“Bağlantı zaman aşımına uğradı. Tekrar deneyin.”Sunucunuzun güvenlik duvarını ve portun dışarıdan erişilebilir olduğunu kontrol edin.

Maliyeti ne kadar

Kendi depolamanızı bir sağlayıcıyla karşılaştırıyorsanız fiyatları ve sınırları S3, R2, Spaces, Wasabi ve Backblaze B2 karşılaştırması makalesinde inceleyin.

Sıkça sorulan sorular

Nubbo hangi kendi barındırılan depolamalarla çalışır?

MinIO, Ceph veya SeaweedFS gibi V4 imzalı S3 API ile uyumlu her depolama ve listede olmayan S3 uyumlu sağlayıcılar.

Yerel ağımdaki bir MinIO'yu bağlayabilir miyim?

Hayır. Endpoint herkese açık bir URL olmalıdır: Nubbo özel ve yerel adresleri reddeder ve tarayıcının da ona ulaşabilmesi gerekir.

Sunucumda bölge yoksa hangi bölgeyi kullanırım?

us-east-1. S3 uyumlu sunucuların çoğunun varsayılan bölgesidir.

Nubbo MinIO'da neden CORS ayarlayamıyor?

Çünkü MinIO topluluk sürümü bucket başına CORS desteklemez. Varsayılan olarak her kaynağa izin veren genel bir ayar kullanır ve Nubbo bunu kontrol eder.

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.