Guías

Xestor de ficheiros para Cloudflare R2: conéctao a Nubbo

Como conectar un bucket de Cloudflare R2 a Nubbo: o token da API, o Account ID, o asistente paso a paso, a regra de CORS e que facer se algo falla.

Nubbo conéctase a Cloudflare R2 cun token da API de R2 e o Account ID da túa conta. En poucos minutos tes os teus buckets nun explorador de ficheiros con subidas directas, ligazóns para compartir e galerías. Esta guía segue o asistente de Nubbo paso a paso, cos dous camiños: automático ou cunha chave limitada a un bucket.

Que consegues

  • Explorar o bucket coma un disco: cartafoles, vistas, busca, papeleira, etiquetas e favoritos.
  • Subir e descargar ficheiros directamente entre o teu navegador e Cloudflare R2. Os ficheiros nunca pasan polos servidores de Nubbo.
  • Compartir ficheiros e cartafoles con contrasinal, caducidade e límite de descargas, recibir ficheiros no teu bucket e crear galerías.
  • As túas chaves gárdanse cifradas con AES-256-GCM e podes desconectar o bucket cando queiras.

Antes de comezar

Necesitas unha conta en Cloudflare R2 e unha conta de Nubbo. Cada bucket que conectas conta para o límite do teu plan: Gratuíto permite 2, Personal 5 e Pro non ten límite. Antes do teu primeiro bucket, Cloudflare pídeche activar a subscrición de R2 desde o panel. Se o teu bucket ten xurisdición (EU, FedRAMP ou US), escóllela no asistente e Nubbo usa o endpoint desa xurisdición.

Escolle como conectar

O asistente de Nubbo ofrece dous camiños. Os dous rematan igual: o bucket conectado e listo para subir ficheiros desde o navegador.

AutomáticoCon chave limitada
ChaveCon acceso a toda a contaLimitada a un bucket
BucketNubbo usa un teu ou crea un novoCréalo ti antes
CORSNubbo engade a regra por tiEngades ti a regra
Cando escolleloO máis rápidoSe non queres dar acceso a toda a conta

A chave limitada é o acceso mínimo que Nubbo necesita: Object Read & Write sobre un bucket. Con ela Nubbo non pode listar os teus buckets nin crear un, así que escribes o nome do bucket e engades ti a regra de CORS.

Conexión automática

Paso 1: crea a chave en Cloudflare R2

  1. Entra en dash.cloudflare.com e abre R2 object storage. O panel pode mostrar os menús no teu idioma.
  2. Abre API Tokens e preme Create Account API token. Tamén chegas desde Overview, en Account Details, Manage.
  3. Escolle o permiso Admin Read & Write e crea o token.
  4. Copia o Access Key ID e o Secret Access Key. Cloudflare mostra a secret só unha vez. Usa estas dúas chaves, non o valor do token.
  5. Copia tamén o teu Account ID, que aparece na páxina Overview de R2.

Paso 2: conecta o bucket en Nubbo

  1. En Nubbo, abre Buckets e preme Conectar bucket. Escolle Cloudflare R2 e preme Continuar.

    Paso Provedor do asistente de Nubbo con Cloudflare R2 seleccionado Paso Provedor do asistente de Nubbo con Cloudflare R2 seleccionado
  2. Escolle Automático e preme Continuar.

    Paso Como conectar coas opcións Automático e Con chave limitada Paso Como conectar coas opcións Automático e Con chave limitada
  3. No paso A túa chave, pega o Access Key ID, o Secret Access Key e o Account ID. Nubbo constrúe o endpoint da túa conta a partir do Account ID. A rexión de R2 é sempre auto. Antes de premer Comprobar chave, escolle a Xurisdición do teu bucket: Predeterminada (sen xurisdición) para a maioría, ou EU, FedRAMP ou US. O endpoint cambia con ela (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com para a UE) e a lista só mostra os buckets desa xurisdición. Preme Comprobar chave. Nubbo comproba que a chave funciona e que ten acceso a toda a conta.

    Paso A túa chave para Cloudflare R2 coa guía rápida e os campos da chave Paso A túa chave para Cloudflare R2 coa guía rápida e os campos da chave
  4. Escolle un dos teus buckets e preme Usar este bucket, ou marca Crear un novo, escribe un nome (e escolle a rexión, se cha pide) e preme Crear e preparar. Nubbo engade ao bucket unha regra de CORS que só permite subir e descargar desde a app e mantén as regras que xa teña.

    Paso O teu bucket coa lista de buckets e a opción Crear un novo Paso O teu bucket coa lista de buckets e a opción Crear un novo
  5. Revisa as tres comprobacións, cambia o Nome en Nubbo se queres e preme Rematar. O bucket aparece en Buckets e xa podes abrilo no explorador.

    Paso Listo coas comprobacións de conexión, bucket e CORS Paso Listo coas comprobacións de conexión, bucket e CORS

