Nubbo се свързва с Backblaze B2 чрез неговия S3-съвместим API, с ключ за приложение и региона на акаунта ви. След няколко минути вашите bucket-и са във файлов мениджър с директно качване, връзки за споделяне и галерии. Това ръководство следва съветника на Nubbo стъпка по стъпка и по двата пътя: автоматично или с ключ, ограничен до един bucket.
Какво получавате
- Разглеждате bucket-а като диск: папки, изгледи, търсене, кошче, етикети и любими.
- Качвате и изтегляте файлове директно между браузъра си и Backblaze B2. Файловете никога не минават през сървърите на Nubbo.
- Споделяте файлове и папки с парола, срок на валидност и лимит на изтеглянията, получавате файлове в bucket-а си и създавате галерии.
- Ключовете ви се съхраняват криптирани с AES-256-GCM и можете да изключите bucket-а по всяко време.
Преди да започнете
Нужни са ви акаунт в Backblaze B2 и акаунт в Nubbo. Всеки свързан bucket се брои към лимита на вашия план: Безплатният план позволява 2, Personal 5, а Pro няма ограничение. В B2 регионът се избира при създаването на акаунта и важи за всички негови bucket-и. Виждате го в endpoint-а на всеки bucket, във вида s3.<region>.backblazeb2.com: това е регионът, който да изберете в Nubbo. Главният ключ на акаунта не работи с S3 API, затова винаги създавайте ключ за приложение.
Изберете как да се свържете
Съветникът на Nubbo предлага два пътя. И двата завършват по един и същ начин: bucket-ът е свързан и готов за качване от браузъра.
| Автоматично | С ограничен ключ | |
|---|---|---|
| Ключ | Достъп до целия акаунт | Ограничен до един bucket |
| Bucket | Nubbo използва ваш или създава нов | Вие го създавате първо |
| CORS | Nubbo добавя правилото вместо вас | Вие добавяте правилото |
| Кога да го изберете | Най-бързият начин | Когато не искате да давате достъп до целия акаунт |
Автоматично свързване
Стъпка 1: създайте ключа в Backblaze B2
- В backblaze.com отворете B2 Cloud Storage, Application Keys и натиснете Add a New Application Key. Не използвайте master application key.
- Дайте му име, задайте Allow Access to Bucket(s) на All и Type of Access на Read and Write. Натиснете Create New Key.
- Копирайте keyID (access key) и applicationKey (secret). Backblaze показва applicationKey само веднъж.
- В Buckets вижте endpoint-а на който и да е bucket, за да разберете региона си.
Стъпка 2: свържете bucket-а в Nubbo
В Nubbo отворете Bucket-и и натиснете Свързване на bucket. Изберете Backblaze B2 и натиснете Продължи.

Изберете Автоматично и натиснете Продължи.

В стъпката Вашият ключ поставете keyID и applicationKey и изберете региона на акаунта си. Натиснете Провери ключа. Nubbo проверява, че ключът работи и че има достъп до целия акаунт.

Изберете някой от вашите bucket-и и натиснете Използвай този bucket или изберете Създай нов, въведете име (и изберете региона, ако бъде поискан) и натиснете Създай и подготви. Nubbo добавя към bucket-а CORS правило, което разрешава качвания и изтегляния само от приложението, и запазва правилата, които вече има.

Прегледайте трите проверки, променете Име в Nubbo, ако желаете, и натиснете Завърши. Bucket-ът се появява в Bucket-и и можете да го отворите във файловия мениджър.

