Руководства

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

Как подключить bucket Wasabi к Nubbo: ключ доступа, регион, мастер шаг за шагом, CORS, который Wasabi уже разрешает, и что делать при ошибке.

Nubbo подключается к Wasabi с помощью ключа доступа и региона ваших bucket. Через несколько минут они окажутся в файловом проводнике с прямыми загрузками, ссылками для доступа и галереями. Это руководство шаг за шагом проходит мастер Nubbo по обоим путям: автоматическому и с ключом, ограниченным одним bucket.

Что вы получаете

  • Просмотр bucket как обычного диска: папки, режимы отображения, поиск, корзина, метки и избранное.
  • Загрузка и скачивание файлов напрямую между браузером и Wasabi. Файлы никогда не проходят через серверы Nubbo.
  • Отправка файлов и папок с паролем, сроком действия и лимитом скачиваний, получение файлов в ваш bucket и создание галерей.
  • Ваши ключи хранятся в зашифрованном виде (AES-256-GCM), а bucket можно отключить в любой момент.

Перед началом

Вам нужен аккаунт Wasabi и аккаунт Nubbo. Каждый подключённый bucket учитывается в лимите вашего тарифа: «Бесплатно» позволяет подключить 2, Personal 5, а в Pro ограничений нет. У Wasabi 16 регионов, и Nubbo спрашивает регион bucket, потому что у каждого из них свой endpoint. Если аккаунта у вас ещё нет, Wasabi предлагает бесплатный 30-дневный пробный период объёмом до 1 ТБ без карты.

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

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

АвтоматическиС ограниченным ключом
КлючДоступ ко всему аккаунтуОграничен одним bucket
BucketNubbo использует один из ваших или создаёт новыйВы создаёте его заранее
CORSNubbo проверяет CORS в WasabiВы проверяете его сами
Когда выбиратьСамый быстрый способКогда не хотите давать доступ ко всему аккаунту

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

Шаг 1: создайте ключ в Wasabi

  1. В консоли Wasabi откройте Access Keys и нажмите Create Access Key.
  2. Выберите Root User или Sub-User с политикой WasabiFullAccess и нажмите Create.
  3. Нажмите Show и скопируйте access key и secret key или скачайте CSV. Повторно Wasabi их не покажет.

Шаг 2: подключите bucket в Nubbo

  1. В Nubbo откройте раздел Buckets и нажмите Подключить bucket. Выберите Wasabi и нажмите Продолжить.

    Шаг «Провайдер» мастера Nubbo с выбранным Wasabi Шаг «Провайдер» мастера Nubbo с выбранным Wasabi
  2. Выберите Автоматически и нажмите Продолжить.

    Шаг «Способ подключения» с вариантами «Автоматически» и «С ограниченным ключом» Шаг «Способ подключения» с вариантами «Автоматически» и «С ограниченным ключом»
  3. На шаге Ваш ключ вставьте access key и secret key и выберите регион своих bucket. Нажмите Проверить ключ. Nubbo проверит, что ключ работает и что у него есть доступ ко всему аккаунту.

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

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

    Шаг «Готово» с проверками подключения, bucket и CORS Шаг «Готово» с проверками подключения, bucket и CORS

Если Nubbo не может добавить правило CORS с вашим ключом, мастер переведёт вас на шаг CORS. В этом случае следуйте разделу Добавьте правило CORS.

Подключение с ограниченным ключом

Шаг 1: подготовьте bucket и ключ в Wasabi

  1. В Buckets нажмите Create Bucket, введите имя, выберите регион и создайте bucket.
  2. В Policies нажмите Create Policy и создайте политику с доступом только к этому bucket. Написать её поможет генератор политик Wasabi.
  3. В Users нажмите Create User, отметьте доступ Programmatic и прикрепите эту политику.
  4. В Access Keys нажмите Create Access Key, выберите Sub-User и этого пользователя и скопируйте access key и secret key.

