Poradniki

Menedżer plików dla Backblaze B2: połącz go z Nubbo

Jak połączyć bucket Backblaze B2 z Nubbo: klucz aplikacji, region, kreator krok po kroku, CORS przez B2 CLI i co zrobić, gdy coś zawiedzie.

Nubbo łączy się z Backblaze B2 przez jego API zgodne z S3, za pomocą klucza aplikacji i regionu twojego konta. W kilka minut twoje buckety trafiają do eksploratora plików z bezpośrednim przesyłaniem, linkami udostępniającymi i galeriami. Ten poradnik prowadzi krok po kroku przez kreator Nubbo, obiema ścieżkami: automatyczną lub z kluczem ograniczonym do jednego bucketu.

Co zyskujesz

  • Przeglądasz bucket jak dysk: foldery, widoki, wyszukiwanie, kosz, etykiety i ulubione.
  • Przesyłasz i pobierasz pliki bezpośrednio między przeglądarką a Backblaze B2. Pliki nigdy nie przechodzą przez serwery Nubbo.
  • Udostępniasz pliki i foldery z hasłem, datą wygaśnięcia i limitem pobrań, odbierasz pliki do swojego bucketu i tworzysz galerie.
  • Twoje klucze są przechowywane w postaci zaszyfrowanej algorytmem AES-256-GCM, a bucket możesz odłączyć w każdej chwili.

Zanim zaczniesz

Potrzebujesz konta w Backblaze B2 i konta w Nubbo. Każdy połączony bucket wlicza się do limitu twojego planu: plan Bezpłatny pozwala na 2, Personal na 5, a Pro nie ma limitu. W B2 region wybiera się przy zakładaniu konta i dotyczy on wszystkich jego bucketów. Widać go w endpoincie dowolnego bucketu, w postaci s3.<region>.backblazeb2.com: to region, który należy wybrać w Nubbo. Główny klucz konta nie działa z API S3, więc zawsze twórz klucz aplikacji.

Wybierz sposób połączenia

Kreator Nubbo oferuje dwie ścieżki. Obie kończą się tak samo: bucket jest połączony i gotowy do przesyłania z przeglądarki.

AutomatycznieZ ograniczonym kluczem
KluczDostęp do całego kontaOgraniczony do jednego bucketu
BucketNubbo używa jednego z twoich lub tworzy nowyNajpierw tworzysz go sam
CORSNubbo dodaje regułę za ciebieRegułę dodajesz sam
Kiedy ją wybraćNajszybsza drogaGdy nie chcesz dawać dostępu do całego konta

Połączenie automatyczne

Krok 1: utwórz klucz w Backblaze B2

  1. Na backblaze.com otwórz B2 Cloud Storage, Application Keys i naciśnij Add a New Application Key. Nie używaj głównego klucza aplikacji (master application key).
  2. Nadaj mu nazwę, ustaw Allow Access to Bucket(s) na All, a Type of Access na Read and Write. Naciśnij Create New Key.
  3. Skopiuj keyID (access key) i applicationKey (secret). Backblaze pokazuje applicationKey tylko raz.
  4. W Buckets sprawdź endpoint dowolnego bucketu, aby poznać swój region.

Krok 2: połącz bucket w Nubbo

  1. W Nubbo otwórz Buckety i naciśnij Połącz bucket. Wybierz Backblaze B2 i naciśnij Dalej.

    Krok Dostawca w kreatorze Nubbo z wybranym Backblaze B2 Krok Dostawca w kreatorze Nubbo z wybranym Backblaze B2
  2. Wybierz Automatycznie i naciśnij Dalej.

    Krok Sposób połączenia z opcjami Automatycznie i Z ograniczonym kluczem Krok Sposób połączenia z opcjami Automatycznie i Z ograniczonym kluczem
  3. W kroku Twój klucz wklej keyID i applicationKey i wybierz region swojego konta. Naciśnij Sprawdź klucz. Nubbo sprawdza, czy klucz działa i czy ma dostęp do całego konta.

    Krok Twój klucz dla Backblaze B2 ze skróconym przewodnikiem i polami klucza Krok Twój klucz dla Backblaze B2 ze skróconym przewodnikiem i polami klucza
  4. Wybierz jeden ze swoich bucketów i naciśnij Użyj tego bucketu albo zaznacz Utwórz nowy, wpisz nazwę (i wybierz region, jeśli o niego poprosi) i naciśnij Utwórz i przygotuj. Nubbo dodaje do bucketu regułę CORS, która pozwala na przesyłanie i pobieranie tylko z aplikacji, i zachowuje reguły, które bucket już ma.

    Krok Twój bucket z listą bucketów i opcją Utwórz nowy Krok Twój bucket z listą bucketów i opcją Utwórz nowy
  5. Przejrzyj trzy weryfikacje, jeśli chcesz, zmień pole Nazwa w Nubbo i naciśnij Zakończ. Bucket pojawi się w sekcji Buckety i możesz go otworzyć w eksploratorze.

    Krok Gotowe z weryfikacją połączenia, bucketu i CORS Krok Gotowe z weryfikacją połączenia, bucketu i CORS

Następnie w buckecie otwórz Lifecycle Settings i wybierz Keep only the last version of the file. W przeciwnym razie B2 zachowuje każdą wersję, a usuwanie z Nubbo nie zwalnia miejsca.

Jeśli Nubbo nie może dodać reguły CORS twoim kluczem, kreator przeniesie cię do kroku CORS. Wtedy postępuj według sekcji Dodaj regułę CORS.

Połączenie z ograniczonym kluczem

