Guías

Xestor de ficheiros para Backblaze B2: conéctao a Nubbo

Como conectar un bucket de Backblaze B2 a Nubbo: a application key, a rexión, o asistente paso a paso, o CORS coa CLI de B2 e que facer se falla.

Nubbo conéctase a Backblaze B2 a través da súa API compatible con S3, cunha application key e a rexión da túa conta. En poucos minutos tes os teus buckets nun explorador de ficheiros con subidas directas, ligazóns para compartir e galerías. Esta guía segue o asistente de Nubbo paso a paso, cos dous camiños: automático ou cunha chave limitada a un bucket.

Que consegues

  • Explorar o bucket coma un disco: cartafoles, vistas, busca, papeleira, etiquetas e favoritos.
  • Subir e descargar ficheiros directamente entre o teu navegador e Backblaze B2. Os ficheiros nunca pasan polos servidores de Nubbo.
  • Compartir ficheiros e cartafoles con contrasinal, caducidade e límite de descargas, recibir ficheiros no teu bucket e crear galerías.
  • As túas chaves gárdanse cifradas con AES-256-GCM e podes desconectar o bucket cando queiras.

Antes de comezar

Necesitas unha conta en Backblaze B2 e unha conta de Nubbo. Cada bucket que conectas conta para o límite do teu plan: Gratuíto permite 2, Personal 5 e Pro non ten límite. En B2 a rexión escóllese ao crear a conta e vale para todos os seus buckets. Podes vela no endpoint de calquera bucket, co formato s3.<region>.backblazeb2.com: esa é a rexión que tes que escoller en Nubbo. A chave mestra da conta non funciona coa API S3, así que crea sempre unha application key.

Escolle como conectar

O asistente de Nubbo ofrece dous camiños. Os dous rematan igual: o bucket conectado e listo para subir ficheiros desde o navegador.

AutomáticoCon chave limitada
ChaveCon acceso a toda a contaLimitada a un bucket
BucketNubbo usa un teu ou crea un novoCréalo ti antes
CORSNubbo engade a regra por tiEngades ti a regra
Cando escolleloO máis rápidoSe non queres dar acceso a toda a conta

Conexión automática

Paso 1: crea a chave en Backblaze B2

  1. En backblaze.com, abre B2 Cloud Storage, Application Keys e preme Add a New Application Key. Non uses a master application key.
  2. Ponlle un nome, en Allow Access to Bucket(s) escolle All e en Type of Access, Read and Write. Preme Create New Key.
  3. Copia o keyID (a access key) e o applicationKey (a secret). Backblaze mostra o applicationKey só unha vez.
  4. En Buckets, mira o endpoint de calquera bucket para saber a túa rexión.

Paso 2: conecta o bucket en Nubbo

  1. En Nubbo, abre Buckets e preme Conectar bucket. Escolle Backblaze B2 e preme Continuar.

    Paso Provedor do asistente de Nubbo con Backblaze B2 seleccionado Paso Provedor do asistente de Nubbo con Backblaze B2 seleccionado
  2. Escolle Automático e preme Continuar.

    Paso Como conectar coas opcións Automático e Con chave limitada Paso Como conectar coas opcións Automático e Con chave limitada
  3. No paso A túa chave, pega o keyID e o applicationKey e escolle a rexión da túa conta. Preme Comprobar chave. Nubbo comproba que a chave funciona e que ten acceso a toda a conta.

    Paso A túa chave para Backblaze B2 coa guía rápida e os campos da chave Paso A túa chave para Backblaze B2 coa guía rápida e os campos da chave
  4. Escolle un dos teus buckets e preme Usar este bucket, ou marca Crear un novo, escribe un nome (e escolle a rexión, se cha pide) e preme Crear e preparar. Nubbo engade ao bucket unha regra de CORS que só permite subir e descargar desde a app e mantén as regras que xa teña.

    Paso O teu bucket coa lista de buckets e a opción Crear un novo Paso O teu bucket coa lista de buckets e a opción Crear un novo
  5. Revisa as tres comprobacións, cambia o Nome en Nubbo se queres e preme Rematar. O bucket aparece en Buckets e xa podes abrilo no explorador.

    Paso Listo coas comprobacións de conexión, bucket e CORS Paso Listo coas comprobacións de conexión, bucket e CORS

Despois, no bucket, abre Lifecycle Settings e escolle Keep only the last version of the file. Se non, B2 garda todas as versións e borrar desde Nubbo non libera espazo.

Se Nubbo non pode engadir a regra de CORS coa túa chave, o asistente lévate ao paso CORS. Segue entón a sección Engade a regra de CORS.

