Guies

Gestor de fitxers per a Cloudflare R2: connecta'l a Nubbo

Com connectar un bucket de Cloudflare R2 a Nubbo: el token d'API, l'Account ID, l'assistent pas a pas, la regla de CORS i què fer si alguna cosa falla.

Nubbo es connecta a Cloudflare R2 amb un token d’API d’R2 i l’Account ID del teu compte. En pocs minuts tens els buckets en un explorador de fitxers amb pujades directes, enllaços per compartir i galeries. Aquesta guia segueix l’assistent de Nubbo pas a pas, pels dos camins: automàtic o amb una clau limitada a un bucket.

Què aconsegueixes

  • Explora el bucket com si fos un disc: carpetes, vistes, cerca, paperera, etiquetes i preferits.
  • Puja i baixa fitxers directament entre el teu navegador i Cloudflare R2. Els fitxers mai passen pels servidors de Nubbo.
  • Comparteix fitxers i carpetes amb contrasenya, caducitat i límit de baixades, rep fitxers al teu bucket i crea galeries.
  • Les teves claus es guarden xifrades amb AES-256-GCM i pots desconnectar el bucket quan vulguis.

Abans de començar

Necessites un compte de Cloudflare R2 i un compte de Nubbo. Cada bucket que connectes compta per al límit del teu pla: Gratuït en permet 2, Personal 5 i Pro no té límit. Abans del primer bucket, Cloudflare et demana que activis la subscripció a R2 des del dashboard. Si el teu bucket té jurisdicció (EU, FedRAMP o US), la tries a l’assistent i Nubbo fa servir l’endpoint d’aquesta jurisdicció.

Tria com connectar

L’assistent de Nubbo ofereix dos camins. Tots dos acaben igual: el bucket connectat i preparat per pujar fitxers des del navegador.

AutomàticAmb clau limitada
ClauAccés a tot el compteLimitada a un bucket
BucketNubbo en fa servir un dels teus o en crea un de nouEl crees tu primer
CORSNubbo hi afegeix la regla per tuHi afegeixes tu la regla
Quan triar-loLa via més ràpidaQuan no vols donar accés a tot el compte

La clau limitada és l’accés mínim que Nubbo necessita: Object Read & Write sobre un bucket. Amb ella Nubbo no pot llistar els teus buckets ni crear-ne un, així que escrius el nom del bucket i afegeixes tu la regla de CORS.

Connexió automàtica

Pas 1: crea la clau a Cloudflare R2

  1. Entra a dash.cloudflare.com i obre R2 object storage. El tauler pot mostrar els menús en el teu idioma.
  2. Obre API Tokens i prem Create Account API token. També hi arribes des de Overview, a Account Details, Manage.
  3. Tria el permís Admin Read & Write i crea el token.
  4. Copia l’Access Key ID i la Secret Access Key. Cloudflare només mostra el secret una vegada. Fes servir aquestes dues claus, no el valor del token.
  5. Copia també el teu Account ID, que apareix a la pàgina Overview d’R2.

Pas 2: connecta el bucket a Nubbo

  1. A Nubbo, obre Buckets i prem Connecta un bucket. Tria Cloudflare R2 i prem Continua.

    Pas Proveïdor de l'assistent de Nubbo amb Cloudflare R2 seleccionat Pas Proveïdor de l'assistent de Nubbo amb Cloudflare R2 seleccionat
  2. Tria Automàtic i prem Continua.

    Pas Com connectar amb les opcions Automàtic i Amb clau limitada Pas Com connectar amb les opcions Automàtic i Amb clau limitada
  3. Al pas La teva clau, enganxa l’Access Key ID, la Secret Access Key i l’Account ID. Nubbo construeix l’endpoint del teu compte a partir de l’Account ID. La regió d’R2 sempre és auto. Abans de prémer Comprova la clau, tria la Jurisdicció del teu bucket: Per defecte (sense jurisdicció) per a la majoria, o EU, FedRAMP o US. L’endpoint canvia amb ella (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com per a la UE) i la llista només mostra els buckets d’aquesta jurisdicció. Prem Comprova la clau. Nubbo comprova que la clau funciona i que té accés a tot el compte.

    Pas La teva clau de Cloudflare R2 amb la guia ràpida i els camps de la clau Pas La teva clau de Cloudflare R2 amb la guia ràpida i els camps de la clau
  4. Tria un dels teus buckets i prem Fes servir aquest bucket, o selecciona Crea’n un de nou, escriu un nom (i tria la regió, si te la demana) i prem Crea i prepara. Nubbo afegeix al bucket una regla de CORS que només permet pujades i baixades des de l’app, i conserva les regles que ja tenia.

    Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou
  5. Revisa les tres comprovacions, canvia el Nom a Nubbo si vols i prem Acaba. El bucket apareix a Buckets i el pots obrir a l’explorador.

    Pas Fet amb les comprovacions de connexió, bucket i CORS Pas Fet amb les comprovacions de connexió, bucket i CORS