Se Nubbo non pode engadir a regra de CORS coa túa chave, o asistente lévate ao paso CORS. Segue entón a sección Engade a regra de CORS.

Conexión con chave limitada

Paso 1: prepara o bucket e a chave en Cloudflare R2

  1. En R2, Overview, preme Create bucket e ponlle un nome (minúsculas, números e guións). Non hai rexión que escoller. Se os datos deben quedar na UE, escolle a xurisdición EU: o endpoint cambia con ela.
  2. Abre API Tokens e preme Create Account API token.
  3. Escolle o permiso Object Read & Write e limítao ao teu bucket.
  4. Copia o Access Key ID, o Secret Access Key e o teu Account ID.

Paso 2: conecta o bucket en Nubbo

  1. En Buckets, preme Conectar bucket, escolle Cloudflare R2 e despois Con chave limitada.
  2. Pega o Access Key ID, o Secret Access Key e o Account ID. Antes de premer Comprobar chave, escolle a mesma Xurisdición que o bucket. Preme Comprobar chave.
  3. Escribe o nome exacto do bucket e preme Comprobar acceso.
  4. O asistente pasa ao paso CORS coa regra que tes que engadir.

Engade a regra de CORS

A regra de CORS permite que o navegador suba e descargue ficheiros do teu bucket desde https://nubbo.app. É a mesma regra que mostra o paso CORS do asistente.

  1. En R2, abre o bucket e entra en Settings.
  2. En CORS Policy, preme Add CORS policy e escolle a lapela JSON.
  3. Pega a regra e preme Save. Cloudflare pode tardar ata 30 segundos en aplicala.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Paso CORS coa regra que hai que engadir ao bucket Paso CORS coa regra que hai que engadir ao bucket

Cando a gardes, volve a Nubbo e preme Xa a engadín, comprobar. Se a túa chave ten permiso para cambiar o CORS, Tentar configuralo por min faino por ti.

Se algo falla

Mensaxe en NubboQue facer
«Esta chave parece limitada a un bucket. Podes seguir co camiño limitado ou crear unha chave con acceso completo.»Preme Seguir con chave limitada ou crea unha chave con acceso a toda a conta e preme Probar outra chave.
«A túa chave non ten permiso para crear buckets.»Usa unha chave con acceso completo ou crea o bucket no teu panel e preme Xa o creei no meu panel.
«Ese nome xa está en uso neste provedor; proba con outro.»Os nomes de bucket son únicos en todo o provedor: escolle outro.
«A túa chave non ten permiso para configuralo.»Engade a regra de CORS a man, como se explica arriba.
«Aínda non funciona. Revisa a regra e volve comprobar; algúns provedores tardan un minuto en aplicala.»Comproba que a orixe sexa exactamente https://nubbo.app, sen barra final, agarda un minuto e volve comprobar.
«Este bucket xa está en uso.»Ese bucket xa está conectado en Nubbo, na túa conta ou noutra.
«As credenciais non son válidas. Revisa a access key e a secret access key.»Comproba que pegaches o Access Key ID e o Secret Access Key do token, non o valor do token da API de Cloudflare.
«Non se atopou o bucket. Verifica o nome e a rexión.»Revisa o nome e que a xurisdición en Nubbo sexa a do bucket (R2 móstraa en Settings do bucket).

Canto custa

R2 non cobra pola saída de datos e ten un nivel gratuíto mensual. Explicámolo en Nivel gratuíto de Cloudflare R2.

Preguntas frecuentes

Onde atopo o meu Account ID de Cloudflare?

Na páxina Overview de R2, en Account Details. É unha cadea de 32 caracteres con números e as letras da a á f.

Que permiso necesita o token de R2?

O acceso mínimo que Nubbo necesita é Object Read & Write limitado ao teu bucket, co camiño de chave limitada: escribes o nome do bucket e engades ti a regra de CORS. O camiño automático necesita Admin Read & Write, que deixa a Nubbo listar os teus buckets, crear un e configurar o seu CORS.

Que rexión uso con R2?

Ningunha: R2 usa a rexión auto e Nubbo ponla por ti. Os location hints de Cloudflare non cambian como se conecta o bucket.

Podo conectar un bucket de R2 con xurisdición, como a da UE?

Si. No paso A túa chave, escolle a xurisdición do bucket (EU, FedRAMP ou US). Cada unha ten o seu propio endpoint, como https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, e só mostra os buckets creados nela.

As descargas desde Nubbo custan saída de datos en R2?

Non. R2 non cobra pola saída de datos. As descargas si contan como operacións de lectura.

Fontes

Os prezos e límites saen das páxinas oficiais de abaixo. Os provedores cámbianos, así que compróbaos antes de decidir.