Ръководства

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

Как да свържете bucket в Cloudflare R2 с Nubbo: API токенът, Account ID, съветникът стъпка по стъпка, CORS правилото и какво да правите при грешка.

Nubbo се свързва с Cloudflare R2 чрез R2 API токен и Account ID на акаунта ви. След няколко минути вашите bucket-и са във файлов мениджър с директно качване, връзки за споделяне и галерии. Това ръководство следва съветника на Nubbo стъпка по стъпка и по двата пътя: автоматично или с ключ, ограничен до един bucket.

Какво получавате

  • Разглеждате bucket-а като диск: папки, изгледи, търсене, кошче, етикети и любими.
  • Качвате и изтегляте файлове директно между браузъра си и Cloudflare R2. Файловете никога не минават през сървърите на Nubbo.
  • Споделяте файлове и папки с парола, срок на валидност и лимит на изтеглянията, получавате файлове в bucket-а си и създавате галерии.
  • Ключовете ви се съхраняват криптирани с AES-256-GCM и можете да изключите bucket-а по всяко време.

Преди да започнете

Нужни са ви акаунт в Cloudflare R2 и акаунт в Nubbo. Всеки свързан bucket се брои към лимита на вашия план: Безплатният план позволява 2, Personal 5, а Pro няма ограничение. Преди първия ви bucket Cloudflare ще ви помоли да активирате абонамента за R2 от таблото. Ако вашият bucket има юрисдикция (EU, FedRAMP или US), избирате я в съветника и Nubbo използва endpoint-а на тази юрисдикция.

Изберете как да се свържете

Съветникът на Nubbo предлага два пътя. И двата завършват по един и същ начин: bucket-ът е свързан и готов за качване от браузъра.

АвтоматичноС ограничен ключ
КлючДостъп до целия акаунтОграничен до един bucket
BucketNubbo използва ваш или създава новВие го създавате първо
CORSNubbo добавя правилото вместо васВие добавяте правилото
Кога да го изберетеНай-бързият начинКогато не искате да давате достъп до целия акаунт

Ограниченият ключ е минималният достъп, от който Nubbo се нуждае: Object Read & Write за един bucket. С него Nubbo не може да изброи вашите bucket-и или да създаде нов, затова въвеждате името на bucket-а и сами добавяте правилото за CORS.

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

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

  1. Влезте в dash.cloudflare.com и отворете R2 object storage. Таблото може да показва менютата на вашия език.
  2. Отворете API Tokens и натиснете Create Account API token. Стигате до него и от Overview, в Account Details, Manage.
  3. Изберете правото Admin Read & Write и създайте токена.
  4. Копирайте Access Key ID и Secret Access Key. Cloudflare показва secret само веднъж. Използвайте тези два ключа, а не стойността на токена.
  5. Копирайте и своя Account ID, който се вижда на страницата Overview на R2.

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

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

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

    Стъпката Начин на свързване с опциите Автоматично и С ограничен ключ Стъпката Начин на свързване с опциите Автоматично и С ограничен ключ
  3. В стъпката Вашият ключ поставете Access Key ID, Secret Access Key и Account ID. Nubbo съставя endpoint-а на акаунта ви от Account ID. Регионът на R2 винаги е auto. Преди да натиснете Провери ключа, изберете Юрисдикция на вашия bucket: По подразбиране (без юрисдикция) за повечето bucket-и или EU, FedRAMP или US. Endpoint-ът се променя с нея (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com за ЕС) и списъкът показва само bucket-ите от тази юрисдикция. Натиснете Провери ключа. Nubbo проверява, че ключът работи и че има достъп до целия акаунт.

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

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

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

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

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

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

  1. В R2, Overview натиснете Create bucket и му дайте име (малки букви, цифри и тирета). Няма регион за избиране. Ако данните трябва да останат в ЕС, изберете юрисдикцията EU: endpoint-ът се променя с нея.
  2. Отворете API Tokens и натиснете Create Account API token.
  3. Изберете правото Object Read & Write и го ограничете до вашия bucket.
  4. Копирайте Access Key ID, Secret Access Key и своя Account ID.

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

  1. В Bucket-и натиснете Свързване на bucket, изберете Cloudflare R2 и след това С ограничен ключ.
  2. Поставете Access Key ID, Secret Access Key и Account ID. Преди да натиснете Провери ключа, изберете същата Юрисдикция като на bucket-а. Натиснете Провери ключа.
  3. Въведете точното име на bucket-а и натиснете Провери достъпа.
  4. Съветникът преминава към стъпката CORS с правилото, което трябва да добавите.

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

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

  1. В R2 отворете bucket-а и отидете в Settings.
  2. В CORS Policy натиснете Add CORS policy и изберете раздела JSON.
  3. Поставете правилото и натиснете Save. На Cloudflare може да са му нужни до 30 секунди, за да го приложи.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Стъпката CORS с правилото, което да добавите към bucket-а Стъпката CORS с правилото, което да добавите към bucket-а

