Guies

Gestor de fitxers per a Backblaze B2: connecta'l a Nubbo

Com connectar un bucket de Backblaze B2 a Nubbo: la clau d'aplicació, la regió, l'assistent pas a pas, el CORS amb la CLI de B2 i què fer si falla.

Nubbo es connecta a Backblaze B2 a través de la seva API compatible amb S3, amb una clau d’aplicació i la regió del teu compte. En pocs minuts tens els buckets en un explorador de fitxers amb pujades directes, enllaços per compartir i galeries. Aquesta guia segueix l’assistent de Nubbo pas a pas, pels dos camins: automàtic o amb una clau limitada a un bucket.

Què aconsegueixes

  • Explora el bucket com si fos un disc: carpetes, vistes, cerca, paperera, etiquetes i preferits.
  • Puja i baixa fitxers directament entre el teu navegador i Backblaze B2. Els fitxers mai passen pels servidors de Nubbo.
  • Comparteix fitxers i carpetes amb contrasenya, caducitat i límit de baixades, rep fitxers al teu bucket i crea galeries.
  • Les teves claus es guarden xifrades amb AES-256-GCM i pots desconnectar el bucket quan vulguis.

Abans de començar

Necessites un compte de Backblaze B2 i un compte de Nubbo. Cada bucket que connectes compta per al límit del teu pla: Gratuït en permet 2, Personal 5 i Pro no té límit. A B2 la regió es tria en crear el compte i s’aplica a tots els seus buckets. La pots veure a l’endpoint de qualsevol bucket, amb la forma s3.<region>.backblazeb2.com: aquesta és la regió que has de triar a Nubbo. La clau mestra del compte no funciona amb l’API S3, així que crea sempre una clau d’aplicació.

Tria com connectar

L’assistent de Nubbo ofereix dos camins. Tots dos acaben igual: el bucket connectat i preparat per pujar fitxers des del navegador.

AutomàticAmb clau limitada
ClauAccés a tot el compteLimitada a un bucket
BucketNubbo en fa servir un dels teus o en crea un de nouEl crees tu primer
CORSNubbo hi afegeix la regla per tuHi afegeixes tu la regla
Quan triar-loLa via més ràpidaQuan no vols donar accés a tot el compte

Connexió automàtica

Pas 1: crea la clau a Backblaze B2

  1. A backblaze.com, obre B2 Cloud Storage, Application Keys i prem Add a New Application Key. No facis servir la master application key.
  2. Posa-li un nom, posa Allow Access to Bucket(s) a All i Type of Access a Read and Write. Prem Create New Key.
  3. Copia el keyID (l’access key) i l’applicationKey (el secret). Backblaze només mostra l’applicationKey una vegada.
  4. A Buckets, mira l’endpoint de qualsevol bucket per saber la teva regió.

Pas 2: connecta el bucket a Nubbo

  1. A Nubbo, obre Buckets i prem Connecta un bucket. Tria Backblaze B2 i prem Continua.

    Pas Proveïdor de l'assistent de Nubbo amb Backblaze B2 seleccionat Pas Proveïdor de l'assistent de Nubbo amb Backblaze B2 seleccionat
  2. Tria Automàtic i prem Continua.

    Pas Com connectar amb les opcions Automàtic i Amb clau limitada Pas Com connectar amb les opcions Automàtic i Amb clau limitada
  3. Al pas La teva clau, enganxa el keyID i l’applicationKey i tria la regió del teu compte. Prem Comprova la clau. Nubbo comprova que la clau funciona i que té accés a tot el compte.

    Pas La teva clau de Backblaze B2 amb la guia ràpida i els camps de la clau Pas La teva clau de Backblaze B2 amb la guia ràpida i els camps de la clau
  4. Tria un dels teus buckets i prem Fes servir aquest bucket, o selecciona Crea’n un de nou, escriu un nom (i tria la regió, si te la demana) i prem Crea i prepara. Nubbo afegeix al bucket una regla de CORS que només permet pujades i baixades des de l’app, i conserva les regles que ja tenia.

    Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou
  5. Revisa les tres comprovacions, canvia el Nom a Nubbo si vols i prem Acaba. El bucket apareix a Buckets i el pots obrir a l’explorador.

    Pas Fet amb les comprovacions de connexió, bucket i CORS Pas Fet amb les comprovacions de connexió, bucket i CORS

Després, al bucket, obre Lifecycle Settings i tria Keep only the last version of the file. Si no, B2 conserva totes les versions i esborrar des de Nubbo no allibera espai.

Si Nubbo no pot afegir la regla de CORS amb la teva clau, l’assistent et porta al pas CORS. Llavors segueix Afegeix la regla de CORS.

Connexió amb clau limitada