След това в bucket-а отворете Lifecycle Settings и изберете Keep only the last version of the file. В противен случай B2 пази всяка версия и изтриването от Nubbo не освобождава място.
Ако Nubbo не може да добави CORS правилото с вашия ключ, съветникът ви отвежда към стъпката CORS. Тогава следвайте Добавете CORS правилото.
Свързване с ограничен ключ
Стъпка 1: подгответе bucket-а и ключа в Backblaze B2
- В Buckets натиснете Create a Bucket, дайте му име и го оставете Private.
- В bucket-а отворете Lifecycle Settings и изберете Keep only the last version of the file.
- Вижте endpoint-а на bucket-а, за да разберете региона.
- В Application Keys натиснете Add a New Application Key, ограничете достъпа до вашия bucket с Read and Write и отметнете Allow List All Bucket Names. Натиснете Create New Key.
- Копирайте keyID и applicationKey.
Стъпка 2: свържете bucket-а в Nubbo
- В Bucket-и натиснете Свързване на bucket, изберете Backblaze B2 и след това С ограничен ключ.
- Поставете keyID и applicationKey и изберете региона. Натиснете Провери ключа.
- Въведете точното име на bucket-а и натиснете Провери достъпа.
- Съветникът преминава към стъпката CORS с правилото, което трябва да добавите.
Добавете CORS правилото
CORS правилото позволява на браузъра да качва и изтегля файлове от вашия bucket в https://nubbo.app. Това е същото правило, което съветникът показва в стъпката CORS.
CORS правилата в конзолата на B2 са готови шаблони и не позволяват да изберете операциите, затова правилото на Nubbo се добавя с командния инструмент на B2 (b2), с ключ, който може да променя настройките на bucket-а.
- Инсталирайте CLI, например с
pip install b2. - Влезте с вашия keyID и applicationKey:
b2 account authorize. - Приложете правилото, като замените
your-bucketс името на bucket-а.allPrivateоставя bucket-а частен.
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

След като го приложите, върнете се в Nubbo и натиснете Добавено е, провери. Ако ключът ви има право да променя CORS, Опитай да го конфигурираш вместо мен ще го направи вместо вас.
Ако нещо се обърка
| Съобщение в Nubbo | Какво да направите |
|---|---|
| „Този ключ изглежда ограничен до един bucket. Можете да продължите по ограничения път или да създадете ключ с пълен достъп.“ | Натиснете Продължи с ограничен ключ или създайте ключ с достъп до целия акаунт и натиснете Опитай друг ключ. |
| „Bucket не е намерен. Проверете името и региона.“ | Проверете точното име на bucket-а и дали избраният регион е този на bucket-а. |
| „Вашият ключ няма право да създава bucket-и.“ | Използвайте ключ с пълен достъп или създайте bucket-а в панела си и натиснете Вече е създаден в моя панел. |
| „Това име вече се използва при този доставчик; опитайте с друго.“ | Имената на bucket-ите са уникални в рамките на доставчика: изберете друго. |
| „Вашият ключ няма право да го настрои.“ | Добавете CORS правилото ръчно, както е обяснено по-горе. |
| „Все още не работи. Прегледайте правилото и проверете отново; при някои доставчици прилагането му отнема около минута.“ | Проверете дали произходът е точно https://nubbo.app без наклонена черта в края, изчакайте минута и проверете отново. |
| „Този bucket вече се използва.“ | Този bucket вече е свързан в Nubbo, във вашия акаунт или в друг. |
| „Невалидни идентификационни данни. Проверете ключа за достъп и тайния ключ за достъп.“ | Проверете дали не използвате master application key, който не работи с S3 API. |
| „Bucket се намира в друг регион. Проверете конфигурирания регион.“ | Изберете в Nubbo региона, който се вижда в endpoint-а на bucket-а. |
Колко струва
Backblaze B2 таксува на TB, с 10 GB безплатно и безплатен изходящ трафик до три пъти обема, който съхранявате. Обясняваме го в Цени на Backblaze B2.
Често задавани въпроси
Мога ли да използвам master application key на Backblaze?
Не. Backblaze не поддържа главния ключ в своя S3-съвместим API. Създайте ключ за приложение в Application Keys.
Кой регион да избера в Nubbo за B2?
Този от endpoint-а на вашите bucket-и, във вида s3.<region>.backblazeb2.com. В B2 всички bucket-и на един акаунт са в един и същ регион.
Защо CORS се настройва с B2 CLI?
Защото правилата в конзолата са готови шаблони и не позволяват да изберете операциите, от които Nubbo се нуждае. CLI е най-простият начин да приложите точното правило; работи и всеки S3 инструмент, който изпълнява PutBucketCors към endpoint-а на B2.
Защо изтриването в Nubbo не освобождава място в B2?
Защото B2 по подразбиране пази предишните версии. В Lifecycle Settings на bucket-а изберете Keep only the last version of the file.
Източници
Цените и ограниченията са взети от официалните страници по-долу. Доставчиците ги променят, затова проверете, преди да се обвържете.