Gerenciador de arquivos para o Cloudflare R2: conecte ao Nubbo

O Nubbo se conecta ao Cloudflare R2 com um token de API do R2 e o Account ID 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 Cloudflare R2. 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 Cloudflare R2 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. Antes do seu primeiro bucket, a Cloudflare pede que você ative a assinatura do R2 pelo painel. Se o seu bucket tiver jurisdição (EU, FedRAMP ou US), você a escolhe no assistente e o Nubbo usa o endpoint dessa jurisdição.

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.

A chave limitada é o acesso mínimo de que o Nubbo precisa: Object Read & Write em um bucket. Com ela o Nubbo não consegue listar seus buckets nem criar um, então você digita o nome do bucket e adiciona a regra de CORS.

Conexão automática

Passo 1: crie a chave no Cloudflare R2

1. Entre em dash.cloudflare.com e abra R2 object storage. O painel pode mostrar os menus no seu idioma.
2. Abra API Tokens e clique em Create Account API token. Você também chega lá por Overview, em Account Details, Manage.
3. Escolha a permissão Admin Read & Write e crie o token.
4. Copie o Access Key ID e a Secret Access Key. A Cloudflare só mostra a secret uma vez. Use essas duas chaves, não o valor do token.
5. Copie também o seu Account ID, que aparece na página Overview do R2.

Passo 2: conecte o bucket no Nubbo

1. No Nubbo, abra Buckets e clique em Conectar bucket. Escolha Cloudflare R2 e clique em Continuar.

   

2. Escolha Automático e clique em Continuar.

   

3. No passo Sua chave, cole o Access Key ID, a Secret Access Key e o Account ID. O Nubbo monta o endpoint da sua conta a partir do Account ID. A região do R2 é sempre auto. Antes de clicar em Verificar chave, escolha a Jurisdição do seu bucket: Padrão (sem jurisdição) para a maioria dos buckets, ou EU, FedRAMP ou US. O endpoint muda com ela (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com para a UE) e a lista só mostra os buckets dessa jurisdição. Clique em Verificar chave. O Nubbo verifica se a chave funciona e se ela tem acesso à conta inteira.

   

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.

   

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.

   

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 Cloudflare R2

1. Em R2, Overview, clique em Create bucket e dê um nome a ele (letras minúsculas, números e hifens). Não há região para escolher. Se os dados precisarem ficar na UE, escolha a jurisdição EU: o endpoint muda com ela.
2. Abra API Tokens e clique em Create Account API token.
3. Escolha a permissão Object Read & Write e limite-a ao seu bucket.
4. Copie o Access Key ID, a Secret Access Key e o seu Account ID.

Passo 2: conecte o bucket no Nubbo

1. Em Buckets, clique em Conectar bucket, escolha Cloudflare R2 e depois Com uma chave limitada.
2. Cole o Access Key ID, a Secret Access Key e o Account ID. Antes de clicar em Verificar chave, escolha a mesma Jurisdição do bucket. 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.

1. Em R2, abra o bucket e vá em Settings.
2. Em CORS Policy, clique em Add CORS policy e escolha a aba JSON.
3. Cole a regra e clique em Save. A Cloudflare pode levar até 30 segundos para aplicá-la.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Depois de salvar, 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

Quanto custa

O R2 não cobra egress e tem um nível gratuito mensal. Explicamos tudo em Nível gratuito do Cloudflare R2.