Nubbo sa k Backblaze B2 pripája cez jeho S3 kompatibilné API, pomocou aplikačného kľúča a regiónu vášho účtu. Za pár minút máte buckety v prehliadači súborov s priamym nahrávaním, odkazmi na zdieľanie a galériami. Tento návod sleduje sprievodcu Nubbo krok za krokom a pokrýva obe cesty: automatickú aj s kľúčom obmedzeným na jeden bucket.
Čo získate
- Prehliadanie bucketu ako disku: priečinky, zobrazenia, vyhľadávanie, kôš, štítky a obľúbené.
- Nahrávanie a sťahovanie súborov priamo medzi vaším prehliadačom a Backblaze B2. Súbory nikdy neprechádzajú cez servery Nubbo.
- Zdieľanie súborov a priečinkov s heslom, dátumom vypršania a limitom stiahnutí, prijímanie súborov do bucketu a vytváranie galérií.
- Vaše kľúče sú uložené zašifrované pomocou AES-256-GCM a bucket môžete kedykoľvek odpojiť.
Skôr než začnete
Potrebujete účet v Backblaze B2 a účet v Nubbo. Každý pripojený bucket sa započítava do limitu vášho plánu: Bezplatný plán umožňuje 2, Personal 5 a Pro nemá limit. V B2 sa región volí pri vytvorení účtu a platí pre všetky jeho buckety. Nájdete ho v endpointe ľubovoľného bucketu, v tvare s3.<region>.backblazeb2.com: to je región, ktorý vyberiete v Nubbo. Hlavný kľúč účtu s S3 API nefunguje, preto vždy vytvorte aplikačný kľúč.
Zvoľte spôsob pripojenia
Sprievodca Nubbo ponúka dve cesty. Obe končia rovnako: bucket je pripojený a pripravený na nahrávanie z prehliadača.
| Automaticky | S obmedzeným kľúčom | |
|---|---|---|
| Kľúč | Prístup k celému účtu | Obmedzený na jeden bucket |
| Bucket | Nubbo použije jeden z vašich alebo vytvorí nový | Najprv ho vytvoríte vy |
| CORS | Nubbo pridá pravidlo za vás | Pravidlo pridáte vy |
| Kedy ju zvoliť | Najrýchlejšia cesta | Keď nechcete dať prístup k celému účtu |
Automatické pripojenie
Krok 1: vytvorte kľúč v Backblaze B2
- Na backblaze.com otvorte B2 Cloud Storage, Application Keys a stlačte Add a New Application Key. Nepoužívajte hlavný aplikačný kľúč (master application key).
- Pomenujte ho, nastavte Allow Access to Bucket(s) na All a Type of Access na Read and Write. Stlačte Create New Key.
- Skopírujte keyID (prístupový kľúč) a applicationKey (tajný kľúč). Backblaze zobrazí applicationKey iba raz.
- V Buckets sa pozrite na endpoint ľubovoľného bucketu a zistíte svoj región.
Krok 2: pripojte bucket v Nubbo
V Nubbo otvorte Buckety a stlačte Pripojiť bucket. Vyberte Backblaze B2 a stlačte Pokračovať.

Zvoľte Automaticky a stlačte Pokračovať.

V kroku Váš kľúč vložte keyID a applicationKey a vyberte región svojho účtu. Stlačte Overiť kľúč. Nubbo overí, že kľúč funguje a že má prístup k celému účtu.

Vyberte jeden zo svojich bucketov a stlačte Použiť tento bucket, alebo zvoľte Vytvoriť nový, zadajte názov (a vyberte región, ak sa naň pýta) a stlačte Vytvoriť a pripraviť. Nubbo pridá do bucketu pravidlo CORS, ktoré povoľuje nahrávanie a sťahovanie len z aplikácie, a zachová pravidlá, ktoré už má.

Skontrolujte tri overenia, ak chcete, zmeňte Názov v Nubbo a stlačte Dokončiť. Bucket sa zobrazí v sekcii Buckety a môžete ho otvoriť v prehliadači súborov.

