Guías

Gestor de archivos para Cloudflare R2: conéctalo a Nubbo

Cómo conectar un bucket de Cloudflare R2 a Nubbo: el token de API, el Account ID, el asistente paso a paso, la regla de CORS y qué hacer si algo falla.

Nubbo se conecta a Cloudflare R2 con un token de API de R2 y el Account ID de tu cuenta. En unos minutos tienes tus buckets en un explorador de archivos con subidas directas, enlaces para compartir y galerías. Esta guía sigue el asistente de Nubbo paso a paso, con los dos caminos: automático o con una clave limitada a un bucket.

Qué consigues

  • Explorar el bucket como un disco: carpetas, vistas, búsqueda, papelera, etiquetas y favoritos.
  • Subir y descargar archivos directamente entre tu navegador y Cloudflare R2. Los archivos no pasan por los servidores de Nubbo.
  • Compartir archivos y carpetas con contraseña, caducidad y límite de descargas, recibir archivos en tu bucket y crear galerías.
  • Tus claves se guardan cifradas con AES-256-GCM y puedes desconectar el bucket cuando quieras.

Antes de empezar

Necesitas una cuenta en Cloudflare R2 y una cuenta de Nubbo. Cada bucket que conectas cuenta para el límite de tu plan: Gratuito permite 2, Personal 5 y Pro no tiene límite. Antes de crear tu primer bucket, Cloudflare te pide activar la suscripción de R2 desde el panel. Si tu bucket tiene jurisdicción (EU, FedRAMP o US), la eliges en el asistente y Nubbo usa el endpoint de esa jurisdicción.

Elige cómo conectar

El asistente de Nubbo ofrece dos caminos. Los dos acaban igual: el bucket conectado y listo para subir archivos desde el navegador.

AutomáticoCon clave limitada
ClaveCon acceso a toda la cuentaLimitada a un bucket
BucketNubbo usa uno tuyo o crea uno nuevoLo creas tú antes
CORSNubbo añade la regla por tiAñades tú la regla
Cuándo elegirloLo más rápidoSi no quieres dar acceso a toda la cuenta

La clave limitada es el acceso mínimo que Nubbo necesita: Object Read & Write sobre un bucket. Con ella Nubbo no puede listar tus buckets ni crear uno, así que escribes el nombre del bucket y añades tú la regla de CORS.

Conexión automática

Paso 1: crea la clave en Cloudflare R2

  1. Entra en dash.cloudflare.com y abre R2 object storage. El panel puede mostrar los menús en tu idioma.
  2. Abre API Tokens y pulsa Create Account API token. También llegas desde Overview, en Account Details, Manage.
  3. Elige el permiso Admin Read & Write y crea el token.
  4. Copia el Access Key ID y el Secret Access Key. Cloudflare solo muestra el secret una vez. Usa estas dos claves, no el valor del token.
  5. Copia también tu Account ID, que aparece en la página Overview.

Paso 2: conecta el bucket en Nubbo

  1. En Nubbo, abre Buckets y pulsa Conectar bucket. Elige Cloudflare R2 y pulsa Continuar.

    Paso Proveedor del asistente de Nubbo con Cloudflare R2 seleccionado Paso Proveedor del asistente de Nubbo con Cloudflare R2 seleccionado
  2. Elige Automático y pulsa Continuar.

    Paso Cómo conectar con las opciones Automático y Con clave limitada Paso Cómo conectar con las opciones Automático y Con clave limitada
  3. En el paso Tu clave, pega el Access Key ID, el Secret Access Key y el Account ID y elige la Jurisdicción de tu bucket: Por defecto (sin jurisdicción) para la mayoría, o EU, FedRAMP o US. Con el Account ID y la jurisdicción, Nubbo arma el endpoint, por ejemplo https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com para la UE. La lista solo muestra los buckets de esa jurisdicción y un bucket nuevo se crea en ella. La región de R2 es siempre auto. Pulsa Comprobar clave. Nubbo comprueba que la clave funciona y que tiene acceso a toda la cuenta.

    Paso Tu clave para Cloudflare R2 con la guía rápida y los campos de la clave Paso Tu clave para Cloudflare R2 con la guía rápida y los campos de la clave
  4. Elige uno de tus buckets y pulsa Usar este bucket, o marca Crear uno nuevo, escribe un nombre (y elige la región, si te la pide) y pulsa Crear y preparar. Nubbo añade al bucket una regla de CORS que solo permite subir y descargar desde la app y mantiene las reglas que ya tenga.

    Paso Tu bucket con la lista de buckets y la opción Crear uno nuevo Paso Tu bucket con la lista de buckets y la opción Crear uno nuevo
  5. Revisa las tres comprobaciones, cambia el Nombre en Nubbo si quieres y pulsa Terminar. El bucket aparece en Buckets y ya puedes abrirlo en el explorador.

    Paso Listo con las comprobaciones de conexión, bucket y CORS Paso Listo con las comprobaciones de conexión, bucket y CORS

