Guias

Gerenciador de arquivos para o Backblaze B2: conecte ao Nubbo

Como conectar um bucket do Backblaze B2 ao Nubbo: a application key, a região, o assistente passo a passo, o CORS com a CLI do B2 e o que fazer se falhar.

O Nubbo se conecta ao Backblaze B2 pela API compatível com S3 dele, com uma application key e a região da sua conta. Em poucos minutos você tem seus buckets em um explorador de arquivos com uploads diretos, links de compartilhamento e galerias. Este guia segue o assistente do Nubbo passo a passo, pelos dois caminhos: automático ou com uma chave limitada a um bucket.

O que você ganha

  • Navegue pelo bucket como se fosse um disco: pastas, visualizações, busca, lixeira, etiquetas e favoritos.
  • Envie e baixe arquivos diretamente entre o seu navegador e o Backblaze B2. Os arquivos nunca passam pelos servidores do Nubbo.
  • Compartilhe arquivos e pastas com senha, data de expiração e limite de downloads, receba arquivos no seu bucket e crie galerias.
  • Suas chaves são armazenadas criptografadas com AES-256-GCM e você pode desconectar o bucket a qualquer momento.

Antes de começar

Você precisa de uma conta no Backblaze B2 e de uma conta no Nubbo. Cada bucket que você conecta conta para o limite do seu plano: o Gratuito permite 2, o Personal 5 e o Pro não tem limite. No B2, a região é escolhida ao criar a conta e vale para todos os seus buckets. Você pode vê-la no endpoint de qualquer bucket, no formato s3.<region>.backblazeb2.com: essa é a região a escolher no Nubbo. A master key da conta não funciona com a API S3, então crie sempre uma application key.

Escolha como conectar

O assistente do Nubbo oferece dois caminhos. Os dois terminam do mesmo jeito: o bucket conectado e pronto para uploads a partir do navegador.

AutomáticoCom uma chave limitada
ChaveAcesso à conta inteiraLimitada a um bucket
BucketO Nubbo usa um dos seus ou cria um novoVocê cria primeiro
CORSO Nubbo adiciona a regra para vocêVocê adiciona a regra
Quando escolherO caminho mais rápidoQuando você não quer dar acesso à conta inteira

Conexão automática

Passo 1: crie a chave no Backblaze B2

  1. Em backblaze.com, abra B2 Cloud Storage, Application Keys e clique em Add a New Application Key. Não use a master application key.
  2. Dê um nome a ela, defina Allow Access to Bucket(s) como All e Type of Access como Read and Write. Clique em Create New Key.
  3. Copie o keyID (a access key) e a applicationKey (a secret). O Backblaze só mostra a applicationKey uma vez.
  4. Em Buckets, confira o endpoint de qualquer bucket para saber a sua região.

Passo 2: conecte o bucket no Nubbo

  1. No Nubbo, abra Buckets e clique em Conectar bucket. Escolha Backblaze B2 e clique em Continuar.

    Passo Provedor do assistente do Nubbo com o Backblaze B2 selecionado Passo Provedor do assistente do Nubbo com o Backblaze B2 selecionado
  2. Escolha Automático e clique em Continuar.

    Passo Como conectar com as opções Automático e Com uma chave limitada Passo Como conectar com as opções Automático e Com uma chave limitada
  3. No passo Sua chave, cole o keyID e a applicationKey e escolha a região da sua conta. Clique em Verificar chave. O Nubbo verifica se a chave funciona e se ela tem acesso à conta inteira.

    Passo Sua chave para o Backblaze B2 com o guia rápido e os campos da chave Passo Sua chave para o Backblaze B2 com o guia rápido e os campos da chave
  4. Escolha um dos seus buckets e clique em Usar este bucket, ou selecione Criar um novo, digite um nome (e escolha a região, se for pedida) e clique em Criar e preparar. O Nubbo adiciona ao bucket uma regra CORS que só permite uploads e downloads a partir do app e mantém as regras que você já tinha.

    Passo Seu bucket com a lista de buckets e a opção Criar um novo Passo Seu bucket com a lista de buckets e a opção Criar um novo
  5. Revise as três verificações, altere o Nome no Nubbo se quiser e clique em Concluir. O bucket aparece em Buckets e você pode abri-lo no explorador.

    Passo Concluído com as verificações da conexão, do bucket e do CORS Passo Concluído com as verificações da conexão, do bucket e do CORS

Depois, no bucket, abra Lifecycle Settings e escolha Keep only the last version of the file. Caso contrário, o B2 guarda todas as versões e excluir pelo Nubbo não libera espaço.

