Juhendid

Failihaldur Cloudflare R2 jaoks: ühenda see Nubboga

Kuidas ühendada Cloudflare R2 bucket Nubboga: API-tõend, Account ID, viisard samm-sammult, CORS-reegel ja mida teha, kui midagi ebaõnnestub.

Nubbo ühendub Cloudflare R2-ga R2 API-tõendi ja sinu konto Account ID abil. Mõne minutiga on sinu bucketid failihalduris koos otseste üleslaadimiste, jagamislinkide ja galeriidega. See juhend järgib Nubbo viisardit samm-sammult mõlemal teel: automaatselt või ühe bucketiga piiratud võtmega.

Mida sa saad

  • Sirvi bucketit nagu ketast: kaustad, vaated, otsing, prügikast, sildid ja lemmikud.
  • Laadi faile üles ja alla otse oma brauseri ja Cloudflare R2 vahel. Failid ei läbi kunagi Nubbo servereid.
  • Jaga faile ja kaustu parooli, aegumise ja allalaadimiste piiranguga, võta faile vastu oma bucketisse ja loo galeriisid.
  • Sinu võtmed salvestatakse AES-256-GCM-iga krüpteeritult ja saad bucketi igal ajal lahti ühendada.

Enne alustamist

Vajad Cloudflare R2 kontot ja Nubbo kontot. Iga ühendatud bucket arvestatakse sinu paketi limiidi hulka: Tasuta pakett lubab 2, Personal 5 ja Pro puhul piirangut pole. Enne esimest bucketit palub Cloudflare sul juhtpaneelil R2 tellimuse aktiveerida. Kui sinu bucketil on jurisdiktsioon (EU, FedRAMP või US), valid selle viisardis ja Nubbo kasutab selle jurisdiktsiooni lõpp-punkti.

Vali ühendusviis

Nubbo viisard pakub kahte teed. Mõlemad lõpevad samamoodi: bucket on ühendatud ja valmis brauserist üleslaadimiseks.

AutomaatnePiiratud võtmega
VõtiJuurdepääs kogu kontolePiiratud ühe bucketiga
BucketNubbo kasutab üht sinu omadest või loob uueLood selle kõigepealt ise
CORSNubbo lisab reegli sinu eestLisad reegli ise
Millal validaKiireim viisKui sa ei taha anda juurdepääsu kogu kontole

Piiratud võti on väikseim ligipääs, mida Nubbo vajab: Object Read & Write ühele bucketile. Sellega ei saa Nubbo sinu bucketeid loetleda ega uut luua, seega kirjutad bucketi nime ja lisad CORS-reegli ise.

Automaatne ühendus

1. samm: loo võti Cloudflare R2-s

  1. Logi sisse aadressil dash.cloudflare.com ja ava R2 object storage. Juhtpaneel võib menüüsid näidata sinu keeles.
  2. Ava API Tokens ja vajuta Create Account API token. Sinna jõuad ka Overview alt, jaotisest Account Details, Manage.
  3. Vali õigus Admin Read & Write ja loo tõend.
  4. Kopeeri Access Key ID ja Secret Access Key. Cloudflare näitab salajast võtit ainult üks kord. Kasuta neid kahte võtit, mitte tõendi väärtust.
  5. Kopeeri ka oma Account ID, mis on näha R2 lehel Overview.

2. samm: ühenda bucket Nubbos

  1. Ava Nubbos Bucketid ja vajuta Ühenda bucket. Vali Cloudflare R2 ja vajuta Jätka.

    Nubbo viisardi pakkuja samm, kus on valitud Cloudflare R2 Nubbo viisardi pakkuja samm, kus on valitud Cloudflare R2
  2. Vali Automaatne ja vajuta Jätka.

    Ühendusviisi samm valikutega Automaatne ja Piiratud võtmega Ühendusviisi samm valikutega Automaatne ja Piiratud võtmega
  3. Kleebi sammus Sinu võti Access Key ID, Secret Access Key ja Account ID. Nubbo koostab Account ID põhjal sinu konto lõpp-punkti. R2 piirkond on alati auto. Enne kui vajutad Kontrolli võtit, vali oma bucketi Jurisdiktsioon: enamiku bucketite puhul Vaikimisi (ilma jurisdiktsioonita) või EU, FedRAMP või US. Lõpp-punkt muutub koos sellega (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com ELi jaoks) ja loend näitab ainult selle jurisdiktsiooni bucketeid. Vajuta Kontrolli võtit. Nubbo kontrollib, et võti töötab ja et sellel on juurdepääs kogu kontole.

    Cloudflare R2 samm Sinu võti koos kiirjuhendi ja võtmeväljadega Cloudflare R2 samm Sinu võti koos kiirjuhendi ja võtmeväljadega
  4. Vali üks oma bucketitest ja vajuta Kasuta seda bucketit või vali Loo uus, sisesta nimi (ja vali piirkond, kui seda küsitakse) ning vajuta Loo ja valmista ette. Nubbo lisab bucketile CORS-reegli, mis lubab üles- ja allalaadimisi ainult rakendusest, ning säilitab bucketi olemasolevad reeglid.

    Samm Sinu bucket koos bucketite loendi ja valikuga Loo uus Samm Sinu bucket koos bucketite loendi ja valikuga Loo uus
  5. Vaata kolm kontrolli üle, muuda soovi korral välja Nimi Nubbos ja vajuta Lõpeta. Bucket ilmub jaotisse Bucketid ja saad selle failihalduris avada.

    Samm Valmis koos ühenduse, bucketi ja CORS-i kontrollidega Samm Valmis koos ühenduse, bucketi ja CORS-i kontrollidega