След като го запазите, върнете се в Nubbo и натиснете Добавено е, провери. Ако ключът ви има право да променя CORS, Опитай да го конфигурираш вместо мен ще го направи вместо вас.

Ако нещо се обърка

Съобщение в NubboКакво да направите
„Този ключ изглежда ограничен до един bucket. Можете да продължите по ограничения път или да създадете ключ с пълен достъп.“Натиснете Продължи с ограничен ключ или създайте ключ с достъп до целия акаунт и натиснете Опитай друг ключ.
„Вашият ключ няма право да създава bucket-и.“Използвайте ключ с пълен достъп или създайте bucket-а в панела си и натиснете Вече е създаден в моя панел.
„Това име вече се използва при този доставчик; опитайте с друго.“Имената на bucket-ите са уникални в рамките на доставчика: изберете друго.
„Вашият ключ няма право да го настрои.“Добавете CORS правилото ръчно, както е обяснено по-горе.
„Все още не работи. Прегледайте правилото и проверете отново; при някои доставчици прилагането му отнема около минута.“Проверете дали произходът е точно https://nubbo.app без наклонена черта в края, изчакайте минута и проверете отново.
„Този bucket вече се използва.“Този bucket вече е свързан в Nubbo, във вашия акаунт или в друг.
„Невалидни идентификационни данни. Проверете ключа за достъп и тайния ключ за достъп.“Проверете дали сте поставили Access Key ID и Secret Access Key на токена, а не стойността на API токена на Cloudflare.
„Bucket не е намерен. Проверете името и региона.“Проверете името и дали юрисдикцията в Nubbo съвпада с тази на bucket-а (R2 я показва в Settings на bucket-а).

Колко струва

R2 не таксува изходящия трафик и има месечно безплатно ниво. Обясняваме го в Безплатното ниво на Cloudflare R2.

Често задавани въпроси

Къде да намеря своя Account ID в Cloudflare?

На страницата R2 Overview, в Account Details. Това е низ от 32 знака, съставен от цифри и буквите от a до f.

Какво право е нужно на токена за R2?

Минималният достъп, от който Nubbo се нуждае, е Object Read & Write, ограничен до вашия bucket, по пътя с ограничен ключ: въвеждате името на bucket-а и сами добавяте правилото за CORS. Автоматичният път изисква Admin Read & Write, с което Nubbo изброява вашите bucket-и, създава нов и настройва CORS.

Кой регион да използвам с R2?

Никакъв: R2 използва региона auto и Nubbo го задава вместо вас. Подсказките за местоположение на Cloudflare не променят начина, по който се свързва bucket-ът.

Мога ли да свържа R2 bucket с юрисдикция, например тази на ЕС?

Да. В стъпката Вашият ключ изберете юрисдикцията на bucket-а (EU, FedRAMP или US). Всяка има собствен endpoint, например https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, и показва само bucket-ите, създадени в нея.

Таксуват ли се изтеглянията от Nubbo като изходящ трафик в R2?

Не. R2 не таксува изходящия трафик. Изтеглянията обаче се броят за операции за четене.

Източници

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