Gestor de ficheiros para o Cloudflare R2: ligue-o ao Nubbo

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

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.

A chave limitada é o acesso mínimo de que o Nubbo precisa: Object Read & Write sobre um bucket. Com ela o Nubbo não pode listar os seus buckets nem criar um, por isso escreve o nome do bucket e adiciona a regra de CORS.

Ligação automática

Passo 1: crie a chave no Cloudflare R2

1. Inicie sessão em dash.cloudflare.com e abra R2 object storage. O painel pode mostrar os menus no seu idioma.
2. Abra API Tokens e prima Create Account API token. Também lá chega a partir de 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 estas 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: ligue o bucket no Nubbo

1. No Nubbo, abra Buckets e prima Ligar bucket. Escolha Cloudflare R2 e prima Continuar.

   

2. Escolha Automático e prima Continuar.

   

3. No passo A sua chave, cole o Access Key ID, a Secret Access Key e o Account ID. O Nubbo constrói o endpoint da sua conta a partir do Account ID. A região do R2 é sempre auto. Antes de premir Verificar chave, escolha a Jurisdição do seu bucket: Predefinida (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. Prima Verificar chave. O Nubbo verifica que a chave funciona e que tem acesso a toda a conta.

   

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.

   

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.

   

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

1. Em R2, Overview, prima Create bucket e dê-lhe um nome (letras minúsculas, números e hífenes). Não há região para escolher. Se os dados tiverem de ficar na UE, escolha a jurisdição EU: o endpoint muda com ela.
2. Abra API Tokens e prima 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: ligue o bucket no Nubbo

1. Em Buckets, prima Ligar 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 premir Verificar chave, escolha a mesma Jurisdição do bucket. 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.

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

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

Depois de a guardar, 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

Quanto custa

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