Si Nubbo no pot afegir la regla de CORS amb la teva clau, l’assistent et porta al pas CORS. Llavors segueix Afegeix la regla de CORS.

Connexió amb clau limitada

Pas 1: prepara el bucket i la clau a Cloudflare R2

  1. A R2, Overview, prem Create bucket i posa-li un nom (minúscules, números i guions). No hi ha cap regió per triar. Si les dades s’han de quedar a la UE, tria la jurisdicció EU: l’endpoint canvia amb ella.
  2. Obre API Tokens i prem Create Account API token.
  3. Tria el permís Object Read & Write i limita’l al teu bucket.
  4. Copia l’Access Key ID, la Secret Access Key i el teu Account ID.

Pas 2: connecta el bucket a Nubbo

  1. A Buckets, prem Connecta un bucket, tria Cloudflare R2 i després Amb clau limitada.
  2. Enganxa l’Access Key ID, la Secret Access Key i l’Account ID. Abans de prémer Comprova la clau, tria la mateixa Jurisdicció que el bucket. Prem Comprova la clau.
  3. Escriu el nom exacte del bucket i prem Comprova l’accés.
  4. L’assistent passa al pas CORS amb la regla que has d’afegir.

Afegeix la regla de CORS

La regla de CORS permet que el navegador pugi i baixi fitxers del teu bucket a https://nubbo.app. És la mateixa regla que l’assistent mostra al pas CORS.

  1. A R2, obre el bucket i ves a Settings.
  2. A CORS Policy, prem Add CORS policy i tria la pestanya JSON.
  3. Enganxa la regla i prem Save. Cloudflare pot trigar fins a 30 segons a aplicar-la.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Pas CORS amb la regla que cal afegir al bucket Pas CORS amb la regla que cal afegir al bucket

Un cop desada, torna a Nubbo i prem Ja l’he afegida, comprova-ho. Si la teva clau té permís per canviar el CORS, Intenta configurar-ho per mi ho fa per tu.

Si alguna cosa falla

Missatge a NubboQuè fer
“Aquesta clau sembla limitada a un bucket. Pots continuar amb el camí limitat o crear una clau amb accés complet.”Prem Continua amb clau limitada, o crea una clau amb accés a tot el compte i prem Prova una altra clau.
“La teva clau no té permís per crear buckets.”Fes servir una clau amb accés complet, o crea el bucket al teu tauler i prem Ja l’he creat al meu tauler.
“Aquest nom ja està en ús en aquest proveïdor; prova’n un altre.”Els noms de bucket són únics a tot el proveïdor: tria’n un altre.
“La teva clau no té permís per configurar-ho.”Afegeix la regla de CORS a mà, com s’explica més amunt.
“Encara no funciona. Revisa la regla i torna-ho a comprovar; alguns proveïdors triguen un minut a aplicar-la.”Comprova que l’origen és exactament https://nubbo.app sense barra final, espera un minut i torna-ho a comprovar.
“Aquest bucket ja està en ús.”Aquest bucket ja està connectat a Nubbo, al teu compte o en un altre.
“Les credencials no són vàlides. Revisa l’access key i la secret access key.”Comprova que has enganxat l’Access Key ID i la Secret Access Key del token, no el valor del token d’API de Cloudflare.
“No s’ha trobat el bucket. Verifica el nom i la regió.”Revisa el nom i que la jurisdicció a Nubbo sigui la del bucket (R2 la mostra a Settings del bucket).

Quant costa

R2 no cobra per la sortida de dades i té un nivell gratuït mensual. T’ho expliquem a Nivell gratuït de Cloudflare R2.

Preguntes freqüents

On trobo el meu Account ID de Cloudflare?

A la pàgina Overview d'R2, a Account Details. És una cadena de 32 caràcters amb números i les lletres de la a a la f.

Quin permís necessita el token d'R2?

L'accés mínim que Nubbo necessita és Object Read & Write limitat al teu bucket, amb el camí de clau limitada: escrius el nom del bucket i afegeixes tu la regla de CORS. El camí automàtic necessita Admin Read & Write, que permet a Nubbo llistar els teus buckets, crear-ne un i configurar-ne el CORS.

Quina regió faig servir amb R2?

Cap: R2 fa servir la regió auto i Nubbo la configura per tu. Les location hints de Cloudflare no canvien com es connecta el bucket.

Puc connectar un bucket d'R2 amb jurisdicció, com la de la UE?

Sí. Al pas La teva clau, tria la jurisdicció del bucket (EU, FedRAMP o US). Cadascuna té el seu propi endpoint, com https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, i només mostra els buckets creats en ella.

Les baixades des de Nubbo costen sortida de dades a R2?

No. R2 no cobra per la transferència de dades de sortida. Les baixades sí que compten com a operacions de lectura.

Fonts

Els preus i els límits surten de les pàgines oficials de sota. Els proveïdors els canvien, així que comprova'ls abans de decidir.