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ático | Com uma chave limitada | |
|---|---|---|
| Chave | Acesso à conta inteira | Limitada a um bucket |
| Bucket | O Nubbo usa um dos seus ou cria um novo | Você cria primeiro |
| CORS | O Nubbo adiciona a regra para você | Você adiciona a regra |
| Quando escolher | O caminho mais rápido | Quando você não quer dar acesso à conta inteira |
Conexão automática
Passo 1: crie a chave no Backblaze B2
- Em backblaze.com, abra B2 Cloud Storage, Application Keys e clique em Add a New Application Key. Não use a master application key.
- 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.
- Copie o keyID (a access key) e a applicationKey (a secret). O Backblaze só mostra a applicationKey uma vez.
- Em Buckets, confira o endpoint de qualquer bucket para saber a sua região.
Passo 2: conecte o bucket no Nubbo
No Nubbo, abra Buckets e clique em Conectar bucket. Escolha Backblaze B2 e clique em Continuar.

Escolha Automático e clique em Continuar.

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.

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.

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.

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
- Em Buckets, clique em Create a Bucket, dê um nome a ele e deixe-o como Private.
- No bucket, abra Lifecycle Settings e escolha Keep only the last version of the file.
- Confira o endpoint do bucket para saber a região.
- 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.
- Copie o keyID e a applicationKey.
Passo 2: conecte o bucket no Nubbo
- Em Buckets, clique em Conectar bucket, escolha Backblaze B2 e depois Com uma chave limitada.
- Cole o keyID e a applicationKey e escolha a região. Clique em Verificar chave.
- Digite o nome exato do bucket e clique em Verificar acesso.
- 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.
- Instale a CLI, por exemplo com
pip install b2. - Faça login com o seu keyID e a sua applicationKey:
b2 account authorize. - Aplique a regra, substituindo
your-bucketpelo nome do bucket.allPrivatemanté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

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 Nubbo | O 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.