Kui Nubbo ei saa sinu võtmega CORS-reeglit lisada, viib viisard sind sammu CORS. Siis järgi juhiseid jaotises Lisa CORS-reegel.

Ühendus piiratud võtmega

1. samm: valmista Cloudflare R2-s ette bucket ja võti

  1. Vajuta jaotises R2, Overview Create bucket ja anna sellele nimi (väiketähed, numbrid ja sidekriipsud). Piirkonda valida pole vaja. Kui andmed peavad jääma ELi, vali jurisdiktsioon EU: lõpp-punkt muutub koos sellega.
  2. Ava API Tokens ja vajuta Create Account API token.
  3. Vali õigus Object Read & Write ja piira see oma bucketiga.
  4. Kopeeri Access Key ID, Secret Access Key ja oma Account ID.

2. samm: ühenda bucket Nubbos

  1. Vajuta jaotises Bucketid Ühenda bucket, vali Cloudflare R2 ja seejärel Piiratud võtmega.
  2. Kleebi Access Key ID, Secret Access Key ja Account ID. Enne kui vajutad Kontrolli võtit, vali bucketiga sama Jurisdiktsioon. Vajuta Kontrolli võtit.
  3. Sisesta bucketi täpne nimi ja vajuta Kontrolli juurdepääsu.
  4. Viisard liigub sammu CORS koos reegliga, mille pead lisama.

Lisa CORS-reegel

CORS-reegel lubab brauseril sinu bucketist faile üles ja alla laadida aadressil https://nubbo.app. See on sama reegel, mida viisard näitab sammus CORS.

  1. Ava jaotises R2 bucket ja mine jaotisse Settings.
  2. Vajuta jaotises CORS Policy Add CORS policy ja vali vahekaart JSON.
  3. Kleebi reegel ja vajuta Save. Cloudflare’il võib selle rakendamine võtta kuni 30 sekundit.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
CORS-i samm koos reegliga, mis tuleb bucketile lisada CORS-i samm koos reegliga, mis tuleb bucketile lisada

Kui see on salvestatud, mine tagasi Nubbosse ja vajuta Lisasin, kontrolli. Kui sinu võtmel on õigus CORS-i muuta, teeb Proovi see minu eest seadistada selle sinu eest ära.

Kui midagi läheb valesti

Teade NubbosMida teha
“See võti näib olevat piiratud ühe bucketiga. Võid jätkata piiratud teed või luua täieliku juurdepääsuga võtme.”Vajuta Jätka piiratud võtmega või loo võti, millel on juurdepääs kogu kontole, ja vajuta Proovi teist võtit.
“Sinu võtmel pole õigust bucketeid luua.”Kasuta täieliku juurdepääsuga võtit või loo bucket oma paneelil ja vajuta Lõin selle oma paneelil.
“See nimi on selle teenusepakkuja juures juba kasutusel; proovi mõnda teist.”Bucketite nimed on kogu teenusepakkuja ulatuses unikaalsed: vali mõni teine.
“Sinu võtmel pole õigust seda seadistada.”Lisa CORS-reegel käsitsi, nagu ülal kirjeldatud.
“See ei tööta veel. Vaata reegel üle ja kontrolli uuesti; mõnel pakkujal kulub selle rakendamiseks minut.”Kontrolli, et päritolu oleks täpselt https://nubbo.app ilma kaldkriipsuta lõpus, oota minut ja kontrolli uuesti.
“See bucket on juba kasutusel.”See bucket on Nubbos juba ühendatud, sinu kontol või mõnel teisel.
“Vigased mandaadid. Kontrolli ligipääsuvõtit ja salajast ligipääsuvõtit.”Kontrolli, et kleepisid tõendi Access Key ID ja Secret Access Key, mitte Cloudflare API-tõendi väärtuse.
“Bucketit ei leitud. Kontrolli nime ja regiooni.”Kontrolli nime ja et Nubbo jurisdiktsioon oleks sama mis bucketil (R2 näitab seda bucketi Settings all).

Mis see maksab

R2 ei võta väljamineva liikluse eest tasu ja sellel on igakuine tasuta tase. Selgitame seda artiklis Cloudflare R2 tasuta tase.

Korduma kippuvad küsimused

Kust leian oma Cloudflare Account ID?

R2 lehel Overview, jaotises Account Details. See on 32-märgiline jada, mis koosneb numbritest ja tähtedest a kuni f.

Millist õigust R2 tõend vajab?

Väikseim ligipääs, mida Nubbo vajab, on sinu bucketiga piiratud Object Read & Write piiratud võtme teel: kirjutad bucketi nime ja lisad CORS-reegli ise. Automaatne tee vajab õigust Admin Read & Write, millega Nubbo saab sinu bucketeid loetleda, uue luua ja selle CORS-i seadistada.

Millist piirkonda R2-ga kasutada?

Mitte ühtegi: R2 kasutab piirkonda auto ja Nubbo määrab selle sinu eest. Cloudflare asukohavihjed ei muuda seda, kuidas bucket ühendub.

Kas saan ühendada jurisdiktsiooniga R2 bucketi, näiteks ELi oma?

Jah. Vali sammus Sinu võti bucketi jurisdiktsioon (EU, FedRAMP või US). Igal on oma lõpp-punkt, näiteks https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, ja see näitab ainult selles loodud bucketeid.

Kas Nubbost allalaadimised maksavad R2-s väljaminevat liiklust?

Ei. R2 ei võta väljamineva andmeedastuse eest tasu. Allalaadimised loetakse siiski lugemistoiminguteks.

Allikad

Hinnad ja piirangud pärinevad allpool toodud ametlikelt lehtedelt. Teenusepakkujad muudavad neid, seega kontrolli enne otsustamist.