Potom v buckete otvorte Lifecycle Settings a zvoľte Keep only the last version of the file. Inak B2 uchováva každú verziu a mazanie z Nubbo neuvoľní miesto.
Ak Nubbo s vaším kľúčom nemôže pravidlo CORS pridať, sprievodca vás presunie do kroku CORS. Potom postupujte podľa časti Pridajte pravidlo CORS.
Pripojenie s obmedzeným kľúčom
Krok 1: pripravte bucket a kľúč v Backblaze B2
- V Buckets stlačte Create a Bucket, pomenujte ho a ponechajte ho Private.
- V buckete otvorte Lifecycle Settings a zvoľte Keep only the last version of the file.
- Pozrite sa na endpoint bucketu a zistíte región.
- V Application Keys stlačte Add a New Application Key, obmedzte prístup na svoj bucket s Read and Write a označte Allow List All Bucket Names. Stlačte Create New Key.
- Skopírujte keyID a applicationKey.
Krok 2: pripojte bucket v Nubbo
- V sekcii Buckety stlačte Pripojiť bucket, vyberte Backblaze B2 a potom S obmedzeným kľúčom.
- Vložte keyID a applicationKey a vyberte región. Stlačte Overiť kľúč.
- Zadajte presný názov bucketu a stlačte Overiť prístup.
- Sprievodca prejde do kroku CORS s pravidlom, ktoré treba pridať.
Pridajte pravidlo CORS
Pravidlo CORS umožňuje prehliadaču nahrávať a sťahovať súbory z vášho bucketu na https://nubbo.app. Je to to isté pravidlo, ktoré sprievodca zobrazuje v kroku CORS.
Pravidlá CORS v konzole B2 sú predvolené šablóny a nedovolia vybrať operácie, preto sa pravidlo Nubbo pridáva nástrojom príkazového riadka B2 (b2) s kľúčom, ktorý môže meniť nastavenia bucketu.
- Nainštalujte CLI, napríklad príkazom
pip install b2. - Prihláste sa svojím keyID a applicationKey:
b2 account authorize. - Použite pravidlo a nahraďte
your-bucketnázvom bucketu.allPrivateponechá bucket súkromný.
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

Keď je pravidlo použité, vráťte sa do Nubbo a stlačte Pridané, overiť. Ak má váš kľúč oprávnenie meniť CORS, Skúsiť to nastaviť za mňa to urobí za vás.
Keď niečo zlyhá
| Správa v Nubbo | Čo robiť |
|---|---|
| “Tento kľúč sa zdá byť obmedzený na jeden bucket. Môžete pokračovať obmedzenou cestou alebo vytvoriť kľúč s plným prístupom.” | Stlačte Pokračovať s obmedzeným kľúčom, alebo vytvorte kľúč s prístupom k celému účtu a stlačte Skúsiť iný kľúč. |
| “Bucket nebol nájdený. Overte názov a región.” | Skontrolujte presný názov bucketu a či zvolený región je región bucketu. |
| “Váš kľúč nemá oprávnenie vytvárať buckety.” | Použite kľúč s plným prístupom, alebo vytvorte bucket vo svojom paneli a stlačte Už ho mám vo svojom paneli. |
| “Tento názov sa u tohto poskytovateľa už používa; skúste iný.” | Názvy bucketov sú u poskytovateľa jedinečné: vyberte iný. |
| “Váš kľúč nemá oprávnenie to nastaviť.” | Pridajte pravidlo CORS ručne, ako je vysvetlené vyššie. |
| “Zatiaľ to nefunguje. Skontrolujte pravidlo a overte znova; niektorým poskytovateľom trvá minútu, kým ho použijú.” | Skontrolujte, či je pôvod presne https://nubbo.app bez lomky na konci, počkajte minútu a overte znova. |
| “Tento bucket sa už používa.” | Tento bucket je už v Nubbo pripojený, vo vašom účte alebo v inom. |
| “Neplatné prihlasovacie údaje. Skontrolujte prístupový kľúč a tajný prístupový kľúč.” | Skontrolujte, či nepoužívate hlavný aplikačný kľúč, ktorý s S3 API nefunguje. |
| “Bucket sa nachádza v inom regióne. Overte nastavený región.” | V Nubbo vyberte región, ktorý je uvedený v endpointe bucketu. |
Koľko to stojí
Backblaze B2 účtuje za TB, 10 GB má zadarmo a odchádzajúci prenos je bezplatný až do trojnásobku toho, čo máte uložené. Vysvetľujeme to v článku Ceny Backblaze B2.
Časté otázky
Môžem použiť hlavný aplikačný kľúč Backblaze?
Nie. Backblaze vo svojom S3 kompatibilnom API hlavný kľúč nepodporuje. Vytvorte si aplikačný kľúč v Application Keys.
Aký región mám v Nubbo zvoliť pre B2?
Ten, ktorý je v endpointe vašich bucketov, v tvare s3.<region>.backblazeb2.com. V B2 sú všetky buckety jedného účtu v rovnakom regióne.
Prečo sa CORS nastavuje cez B2 CLI?
Pretože pravidlá v konzole sú predvolené šablóny a nedovolia vybrať operácie, ktoré Nubbo potrebuje. CLI je najjednoduchší spôsob, ako použiť presné pravidlo; funguje aj akýkoľvek S3 nástroj, ktorý spustí PutBucketCors voči endpointu B2.
Prečo mazanie v Nubbo neuvoľní miesto v B2?
Pretože B2 predvolene uchováva predchádzajúce verzie. V Lifecycle Settings bucketu zvoľte Keep only the last version of the file.
Zdroje
Ceny a limity pochádzajú z oficiálnych stránok uvedených nižšie. Poskytovatelia ich menia, preto si ich pred rozhodnutím overte.