Krok 1: przygotuj bucket i klucz w Backblaze B2

  1. W Buckets naciśnij Create a Bucket, nadaj mu nazwę i pozostaw go jako Private.
  2. W buckecie otwórz Lifecycle Settings i wybierz Keep only the last version of the file.
  3. Sprawdź endpoint bucketu, aby poznać region.
  4. W Application Keys naciśnij Add a New Application Key, ogranicz dostęp do swojego bucketu z uprawnieniem Read and Write i zaznacz Allow List All Bucket Names. Naciśnij Create New Key.
  5. Skopiuj keyID i applicationKey.

Krok 2: połącz bucket w Nubbo

  1. W sekcji Buckety naciśnij Połącz bucket, wybierz Backblaze B2, a potem Z ograniczonym kluczem.
  2. Wklej keyID i applicationKey i wybierz region. Naciśnij Sprawdź klucz.
  3. Wpisz dokładną nazwę bucketu i naciśnij Sprawdź dostęp.
  4. Kreator przejdzie do kroku CORS z regułą, którą musisz dodać.

Dodaj regułę CORS

Reguła CORS pozwala przeglądarce przesyłać i pobierać pliki z twojego bucketu na https://nubbo.app. To ta sama reguła, którą kreator pokazuje w kroku CORS.

Reguły CORS w konsoli B2 to gotowe ustawienia, które nie pozwalają wybrać operacji, dlatego regułę Nubbo dodaje się narzędziem wiersza poleceń B2 (b2), z kluczem, który może zmieniać ustawienia bucketu.

  1. Zainstaluj CLI, na przykład poleceniem pip install b2.
  2. Zaloguj się swoim keyID i applicationKey: b2 account authorize.
  3. Zastosuj regułę, zastępując your-bucket nazwą bucketu. allPrivate utrzymuje bucket jako prywatny.
b2 bucket update --cors-rules '[{"corsRuleName":"nubbo","allowedOrigins":["https://nubbo.app"],"allowedOperations":["s3_get","s3_head","s3_put","s3_post","s3_delete"],"allowedHeaders":["*"],"exposeHeaders":["etag"],"maxAgeSeconds":3600}]' your-bucket allPrivate
Krok CORS z regułą do dodania do bucketu Krok CORS z regułą do dodania do bucketu

Po zastosowaniu reguły wróć do Nubbo i naciśnij Dodane, sprawdź. Jeśli twój klucz może zmieniać CORS, Spróbuj skonfigurować za mnie zrobi to za ciebie.

Jeśli coś pójdzie nie tak

Komunikat w NubboCo zrobić
„Ten klucz wydaje się ograniczony do jednego bucketu. Możesz kontynuować ścieżką ograniczoną albo utworzyć klucz z pełnym dostępem.”Naciśnij Kontynuuj z ograniczonym kluczem albo utwórz klucz z dostępem do całego konta i naciśnij Wypróbuj inny klucz.
„Nie znaleziono bucketu. Sprawdź nazwę i region.”Sprawdź dokładną nazwę bucketu i czy wybrany region to region bucketu.
„Twój klucz nie ma uprawnień do tworzenia bucketów.”Użyj klucza z pełnym dostępem albo utwórz bucket w swoim panelu i naciśnij Mam go już w swoim panelu.
„Ta nazwa jest już używana u tego dostawcy; spróbuj innej.”Nazwy bucketów są unikalne w obrębie całego dostawcy: wybierz inną.
„Twój klucz nie ma uprawnień, aby to skonfigurować.”Dodaj regułę CORS ręcznie, tak jak opisano powyżej.
„Jeszcze nie działa. Przejrzyj regułę i sprawdź ponownie; niektórzy dostawcy potrzebują minuty, aby ją zastosować.”Sprawdź, czy origin to dokładnie https://nubbo.app bez ukośnika na końcu, odczekaj minutę i sprawdź ponownie.
„Ten bucket jest już używany.”Ten bucket jest już połączony w Nubbo, na twoim koncie lub na innym.
„Nieprawidłowe dane uwierzytelniające. Sprawdź access key i secret access key.”Sprawdź, czy nie używasz głównego klucza aplikacji, który nie działa z API S3.
„Bucket znajduje się w innym regionie. Sprawdź skonfigurowany region.”Wybierz w Nubbo region widoczny w endpoincie bucketu.

Ile to kosztuje

Backblaze B2 pobiera opłatę za TB, z 10 GB za darmo i bezpłatnym transferem wychodzącym do trzykrotności przechowywanych danych. Wyjaśniamy to w artykule Cennik Backblaze B2.

Najczęściej zadawane pytania

Czy mogę użyć głównego klucza aplikacji Backblaze?

Nie. Backblaze nie obsługuje klucza głównego w swoim API zgodnym z S3. Utwórz klucz aplikacji w Application Keys.

Który region wybrać w Nubbo dla B2?

Ten z endpointu twoich bucketów, w postaci s3.<region>.backblazeb2.com. W B2 wszystkie buckety jednego konta są w tym samym regionie.

Dlaczego CORS konfiguruje się przez B2 CLI?

Bo reguły w konsoli to gotowe ustawienia, które nie pozwalają wybrać operacji potrzebnych Nubbo. CLI to najprostszy sposób, aby zastosować dokładnie tę regułę; działa też każde narzędzie S3, które wykonuje PutBucketCors na endpoincie B2.

Dlaczego usuwanie w Nubbo nie zwalnia miejsca w B2?

Bo B2 domyślnie zachowuje poprzednie wersje. W Lifecycle Settings bucketu wybierz Keep only the last version of the file.

Źródła

Ceny i limity pochodzą z poniższych oficjalnych stron. Dostawcy je zmieniają, więc sprawdź je, zanim się zdecydujesz.