Conexión con chave limitada

Paso 1: prepara o bucket e a chave en Backblaze B2

  1. En Buckets, preme Create a Bucket, ponlle un nome e déixao en Private.
  2. No bucket, abre Lifecycle Settings e escolle Keep only the last version of the file.
  3. Mira o endpoint do bucket para saber a rexión.
  4. En Application Keys, preme Add a New Application Key, limita o acceso ao teu bucket con Read and Write e marca Allow List All Bucket Names. Preme Create New Key.
  5. Copia o keyID e o applicationKey.

Paso 2: conecta o bucket en Nubbo

  1. En Buckets, preme Conectar bucket, escolle Backblaze B2 e despois Con chave limitada.
  2. Pega o keyID e o applicationKey e escolle a rexión. Preme Comprobar chave.
  3. Escribe o nome exacto do bucket e preme Comprobar acceso.
  4. O asistente pasa ao paso CORS coa regra que tes que engadir.

Engade a regra de CORS

A regra de CORS permite que o navegador suba e descargue ficheiros do teu bucket desde https://nubbo.app. É a mesma regra que mostra o paso CORS do asistente.

As regras de CORS da consola de B2 son predefinidas e non deixan escoller as operacións, así que a regra de Nubbo engádese coa ferramenta de liña de comandos de B2 (b2), cunha chave que poida cambiar a configuración do bucket.

  1. Instala a CLI, por exemplo con pip install b2.
  2. Inicia sesión co teu keyID e o teu applicationKey: b2 account authorize.
  3. Aplica a regra cambiando your-bucket polo nome do bucket. allPrivate mantén o bucket privado.
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
Paso CORS coa regra que hai que engadir ao bucket Paso CORS coa regra que hai que engadir ao bucket

Cando a apliques, volve a Nubbo e preme Xa a engadín, comprobar. Se a túa chave ten permiso para cambiar o CORS, Tentar configuralo por min faino por ti.

Se algo falla

Mensaxe en NubboQue facer
«Esta chave parece limitada a un bucket. Podes seguir co camiño limitado ou crear unha chave con acceso completo.»Preme Seguir con chave limitada ou crea unha chave con acceso a toda a conta e preme Probar outra chave.
«Non se atopou o bucket. Verifica o nome e a rexión.»Revisa o nome exacto do bucket e que a rexión escollida sexa a súa.
«A túa chave non ten permiso para crear buckets.»Usa unha chave con acceso completo ou crea o bucket no teu panel e preme Xa o creei no meu panel.
«Ese nome xa está en uso neste provedor; proba con outro.»Os nomes de bucket son únicos en todo o provedor: escolle outro.
«A túa chave non ten permiso para configuralo.»Engade a regra de CORS a man, como se explica arriba.
«Aínda non funciona. Revisa a regra e volve comprobar; algúns provedores tardan un minuto en aplicala.»Comproba que a orixe sexa exactamente https://nubbo.app, sen barra final, agarda un minuto e volve comprobar.
«Este bucket xa está en uso.»Ese bucket xa está conectado en Nubbo, na túa conta ou noutra.
«As credenciais non son válidas. Revisa a access key e a secret access key.»Comproba que non estás usando a master application key, que non funciona coa API S3.
«O bucket está noutra rexión. Verifica a rexión configurada.»Escolle en Nubbo a rexión que aparece no endpoint do bucket.

Canto custa

Backblaze B2 cobra por TB, con 10 GB gratis e saída gratuíta ata o triplo do que almacenas. Explicámolo en Prezos de Backblaze B2.

Preguntas frecuentes

Podo usar a master application key de Backblaze?

Non. Backblaze non admite a chave mestra na súa API compatible con S3. Crea unha application key en Application Keys.

Que rexión escollo en Nubbo para B2?

A do endpoint dos teus buckets, co formato s3.<region>.backblazeb2.com. En B2 todos os buckets dunha conta están na mesma rexión.

Por que o CORS se configura coa CLI de B2?

Porque as regras da consola son predefinidas e non deixan escoller as operacións que Nubbo necesita. A CLI é o xeito máis sinxelo de aplicar a regra exacta; tamén vale calquera ferramenta S3 que execute PutBucketCors contra o endpoint de B2.

Por que borrar en Nubbo non libera espazo en B2?

Porque B2 garda as versións anteriores por defecto. Nas Lifecycle Settings do bucket, escolle Keep only the last version of the file.

Fontes

Os prezos e límites saen das páxinas oficiais de abaixo. Os provedores cámbianos, así que compróbaos antes de decidir.