Pas 1: prepara el bucket i la clau a Backblaze B2

  1. A Buckets, prem Create a Bucket, posa-li un nom i deixa’l en Private.
  2. Al bucket, obre Lifecycle Settings i tria Keep only the last version of the file.
  3. Mira l’endpoint del bucket per saber la regió.
  4. A Application Keys, prem Add a New Application Key, limita l’accés al teu bucket amb Read and Write i marca Allow List All Bucket Names. Prem Create New Key.
  5. Copia el keyID i l’applicationKey.

Pas 2: connecta el bucket a Nubbo

  1. A Buckets, prem Connecta un bucket, tria Backblaze B2 i després Amb clau limitada.
  2. Enganxa el keyID i l’applicationKey i tria la regió. Prem Comprova la clau.
  3. Escriu el nom exacte del bucket i prem Comprova l’accés.
  4. L’assistent passa al pas CORS amb la regla que has d’afegir.

Afegeix la regla de CORS

La regla de CORS permet que el navegador pugi i baixi fitxers del teu bucket a https://nubbo.app. És la mateixa regla que l’assistent mostra al pas CORS.

Les regles de CORS de la consola de B2 són predefinides i no et deixen triar les operacions, així que la regla de Nubbo s’afegeix amb l’eina de línia d’ordres de B2 (b2), fent servir una clau que pugui canviar la configuració del bucket.

  1. Instal·la la CLI, per exemple amb pip install b2.
  2. Inicia la sessió amb el teu keyID i l’applicationKey: b2 account authorize.
  3. Aplica la regla substituint your-bucket pel nom del bucket. allPrivate manté el bucket privat.
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
Pas CORS amb la regla que cal afegir al bucket Pas CORS amb la regla que cal afegir al bucket

Un cop aplicada, torna a Nubbo i prem Ja l’he afegida, comprova-ho. Si la teva clau té permís per canviar el CORS, Intenta configurar-ho per mi ho fa per tu.

Si alguna cosa falla

Missatge a NubboQuè fer
“Aquesta clau sembla limitada a un bucket. Pots continuar amb el camí limitat o crear una clau amb accés complet.”Prem Continua amb clau limitada, o crea una clau amb accés a tot el compte i prem Prova una altra clau.
“No s’ha trobat el bucket. Verifica el nom i la regió.”Comprova el nom exacte del bucket i que la regió triada és la del bucket.
“La teva clau no té permís per crear buckets.”Fes servir una clau amb accés complet, o crea el bucket al teu tauler i prem Ja l’he creat al meu tauler.
“Aquest nom ja està en ús en aquest proveïdor; prova’n un altre.”Els noms de bucket són únics a tot el proveïdor: tria’n un altre.
“La teva clau no té permís per configurar-ho.”Afegeix la regla de CORS a mà, com s’explica més amunt.
“Encara no funciona. Revisa la regla i torna-ho a comprovar; alguns proveïdors triguen un minut a aplicar-la.”Comprova que l’origen és exactament https://nubbo.app sense barra final, espera un minut i torna-ho a comprovar.
“Aquest bucket ja està en ús.”Aquest bucket ja està connectat a Nubbo, al teu compte o en un altre.
“Les credencials no són vàlides. Revisa l’access key i la secret access key.”Comprova que no fas servir la master application key, que no funciona amb l’API S3.
“El bucket és en una altra regió. Verifica la regió configurada.”Tria a Nubbo la regió que apareix a l’endpoint del bucket.

Quant costa

Backblaze B2 cobra per TB amb 10 GB gratuïts i sortida de dades gratuïta fins a tres vegades el que emmagatzemes. T’ho expliquem a Preus de Backblaze B2.

Preguntes freqüents

Puc fer servir la master application key de Backblaze?

No. Backblaze no admet la clau mestra a la seva API compatible amb S3. Crea una clau d'aplicació a Application Keys.

Quina regió he de triar a Nubbo per a B2?

La de l'endpoint dels teus buckets, amb la forma s3.<regió>.backblazeb2.com. A B2 tots els buckets d'un compte són a la mateixa regió.

Per què el CORS es configura amb la CLI de B2?

Perquè les regles de la consola són predefinides i no et deixen triar les operacions que necessita Nubbo. La CLI és la manera més senzilla d'aplicar la regla exacta; també serveix qualsevol eina S3 que executi PutBucketCors contra l'endpoint de B2.

Per què esborrar a Nubbo no allibera espai a B2?

Perquè B2 conserva les versions anteriors per defecte. A les Lifecycle Settings del bucket, tria Keep only the last version of the file.

Fonts

Els preus i els límits surten de les pàgines oficials de sota. Els proveïdors els canvien, així que comprova'ls abans de decidir.