Se o Nubbo não conseguir adicionar a regra CORS com a sua chave, o assistente leva você ao passo CORS. Nesse caso, siga Adicione a regra CORS.

Conexão com uma chave limitada

Passo 1: prepare o bucket e a chave no Backblaze B2

  1. Em Buckets, clique em Create a Bucket, dê um nome a ele e deixe-o como Private.
  2. No bucket, abra Lifecycle Settings e escolha Keep only the last version of the file.
  3. Confira o endpoint do bucket para saber a região.
  4. Em Application Keys, clique em Add a New Application Key, limite o acesso ao seu bucket com Read and Write e marque Allow List All Bucket Names. Clique em Create New Key.
  5. Copie o keyID e a applicationKey.

Passo 2: conecte o bucket no Nubbo

  1. Em Buckets, clique em Conectar bucket, escolha Backblaze B2 e depois Com uma chave limitada.
  2. Cole o keyID e a applicationKey e escolha a região. Clique em Verificar chave.
  3. Digite o nome exato do bucket e clique em Verificar acesso.
  4. O assistente passa para o passo CORS com a regra que você precisa adicionar.

Adicione a regra CORS

A regra CORS permite que o navegador envie e baixe arquivos do seu bucket em https://nubbo.app. É a mesma regra que o assistente mostra no passo CORS.

As regras CORS do console do B2 são predefinidas e não deixam você escolher as operações, então a regra do Nubbo é adicionada com a ferramenta de linha de comando do B2 (b2), usando uma chave que possa alterar as configurações do bucket.

  1. Instale a CLI, por exemplo com pip install b2.
  2. Faça login com o seu keyID e a sua applicationKey: b2 account authorize.
  3. Aplique a regra, substituindo your-bucket pelo nome do bucket. allPrivate mantém 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
Passo CORS com a regra a ser adicionada ao bucket Passo CORS com a regra a ser adicionada ao bucket

Depois de aplicar a regra, volte ao Nubbo e clique em Já adicionei, verificar. Se a sua chave tiver permissão para alterar o CORS, Tentar configurar para mim faz isso por você.

Se algo der errado

Mensagem no NubboO que fazer
“Esta chave parece limitada a um bucket. Você pode continuar pelo caminho limitado ou criar uma chave com acesso total.”Clique em Continuar com chave limitada, ou crie uma chave com acesso à conta inteira e clique em Tentar outra chave.
“Bucket não encontrado. Verifique o nome e a região.”Confirme o nome exato do bucket e se a região escolhida é a do bucket.
“Sua chave não tem permissão para criar buckets.”Use uma chave com acesso total, ou crie o bucket no seu painel e clique em Já criei no meu painel.
“Esse nome já está em uso neste provedor; tente outro.”Os nomes de bucket são únicos em todo o provedor: escolha outro.
“Sua chave não tem permissão para configurá-lo.”Adicione a regra CORS à mão, como explicado acima.
“Ainda não funciona. Revise a regra e verifique de novo; alguns provedores levam um minuto para aplicá-la.”Confirme que a origem é exatamente https://nubbo.app, sem barra no final, espere um minuto e verifique de novo.
“Este bucket já está em uso.”Esse bucket já está conectado no Nubbo, na sua conta ou em outra.
“Credenciais inválidas. Verifique a chave de acesso e a chave de acesso secreta.”Confirme que você não está usando a master application key, que não funciona com a API S3.
“O bucket está em uma região diferente. Verifique a região configurada.”Escolha no Nubbo a região que aparece no endpoint do bucket.

Quanto custa

O Backblaze B2 cobra por TB, com 10 GB grátis e egress gratuito até três vezes o que você armazena. Explicamos tudo em Preços do Backblaze B2.

Perguntas frequentes

Posso usar a master application key do Backblaze?

Não. O Backblaze não aceita a master key na sua API compatível com S3. Crie uma application key em Application Keys.

Qual região escolho no Nubbo para o B2?

A do endpoint dos seus buckets, no formato s3.<region>.backblazeb2.com. No B2, todos os buckets de uma conta ficam na mesma região.

Por que o CORS é configurado com a CLI do B2?

Porque as regras do console são predefinidas e não deixam você escolher as operações de que o Nubbo precisa. A CLI é o jeito mais simples de aplicar a regra exata; qualquer ferramenta S3 que execute PutBucketCors no endpoint do B2 também serve.

Por que excluir no Nubbo não libera espaço no B2?

Porque o B2 guarda as versões anteriores por padrão. Nas Lifecycle Settings do bucket, escolha Keep only the last version of the file.

Fontes

Os preços e limites vêm das páginas oficiais abaixo. Os provedores mudam esses valores, então confirme antes de fechar qualquer compromisso.