Guias

Gestor de ficheiros para o Backblaze B2: ligue-o ao Nubbo

Como ligar 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 liga-se ao Backblaze B2 através da sua API compatível com S3, com uma application key e a região da sua conta. Em poucos minutos tem os seus buckets num explorador de ficheiros com carregamentos diretos, ligações de partilha 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 consegue

  • Navegue pelo bucket como se fosse um disco: pastas, vistas, pesquisa, lixo, etiquetas e favoritos.
  • Carregue e transfira ficheiros diretamente entre o seu navegador e o Backblaze B2. Os ficheiros nunca passam pelos servidores do Nubbo.
  • Partilhe ficheiros e pastas com palavra-passe, data de expiração e limite de transferências, receba ficheiros no seu bucket e crie galerias.
  • As suas chaves são guardadas encriptadas com AES-256-GCM e pode desligar o bucket a qualquer momento.

Antes de começar

Precisa de uma conta no Backblaze B2 e de uma conta no Nubbo. Cada bucket que liga conta para o limite do seu plano: o Grátis permite 2, o Personal 5 e o Pro não tem limite. No B2, a região escolhe-se ao criar a conta e aplica-se a todos os seus buckets. 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, por isso crie sempre uma application key.

Escolha como ligar

O assistente do Nubbo oferece dois caminhos. Ambos terminam da mesma forma: o bucket ligado e pronto para carregamentos a partir do navegador.

AutomáticoCom uma chave limitada
ChaveAcesso a toda a contaLimitada a um bucket
BucketO Nubbo usa um dos seus ou cria um novoCria-o você primeiro
CORSO Nubbo adiciona a regra por siAdiciona você a regra
Quando o escolherO caminho mais rápidoQuando não quer dar acesso a toda a conta

Ligação automática

Passo 1: crie a chave no Backblaze B2

  1. Em backblaze.com, abra B2 Cloud Storage, Application Keys e prima Add a New Application Key. Não use a master application key.
  2. Dê-lhe um nome, defina Allow Access to Bucket(s) como All e Type of Access como Read and Write. Prima 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, consulte o endpoint de qualquer bucket para saber a sua região.

Passo 2: ligue o bucket no Nubbo

  1. No Nubbo, abra Buckets e prima Ligar bucket. Escolha Backblaze B2 e prima Continuar.

    Passo Fornecedor do assistente do Nubbo com o Backblaze B2 selecionado Passo Fornecedor do assistente do Nubbo com o Backblaze B2 selecionado
  2. Escolha Automático e prima Continuar.

    Passo Como ligar com as opções Automático e Com uma chave limitada Passo Como ligar com as opções Automático e Com uma chave limitada
  3. No passo A sua chave, cole o keyID e a applicationKey e escolha a região da sua conta. Prima Verificar chave. O Nubbo verifica que a chave funciona e que tem acesso a toda a conta.

    Passo A sua chave para o Backblaze B2 com o guia rápido e os campos da chave Passo A sua chave para o Backblaze B2 com o guia rápido e os campos da chave
  4. Escolha um dos seus buckets e prima Usar este bucket, ou selecione Criar um novo, escreva um nome (e escolha a região, se a pedir) e prima Criar e preparar. O Nubbo adiciona ao bucket uma regra CORS que só permite carregamentos e transferências a partir da aplicação e mantém as regras que já tinha.

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

    Passo Concluído com as verificações da ligação, do bucket e do CORS Passo Concluído com as verificações da ligaçã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 eliminar a partir do Nubbo não liberta espaço.

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

Ligação com uma chave limitada

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

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

Passo 2: ligue o bucket no Nubbo

  1. Em Buckets, prima Ligar bucket, escolha Backblaze B2 e depois Com uma chave limitada.
  2. Cole o keyID e a applicationKey e escolha a região. Prima Verificar chave.
  3. Escreva o nome exato do bucket e prima Verificar acesso.
  4. O assistente passa ao passo CORS com a regra que tem de adicionar.

Adicione a regra CORS

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

As regras CORS da consola do B2 são predefinidas e não o deixam escolher as operações, por isso a regra do Nubbo adiciona-se com a ferramenta de linha de comandos do B2 (b2), usando uma chave que possa alterar as definições do bucket.

  1. Instale a CLI, por exemplo com pip install b2.
  2. Inicie sessão 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 adicionar ao bucket Passo CORS com a regra a adicionar ao bucket

Depois de a aplicar, volte ao Nubbo e prima Já a adicionei, verificar. Se a sua chave tiver permissão para alterar o CORS, Tentar configurá-lo por mim faz isso por si.

Se algo correr mal

Mensagem no NubboO que fazer
“Esta chave parece limitada a um bucket. Pode continuar pelo caminho limitado ou criar uma chave com acesso total.”Prima Continuar com chave limitada, ou crie uma chave com acesso a toda a conta e prima Experimentar outra chave.
“Bucket não encontrado. Verifique o nome e a região.”Confirme o nome exato do bucket e que a região escolhida é a do bucket.
“A sua chave não tem permissão para criar buckets.”Use uma chave com acesso total, ou crie o bucket no seu painel e prima Já o criei no meu painel.
“Esse nome já está em uso neste fornecedor; experimente outro.”Os nomes de bucket são únicos em todo o fornecedor: escolha outro.
“A sua chave não tem permissão para o configurar.”Adicione a regra CORS à mão, como explicado acima.
“Ainda não funciona. Reveja a regra e volte a verificar; alguns fornecedores demoram um minuto a aplicá-la.”Confirme que a origem é exatamente https://nubbo.app, sem barra no fim, espere um minuto e volte a verificar.
“Este bucket já está a ser utilizado.”Esse bucket já está ligado no Nubbo, na sua conta ou noutra.
“Credenciais inválidas. Verifique a chave de acesso e a chave de acesso secreta.”Confirme que não está a usar a master application key, que não funciona com a API S3.
“O bucket está numa 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 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.

Que 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 estão na mesma região.

Porque é que o CORS se configura com a CLI do B2?

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

Porque é que eliminar no Nubbo não liberta espaço no B2?

Porque o B2 guarda as versões anteriores por omissã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 fornecedores alteram-nos, por isso confirme antes de se comprometer.