Vodniki

Upravitelj datotek za Cloudflare R2: poveži ga z Nubbo

Kako povezati bucket Cloudflare R2 z Nubbo: žeton API, Account ID, čarovnik po korakih, pravilo CORS in kaj storiti, če gre kaj narobe.

Nubbo se s Cloudflare R2 poveže z žetonom API za R2 in z Account ID tvojega računa. V nekaj minutah imaš svoje buckete v raziskovalcu datotek z neposrednim nalaganjem, povezavami za deljenje in galerijami. Ta vodnik po korakih sledi čarovniku Nubbo in pokriva obe poti: samodejno ali s ključem, omejenim na en bucket.

Kaj dobiš

  • Brskaš po bucketu kot po disku: mape, pogledi, iskanje, koš, oznake in priljubljene.
  • Datoteke nalagaš in prenašaš neposredno med brskalnikom in Cloudflare R2. Datoteke nikoli ne gredo skozi strežnike Nubbo.
  • Deliš datoteke in mape z geslom, rokom veljavnosti in omejitvijo prenosov, prejemaš datoteke v svoj bucket in ustvarjaš galerije.
  • Tvoji ključi so shranjeni šifrirani z AES-256-GCM, bucket pa lahko kadar koli odklopiš.

Preden začneš

Potrebuješ račun pri Cloudflare R2 in račun Nubbo. Vsak bucket, ki ga povežeš, se šteje v omejitev tvojega paketa: paket Brezplačno jih dovoli 2, Personal 5, Pro pa nima omejitve. Pred prvim bucketom te Cloudflare prosi, da na nadzorni plošči aktiviraš naročnino R2. Če ima tvoj bucket jurisdikcijo (EU, FedRAMP ali US), jo izbereš v čarovniku in Nubbo uporablja končno točko te jurisdikcije.

Izberi način povezave

Čarovnik Nubbo ponuja dve poti. Obe se končata enako: bucket je povezan in pripravljen za nalaganje iz brskalnika.

SamodejnoZ omejenim ključem
KljučDostop do celotnega računaOmejen na en bucket
BucketNubbo uporabi enega od tvojih ali ustvari novegaNajprej ga ustvariš sam
CORSNubbo doda pravilo namesto tebePravilo dodaš sam
Kdaj ga izbratiNajhitrejša potKo ne želiš dati dostopa do celotnega računa

Omejen ključ je najmanjši dostop, ki ga Nubbo potrebuje: Object Read & Write za en bucket. Z njim Nubbo ne more prikazati tvojih bucketov ali ustvariti novega, zato vpišeš ime bucketa in sam dodaš pravilo CORS.

Samodejna povezava

1. korak: ustvari ključ v Cloudflare R2

  1. Prijavi se v dash.cloudflare.com in odpri R2 object storage. Nadzorna plošča lahko prikazuje menije v tvojem jeziku.
  2. Odpri API Tokens in pritisni Create Account API token. Do tja prideš tudi iz Overview, pod Account Details, Manage.
  3. Izberi dovoljenje Admin Read & Write in ustvari žeton.
  4. Kopiraj Access Key ID in Secret Access Key. Cloudflare skrivnost prikaže samo enkrat. Uporabi ta dva ključa, ne vrednosti žetona.
  5. Kopiraj tudi svoj Account ID, ki je prikazan na strani R2 Overview.

2. korak: poveži bucket v Nubbo

  1. V Nubbo odpri Bucketi in pritisni Poveži bucket. Izberi Cloudflare R2 in pritisni Nadaljuj.

    Korak Ponudnik v čarovniku Nubbo z izbranim Cloudflare R2 Korak Ponudnik v čarovniku Nubbo z izbranim Cloudflare R2
  2. Izberi Samodejno in pritisni Nadaljuj.

    Korak Način povezave z možnostma Samodejno in Z omejenim ključem Korak Način povezave z možnostma Samodejno in Z omejenim ključem
  3. V koraku Tvoj ključ prilepi Access Key ID, Secret Access Key in Account ID. Nubbo iz Account ID sestavi endpoint tvojega računa. Regija R2 je vedno auto. Preden pritisneš Preveri ključ, izberi Jurisdikcija svojega bucketa: Privzeta (brez jurisdikcije) za večino bucketov, ali EU, FedRAMP ali US. Končna točka se spremeni z njo (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com za EU), seznam pa prikaže samo buckete te jurisdikcije. Pritisni Preveri ključ. Nubbo preveri, ali ključ deluje in ali ima dostop do celotnega računa.

    Korak Tvoj ključ za Cloudflare R2 s hitrim vodnikom in polji za ključ Korak Tvoj ključ za Cloudflare R2 s hitrim vodnikom in polji za ključ
  4. Izberi enega od svojih bucketov in pritisni Uporabi ta bucket ali pa označi Ustvari novega, vpiši ime (in izberi regijo, če jo zahteva) ter pritisni Ustvari in pripravi. Nubbo bucketu doda pravilo CORS, ki dovoljuje nalaganje in prenašanje samo iz aplikacije, obstoječa pravila pa ohrani.

    Korak Tvoj bucket s seznamom bucketov in možnostjo Ustvari novega Korak Tvoj bucket s seznamom bucketov in možnostjo Ustvari novega
  5. Preglej tri preverjanja, po želji spremeni Ime v Nubbo in pritisni Končaj. Bucket se prikaže v razdelku Bucketi in ga lahko odpreš v raziskovalcu.

    Korak Končano s preverjanji povezave, bucketa in CORS Korak Končano s preverjanji povezave, bucketa in CORS