Шаг 2: подключите bucket в Nubbo

  1. В разделе Buckets нажмите Подключить bucket, выберите Wasabi, а затем С ограниченным ключом.
  2. Вставьте access key и secret key и выберите регион. Нажмите Проверить ключ.
  3. Введите точное имя bucket и нажмите Проверить доступ.
  4. Мастер перейдёт на шаг CORS с правилом, которое нужно добавить.

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

Правило CORS позволяет браузеру загружать и скачивать файлы из вашего bucket на https://nubbo.app. Это то же правило, которое мастер показывает на шаге CORS.

Wasabi не позволяет менять CORS через API, но пока у bucket нет собственных правил, он отвечает любому источнику. Поэтому в Wasabi обычно ничего добавлять не нужно: на шаге CORS сразу нажмите Готово, проверить, и проверка пройдёт. На автоматическом пути Nubbo выполняет эту проверку сам.

Только если вы уже добавили в консоли собственные правила CORS, добавьте и правило Nubbo, потому что ваши правила заменяют поведение Wasabi по умолчанию: откройте bucket, Settings, вкладку Permissions, Cross-Origin Resource Sharing (CORS), нажмите Edit, добавьте это правило в список и нажмите Save.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Шаг «CORS» с правилом, которое нужно добавить в bucket Шаг «CORS» с правилом, которое нужно добавить в bucket

Если вы добавили правило, вернитесь в Nubbo и нажмите Готово, проверить.

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

Сообщение в NubboЧто делать
«Неверные учётные данные. Проверьте access key и secret access key.»Скопируйте оба ключа ещё раз, без пробелов в начале и в конце.
«Похоже, этот ключ ограничен одним bucket. Можно продолжить по ограниченному пути или создать ключ с полным доступом.»Нажмите «Продолжить с ограниченным ключом» или создайте ключ с доступом ко всему аккаунту и нажмите «Попробовать другой ключ».
«Bucket не найден. Проверьте имя и регион.»Проверьте точное имя bucket и то, что выбранный регион совпадает с регионом bucket.
«У вашего ключа нет прав на создание bucket.»Используйте ключ с полным доступом или создайте bucket в своей панели и нажмите «Он уже создан в моей панели».
«Это имя уже занято у этого провайдера; попробуйте другое.»Имена bucket уникальны в пределах всего провайдера: выберите другое.
«У вашего ключа нет прав на эту настройку.»Добавьте правило CORS вручную, как описано выше.
«Пока не работает. Проверьте правило и попробуйте снова; некоторым провайдерам нужна минута, чтобы его применить.»Убедитесь, что источник указан точно как https://nubbo.app без косой черты в конце, подождите минуту и проверьте снова.
«Этот bucket уже используется.»Этот bucket уже подключён в Nubbo, в вашем аккаунте или в чужом.
«Bucket находится в другом регионе. Проверьте настроенный регион.»Выберите в Nubbo регион, в котором вы создали bucket.

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

Wasabi берёт фиксированную цену за ТБ без платы за исходящий трафик, с минимальным платежом и минимальным сроком хранения 90 дней. Мы разбираем это в статье Цены Wasabi.

Частые вопросы

Нужно ли настраивать CORS в Wasabi?

Обычно нет. Wasabi отвечает любому источнику, пока у bucket нет собственных правил CORS, и Nubbo проверяет это сам. Если у вас уже есть свои правила, добавьте в список правило Nubbo.

Почему Nubbo не меняет CORS в Wasabi за меня?

Потому что Wasabi не поддерживает операции CORS из API S3. Их можно изменить только в консоли, в разделе Settings, Permissions.

Какой ключ Wasabi мне нужен?

Для автоматического пути нужен ключ Root User или Sub-User с WasabiFullAccess. Для ограниченного пути подойдёт пользователь с доступом Programmatic и политикой, которая даёт доступ только к вашему bucket.

Какой регион выбрать в Nubbo?

Регион bucket. Он отображается в списке bucket в консоли Wasabi.

Источники

Цены и лимиты взяты с официальных страниц ниже. Провайдеры их меняют, поэтому проверьте перед тем, как принимать решение.