Si Nubbo no puede añadir la regla de CORS con tu clave, el asistente te lleva al paso CORS. Sigue entonces la sección Añade la regla de CORS.

Conexión con clave limitada

Paso 1: prepara el bucket y la clave en Cloudflare R2

  1. En R2 object storage, pulsa Create bucket y ponle un nombre (minúsculas, números y guiones). No hace falta elegir región. Si los datos deben quedarse en la UE, elige la jurisdicción EU: el endpoint cambia con ella.
  2. Abre API Tokens y pulsa Create Account API token.
  3. Elige el permiso Object Read & Write y limítalo a tu bucket.
  4. Copia el Access Key ID, el Secret Access Key y tu Account ID.

Paso 2: conecta el bucket en Nubbo

  1. En Buckets, pulsa Conectar bucket, elige Cloudflare R2 y después Con clave limitada.
  2. Pega el Access Key ID, el Secret Access Key y el Account ID, elige la misma Jurisdicción que el bucket y pulsa Comprobar clave.
  3. Escribe el nombre exacto del bucket y pulsa Comprobar acceso.
  4. El asistente pasa al paso CORS con la regla que tienes que añadir.

Añade la regla de CORS

La regla de CORS permite que el navegador suba y descargue archivos de tu bucket desde https://nubbo.app. Es la misma que muestra el paso CORS del asistente.

  1. En R2, abre el bucket y entra en Settings.
  2. En CORS Policy, pulsa Add CORS policy y elige la pestaña JSON.
  3. Pega la regla y pulsa Save. Cloudflare puede tardar hasta 30 segundos en aplicarla.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Paso CORS con la regla que hay que añadir al bucket Paso CORS con la regla que hay que añadir al bucket

Cuando la hayas guardado, vuelve a Nubbo y pulsa Ya la he añadido, comprobar. Si tu clave tiene permiso para cambiar el CORS, Intentar configurarlo por mí lo hace por ti.

Si algo falla

Mensaje en NubboQué hacer
«Esta clave parece limitada a un bucket. Puedes seguir con el camino limitado o crear una clave con acceso completo.»Pulsa Seguir con clave limitada o crea una clave con acceso a toda la cuenta y pulsa Probar otra clave.
«Tu clave no tiene permiso para crear buckets.»Usa una clave con acceso completo o crea el bucket en tu panel y pulsa Ya lo he creado en mi panel.
«Ese nombre ya está en uso en este proveedor; prueba con otro.»Los nombres de bucket son únicos en todo el proveedor: elige otro.
«Tu clave no tiene permiso para configurarlo.»Añade la regla de CORS a mano, como se explica arriba.
«Aún no funciona. Revisa la regla y vuelve a comprobar; algunos proveedores tardan un minuto en aplicarla.»Comprueba que el origen sea exactamente https://nubbo.app, sin barra final, espera un minuto y vuelve a comprobar.
«Este bucket ya está en uso.»Ese bucket ya está conectado en Nubbo, en tu cuenta o en otra.
«Las credenciales no son válidas. Revisa la access key y la secret access key.»Comprueba que has pegado el Access Key ID y el Secret Access Key del token, no el valor del token de API de Cloudflare.
«No se ha encontrado el bucket. Verifica el nombre y la región.»Revisa el nombre y que la Jurisdicción en Nubbo sea la del bucket (R2 la muestra en Settings del bucket).

Cuánto cuesta

R2 no cobra la salida de datos y tiene un nivel gratuito mensual. Lo explicamos en Nivel gratuito de Cloudflare R2.

Preguntas frecuentes

¿Dónde encuentro el Account ID de Cloudflare?

En la página Overview de R2, en el apartado Account Details. Es una cadena de 32 caracteres con números y letras de la a a la f.

¿Qué permiso necesita el token de R2?

El acceso mínimo que Nubbo necesita es Object Read & Write limitado a tu bucket, con el camino de clave limitada: escribes el nombre del bucket y añades tú la regla de CORS. El camino automático necesita Admin Read & Write, que deja a Nubbo listar tus buckets, crear uno y configurar su CORS.

¿Qué región uso con R2?

Ninguna: R2 usa la región auto y Nubbo la pone por ti. Las sugerencias de ubicación de Cloudflare no cambian cómo se conecta el bucket.

¿Puedo conectar un bucket de R2 con jurisdicción, como la de la UE?

Sí. En el paso Tu clave, elige la jurisdicción del bucket (EU, FedRAMP o US). Cada una tiene su propio endpoint, como https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, y solo muestra los buckets creados en ella.

¿Descargar desde Nubbo me cuesta salida de datos en R2?

No. R2 no cobra la salida de datos. Las descargas sí cuentan como operaciones de lectura.

Fuentes

Los precios y límites salen de las páginas oficiales de abajo. Los proveedores los cambian, así que compruébalos antes de decidir.