Če Nubbo s tvojim ključem ne more dodati pravila CORS, te čarovnik pelje na korak CORS. Takrat sledi razdelku Dodaj pravilo CORS.

Povezava z omejenim ključem

1. korak: pripravi bucket in ključ v Cloudflare R2

  1. V R2, Overview pritisni Create bucket in mu daj ime (male črke, številke in vezaji). Regije ni treba izbrati. Če morajo podatki ostati v EU, izberi jurisdikcijo EU: končna točka se spremeni z njo.
  2. Odpri API Tokens in pritisni Create Account API token.
  3. Izberi dovoljenje Object Read & Write in ga omeji na svoj bucket.
  4. Kopiraj Access Key ID, Secret Access Key in svoj Account ID.

2. korak: poveži bucket v Nubbo

  1. V razdelku Bucketi pritisni Poveži bucket, izberi Cloudflare R2 in nato Z omejenim ključem.
  2. Prilepi Access Key ID, Secret Access Key in Account ID. Preden pritisneš Preveri ključ, izberi isto Jurisdikcija kot pri bucketu. Pritisni Preveri ključ.
  3. Vpiši natančno ime bucketa in pritisni Preveri dostop.
  4. Čarovnik preide na korak CORS s pravilom, ki ga moraš dodati.

Dodaj pravilo CORS

Pravilo CORS brskalniku omogoča nalaganje in prenašanje datotek iz tvojega bucketa na https://nubbo.app. To je isto pravilo, ki ga čarovnik prikaže v koraku CORS.

  1. V R2 odpri bucket in pojdi na Settings.
  2. Pod CORS Policy pritisni Add CORS policy in izberi zavihek JSON.
  3. Prilepi pravilo in pritisni Save. Cloudflare lahko potrebuje do 30 sekund, da ga uveljavi.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Korak CORS s pravilom, ki ga je treba dodati bucketu Korak CORS s pravilom, ki ga je treba dodati bucketu

Ko je shranjeno, se vrni v Nubbo in pritisni Dodano, preveri. Če ima tvoj ključ dovoljenje za spreminjanje CORS, to namesto tebe naredi Poskusi ga nastaviti namesto mene.

Če gre kaj narobe

Sporočilo v NubboKaj storiti
“Ta ključ je videti omejen na en bucket. Lahko nadaljuješ po omejeni poti ali ustvariš ključ s polnim dostopom.”Pritisni Nadaljuj z omejenim ključem ali ustvari ključ z dostopom do celotnega računa in pritisni Poskusi drug ključ.
“Tvoj ključ nima dovoljenja za ustvarjanje bucketov.”Uporabi ključ s polnim dostopom ali ustvari bucket v svoji nadzorni plošči in pritisni Že ga imam v svoji nadzorni plošči.
“To ime je pri tem ponudniku že v uporabi; poskusi z drugim.”Imena bucketov so pri ponudniku edinstvena: izberi drugo.
“Tvoj ključ nima dovoljenja, da bi to nastavil.”Pravilo CORS dodaj ročno, kot je razloženo zgoraj.
“Še ne deluje. Preglej pravilo in preveri znova; nekateri ponudniki potrebujejo minuto, da ga uveljavijo.”Preveri, ali je izvor natanko https://nubbo.app brez poševnice na koncu, počakaj minuto in preveri znova.
“Ta bucket je že v uporabi.”Ta bucket je v Nubbo že povezan, v tvojem ali v drugem računu.
“Neveljavne poverilnice. Preveri dostopni ključ in skrivni dostopni ključ.”Preveri, ali si prilepil Access Key ID in Secret Access Key žetona, ne vrednosti žetona API Cloudflare.
“Bucket ni najden. Preveri ime in regijo.”Preveri ime in ali se jurisdikcija v Nubbu ujema z jurisdikcijo bucketa (R2 jo prikaže v Settings bucketa).

Koliko stane

R2 ne zaračunava odhodnega prometa in ima mesečno brezplačno raven. Razložimo v članku Brezplačna raven Cloudflare R2.

Pogosta vprašanja

Kje najdem svoj Cloudflare Account ID?

Na strani R2 Overview, pod Account Details. To je niz 32 znakov iz številk in črk od a do f.

Katero dovoljenje potrebuje žeton R2?

Najmanjši dostop, ki ga Nubbo potrebuje, je Object Read & Write, omejen na tvoj bucket, s potjo z omejenim ključem: vpišeš ime bucketa in sam dodaš pravilo CORS. Samodejna pot potrebuje Admin Read & Write, s katerim Nubbo prikaže tvoje buckete, ustvari novega in nastavi njegov CORS.

Katero regijo uporabim z R2?

Nobene: R2 uporablja regijo auto in Nubbo jo nastavi namesto tebe. Namigi o lokaciji v Cloudflare ne spremenijo načina povezave bucketa.

Ali lahko povežem bucket R2 z jurisdikcijo, na primer EU?

Da. V koraku Tvoj ključ izberi jurisdikcijo bucketa (EU, FedRAMP ali US). Vsaka ima svojo končno točko, na primer https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, in prikaže samo buckete, ustvarjene v njej.

Ali prenosi iz Nubbo na R2 stanejo odhodni promet?

Ne. R2 ne zaračunava odhodnega prenosa podatkov. Prenosi pa štejejo kot operacije branja.

Viri

Cene in omejitve so povzete po spodnjih uradnih straneh. Ponudniki jih spreminjajo, zato jih preveri, preden se odločiš.