Ръководства

Файлов мениджър за Backblaze B2: свържете го с Nubbo

Как да свържете bucket в Backblaze B2 с Nubbo: ключът за приложение, регионът, съветникът стъпка по стъпка, CORS с B2 CLI и какво да правите при грешка.

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
BucketNubbo използва ваш или създава новВие го създавате първо
CORSNubbo добавя правилото вместо васВие добавяте правилото
Кога да го изберетеНай-бързият начинКогато не искате да давате достъп до целия акаунт

Автоматично свързване

Стъпка 1: създайте ключа в Backblaze B2

  1. В backblaze.com отворете B2 Cloud Storage, Application Keys и натиснете Add a New Application Key. Не използвайте master application key.
  2. Дайте му име, задайте Allow Access to Bucket(s) на All и Type of Access на Read and Write. Натиснете Create New Key.
  3. Копирайте keyID (access key) и applicationKey (secret). Backblaze показва applicationKey само веднъж.
  4. В Buckets вижте endpoint-а на който и да е bucket, за да разберете региона си.

Стъпка 2: свържете bucket-а в Nubbo

  1. В Nubbo отворете Bucket-и и натиснете Свързване на bucket. Изберете Backblaze B2 и натиснете Продължи.

    Стъпката Доставчик в съветника на Nubbo с избран Backblaze B2 Стъпката Доставчик в съветника на Nubbo с избран Backblaze B2
  2. Изберете Автоматично и натиснете Продължи.

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

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

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

    Стъпката Готово с проверките на връзката, bucket-а и CORS Стъпката Готово с проверките на връзката, bucket-а и CORS

След това в bucket-а отворете Lifecycle Settings и изберете Keep only the last version of the file. В противен случай B2 пази всяка версия и изтриването от Nubbo не освобождава място.

Ако Nubbo не може да добави CORS правилото с вашия ключ, съветникът ви отвежда към стъпката CORS. Тогава следвайте Добавете CORS правилото.

Свързване с ограничен ключ

Стъпка 1: подгответе bucket-а и ключа в Backblaze B2

  1. В Buckets натиснете Create a Bucket, дайте му име и го оставете Private.
  2. В bucket-а отворете Lifecycle Settings и изберете Keep only the last version of the file.
  3. Вижте endpoint-а на bucket-а, за да разберете региона.
  4. В Application Keys натиснете Add a New Application Key, ограничете достъпа до вашия bucket с Read and Write и отметнете Allow List All Bucket Names. Натиснете Create New Key.
  5. Копирайте keyID и applicationKey.

Стъпка 2: свържете bucket-а в Nubbo

  1. В Bucket-и натиснете Свързване на bucket, изберете Backblaze B2 и след това С ограничен ключ.
  2. Поставете keyID и applicationKey и изберете региона. Натиснете Провери ключа.
  3. Въведете точното име на bucket-а и натиснете Провери достъпа.
  4. Съветникът преминава към стъпката CORS с правилото, което трябва да добавите.

Добавете CORS правилото

CORS правилото позволява на браузъра да качва и изтегля файлове от вашия bucket в https://nubbo.app. Това е същото правило, което съветникът показва в стъпката CORS.

CORS правилата в конзолата на B2 са готови шаблони и не позволяват да изберете операциите, затова правилото на Nubbo се добавя с командния инструмент на B2 (b2), с ключ, който може да променя настройките на bucket-а.

  1. Инсталирайте CLI, например с pip install b2.
  2. Влезте с вашия keyID и applicationKey: b2 account authorize.
  3. Приложете правилото, като замените 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
Стъпката CORS с правилото, което да добавите към bucket-а Стъпката CORS с правилото, което да добавите към bucket-а

След като го приложите, върнете се в 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.

Източници

Цените и ограниченията са взети от официалните страници по-долу. Доставчиците ги променят, затова проверете, преди да се обвържете.