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 |
| Bucket | Nubbo използва ваш или създава нов | Вие го създавате първо |
| CORS | Nubbo добавя правилото вместо вас | Вие добавяте правилото |
| Кога да го изберете | Най-бързият начин | Когато не искате да давате достъп до целия акаунт |
Ограниченият ключ е минималният достъп, от който Nubbo се нуждае: Object Read & Write за един bucket. С него Nubbo не може да изброи вашите bucket-и или да създаде нов, затова въвеждате името на bucket-а и сами добавяте правилото за CORS.
Автоматично свързване
Стъпка 1: създайте ключа в Cloudflare R2
- Влезте в dash.cloudflare.com и отворете R2 object storage. Таблото може да показва менютата на вашия език.
- Отворете API Tokens и натиснете Create Account API token. Стигате до него и от Overview, в Account Details, Manage.
- Изберете правото Admin Read & Write и създайте токена.
- Копирайте Access Key ID и Secret Access Key. Cloudflare показва secret само веднъж. Използвайте тези два ключа, а не стойността на токена.
- Копирайте и своя Account ID, който се вижда на страницата Overview на R2.
Стъпка 2: свържете bucket-а в Nubbo
В Nubbo отворете Bucket-и и натиснете Свързване на bucket. Изберете Cloudflare R2 и натиснете Продължи.

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

В стъпката Вашият ключ поставете 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 проверява, че ключът работи и че има достъп до целия акаунт.

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

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

Ако Nubbo не може да добави CORS правилото с вашия ключ, съветникът ви отвежда към стъпката CORS. Тогава следвайте Добавете CORS правилото.
Свързване с ограничен ключ
Стъпка 1: подгответе bucket-а и ключа в Cloudflare R2
- В R2, Overview натиснете Create bucket и му дайте име (малки букви, цифри и тирета). Няма регион за избиране. Ако данните трябва да останат в ЕС, изберете юрисдикцията EU: endpoint-ът се променя с нея.
- Отворете API Tokens и натиснете Create Account API token.
- Изберете правото Object Read & Write и го ограничете до вашия bucket.
- Копирайте Access Key ID, Secret Access Key и своя Account ID.
Стъпка 2: свържете bucket-а в Nubbo
- В Bucket-и натиснете Свързване на bucket, изберете Cloudflare R2 и след това С ограничен ключ.
- Поставете Access Key ID, Secret Access Key и Account ID. Преди да натиснете Провери ключа, изберете същата Юрисдикция като на bucket-а. Натиснете Провери ключа.
- Въведете точното име на bucket-а и натиснете Провери достъпа.
- Съветникът преминава към стъпката CORS с правилото, което трябва да добавите.
Добавете CORS правилото
CORS правилото позволява на браузъра да качва и изтегля файлове от вашия bucket в https://nubbo.app. Това е същото правило, което съветникът показва в стъпката CORS.
- В R2 отворете bucket-а и отидете в Settings.
- В CORS Policy натиснете Add CORS policy и изберете раздела JSON.
- Поставете правилото и натиснете Save. На Cloudflare може да са му нужни до 30 секунди, за да го приложи.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
"AllowedOrigins": ["https://nubbo.app"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 3600
}
]

След като го запазите, върнете се в 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 не таксува изходящия трафик. Изтеглянията обаче се броят за операции за четене.
Източници
Цените и ограниченията са взети от официалните страници по-долу. Доставчиците ги променят, затова проверете, преди да се обвържете.