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.
| Automatycznie | Z ograniczonym kluczem | |
|---|---|---|
| Klucz | Dostęp do całego konta | Ograniczony do jednego bucketu |
| Bucket | Nubbo używa jednego z twoich lub tworzy nowy | Najpierw tworzysz go sam |
| CORS | Nubbo dodaje regułę za ciebie | Regułę dodajesz sam |
| Kiedy ją wybrać | Najszybsza droga | Gdy nie chcesz dawać dostępu do całego konta |
Połączenie automatyczne
Krok 1: utwórz klucz w Backblaze B2
- 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).
- Nadaj mu nazwę, ustaw Allow Access to Bucket(s) na All, a Type of Access na Read and Write. Naciśnij Create New Key.
- Skopiuj keyID (access key) i applicationKey (secret). Backblaze pokazuje applicationKey tylko raz.
- W Buckets sprawdź endpoint dowolnego bucketu, aby poznać swój region.
Krok 2: połącz bucket w Nubbo
W Nubbo otwórz Buckety i naciśnij Połącz bucket. Wybierz Backblaze B2 i naciśnij Dalej.

Wybierz Automatycznie i naciśnij Dalej.

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.

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.

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.

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
- W Buckets naciśnij Create a Bucket, nadaj mu nazwę i pozostaw go jako Private.
- W buckecie otwórz Lifecycle Settings i wybierz Keep only the last version of the file.
- Sprawdź endpoint bucketu, aby poznać region.
- 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.
- Skopiuj keyID i applicationKey.
Krok 2: połącz bucket w Nubbo
- W sekcji Buckety naciśnij Połącz bucket, wybierz Backblaze B2, a potem Z ograniczonym kluczem.
- Wklej keyID i applicationKey i wybierz region. Naciśnij Sprawdź klucz.
- Wpisz dokładną nazwę bucketu i naciśnij Sprawdź dostęp.
- 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.
- Zainstaluj CLI, na przykład poleceniem
pip install b2. - Zaloguj się swoim keyID i applicationKey:
b2 account authorize. - Zastosuj regułę, zastępując
your-bucketnazwą bucketu.allPrivateutrzymuje 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

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 Nubbo | Co 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.