Файловый менеджер для Backblaze B2: подключите его к Nubbo

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. Главный ключ аккаунта не работает с API S3, поэтому всегда создавайте ключ приложения.

Выберите способ подключения

Мастер Nubbo предлагает два пути. Оба заканчиваются одинаково: bucket подключён и готов к загрузкам из браузера.

Автоматическое подключение

Шаг 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 откройте раздел Buckets и нажмите Подключить bucket. Выберите Backblaze B2 и нажмите Продолжить.

   

2. Выберите Автоматически и нажмите Продолжить.

   

3. На шаге Ваш ключ вставьте keyID и applicationKey и выберите регион своего аккаунта. Нажмите Проверить ключ. Nubbo проверит, что ключ работает и что у него есть доступ ко всему аккаунту.

   

4. Выберите один из своих bucket и нажмите Использовать этот bucket или выберите Создать новый, введите имя (и выберите регион, если мастер его спросит) и нажмите Создать и подготовить. Nubbo добавит в bucket правило CORS, которое разрешает загрузку и скачивание только из приложения, и сохранит уже существующие правила.

   

5. Просмотрите три проверки, при желании измените Имя в Nubbo и нажмите Завершить. Bucket появится в разделе Buckets, и его можно будет открыть в проводнике.

   

Затем в 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. В разделе Buckets нажмите Подключить 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

Когда правило применено, вернитесь в Nubbo и нажмите Готово, проверить. Если вашему ключу разрешено менять CORS, кнопка Попробовать настроить за меня сделает это за вас.

Если что-то пошло не так

Сколько это стоит

Backblaze B2 берёт плату за каждый ТБ, первые 10 ГБ бесплатны, а исходящий трафик бесплатен в объёме до трёх раз больше хранимого. Мы разбираем это в статье Цены Backblaze B2.