Vadovai

Cloudflare R2 failų tvarkyklė: prijunkite ją prie Nubbo

Kaip prijungti Cloudflare R2 bucket prie Nubbo: API žetonas, Account ID, vedlys žingsnis po žingsnio, CORS taisyklė ir ką daryti, jei nepavyksta.

Nubbo jungiasi prie Cloudflare R2 naudodama R2 API žetoną ir jūsų paskyros Account ID. Per kelias minutes jūsų bucket atsiduria failų naršyklėje su tiesioginiais įkėlimais, bendrinimo nuorodomis ir galerijomis. Šis vadovas žingsnis po žingsnio seka Nubbo vedlį abiem keliais: automatiškai arba su raktu, apribotu vienu bucket.

Ką gaunate

  • Naršykite bucket kaip diską: aplankai, rodiniai, paieška, šiukšlinė, žymos ir mėgstami.
  • Įkelkite ir atsisiųskite failus tiesiai tarp savo naršyklės ir Cloudflare R2. Failai niekada nepereina per Nubbo serverius.
  • Bendrinkite failus ir aplankus su slaptažodžiu, galiojimo laiku ir atsisiuntimų limitu, gaukite failus į savo bucket ir kurkite galerijas.
  • Jūsų raktai saugomi užšifruoti AES-256-GCM, o bucket galite atjungti bet kada.

Prieš pradedant

Jums reikia Cloudflare R2 paskyros ir Nubbo paskyros. Kiekvienas prijungtas bucket įskaičiuojamas į jūsų plano limitą: Nemokamas planas leidžia 2, Personal 5, o Pro neturi ribos. Prieš pirmąjį bucket Cloudflare paprašo valdymo skydelyje aktyvuoti R2 prenumeratą. Jei jūsų bucket turi jurisdikciją (EU, FedRAMP arba US), ją pasirenkate vedlyje ir Nubbo naudoja tos jurisdikcijos endpoint.

Pasirinkite prijungimo būdą

Nubbo vedlys siūlo du kelius. Abu baigiasi taip pat: bucket prijungtas ir paruoštas įkėlimams iš naršyklės.

AutomatiškaiSu apribotu raktu
RaktasPrieiga prie visos paskyrosApribotas vienu bucket
BucketNubbo naudoja vieną iš jūsų arba sukuria naująPirmiausia jį sukuriate jūs
CORSNubbo prideda taisyklę už jusTaisyklę pridedate jūs
Kada rinktisGreičiausias būdasKai nenorite suteikti prieigos prie visos paskyros

Ribotas raktas yra mažiausia prieiga, kurios reikia Nubbo: Object Read & Write vienam bucket. Su juo Nubbo negali gauti jūsų bucket sąrašo ar sukurti naujo, todėl įvedate bucket pavadinimą ir CORS taisyklę pridedate patys.

Automatinis prijungimas

1 žingsnis: sukurkite raktą Cloudflare R2

  1. Prisijunkite prie dash.cloudflare.com ir atidarykite R2 object storage. Skydelis meniu gali rodyti jūsų kalba.
  2. Atidarykite API Tokens ir spauskite Create Account API token. Ten patenkate ir iš Overview, skiltyje Account Details, Manage.
  3. Pasirinkite teisę Admin Read & Write ir sukurkite žetoną.
  4. Nukopijuokite Access Key ID ir Secret Access Key. Cloudflare slaptąjį raktą rodo tik vieną kartą. Naudokite šiuos du raktus, ne žetono reikšmę.
  5. Taip pat nukopijuokite savo Account ID, rodomą R2 Overview puslapyje.

2 žingsnis: prijunkite bucket Nubbo

  1. Nubbo atidarykite Bucket’ai ir spauskite Prijungti bucket. Pasirinkite Cloudflare R2 ir spauskite Tęsti.

    Nubbo vedlio teikėjo žingsnis su pasirinktu Cloudflare R2 Nubbo vedlio teikėjo žingsnis su pasirinktu Cloudflare R2
  2. Pasirinkite Automatiškai ir spauskite Tęsti.

    Prijungimo būdo žingsnis su parinktimis Automatiškai ir Su apribotu raktu Prijungimo būdo žingsnis su parinktimis Automatiškai ir Su apribotu raktu
  3. Žingsnyje Jūsų raktas įklijuokite Access Key ID, Secret Access Key ir Account ID. Nubbo pagal Account ID sudaro jūsų paskyros endpoint. R2 regionas visada yra auto. Prieš spausdami Patikrinti raktą, pasirinkite savo bucket Jurisdikcija: daugumai bucket Numatytoji (be jurisdikcijos), arba EU, FedRAMP ar US. Kartu keičiasi endpoint (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com ES) ir sąraše rodomi tik tos jurisdikcijos bucket. Spauskite Patikrinti raktą. Nubbo patikrina, ar raktas veikia ir ar jis turi prieigą prie visos paskyros.

    Cloudflare R2 žingsnis Jūsų raktas su greituoju vadovu ir rakto laukais Cloudflare R2 žingsnis Jūsų raktas su greituoju vadovu ir rakto laukais
  4. Pasirinkite vieną iš savo bucket ir spauskite Naudoti šį bucket arba pažymėkite Sukurti naują, įveskite pavadinimą (ir pasirinkite regioną, jei jo paprašoma) ir spauskite Sukurti ir paruošti. Nubbo prideda prie bucket CORS taisyklę, kuri leidžia įkėlimus ir atsisiuntimus tik iš programos, ir išsaugo jau esamas taisykles.

    Žingsnis Jūsų bucket su bucket sąrašu ir parinktimi Sukurti naują Žingsnis Jūsų bucket su bucket sąrašu ir parinktimi Sukurti naują
  5. Peržiūrėkite tris patikras, jei norite, pakeiskite Pavadinimas Nubbo ir spauskite Baigti. Bucket atsiranda skiltyje Bucket’ai ir jį galite atidaryti naršyklėje.

    Pabaigos žingsnis su ryšio, bucket ir CORS patikromis Pabaigos žingsnis su ryšio, bucket ir CORS patikromis

Jei Nubbo negali pridėti CORS taisyklės su jūsų raktu, vedlys nukreipia jus į žingsnį CORS. Tada sekite skyrių Pridėkite CORS taisyklę.

Prijungimas su apribotu raktu

1 žingsnis: paruoškite bucket ir raktą Cloudflare R2

  1. Skiltyje R2, Overview spauskite Create bucket ir suteikite jam pavadinimą (mažosios raidės, skaičiai ir brūkšneliai). Regiono rinktis nereikia. Jei duomenys turi likti ES, pasirinkite jurisdikciją EU: kartu keičiasi endpoint.
  2. Atidarykite API Tokens ir spauskite Create Account API token.
  3. Pasirinkite teisę Object Read & Write ir apribokite ją savo bucket.
  4. Nukopijuokite Access Key ID, Secret Access Key ir savo Account ID.

2 žingsnis: prijunkite bucket Nubbo

  1. Skiltyje Bucket’ai spauskite Prijungti bucket, pasirinkite Cloudflare R2, tada Su apribotu raktu.
  2. Įklijuokite Access Key ID, Secret Access Key ir Account ID. Prieš spausdami Patikrinti raktą, pasirinkite tą pačią Jurisdikcija kaip bucket. Spauskite Patikrinti raktą.
  3. Įveskite tikslų bucket pavadinimą ir spauskite Patikrinti prieigą.
  4. Vedlys pereina į žingsnį CORS su taisykle, kurią reikia pridėti.

Pridėkite CORS taisyklę

CORS taisyklė leidžia naršyklei įkelti ir atsisiųsti failus iš jūsų bucket svetainėje https://nubbo.app. Tai ta pati taisyklė, kurią vedlys rodo žingsnyje CORS.

  1. Skiltyje R2 atidarykite bucket ir eikite į Settings.
  2. Skiltyje CORS Policy spauskite Add CORS policy ir pasirinkite kortelę JSON.
  3. Įklijuokite taisyklę ir spauskite Save. Cloudflare ją pritaikyti gali užtrukti iki 30 sekundžių.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
CORS žingsnis su taisykle, kurią reikia pridėti prie bucket CORS žingsnis su taisykle, kurią reikia pridėti prie bucket

Kai ją išsaugosite, grįžkite į Nubbo ir spauskite Pridėjau, patikrinti. Jei jūsų raktas turi teisę keisti CORS, Bandyti sukonfigūruoti už mane tai padarys už jus.

Jei kas nors nepavyksta

Pranešimas NubboKą daryti
„Panašu, kad šis raktas apribotas vienu bucket. Galite tęsti apribotu keliu arba sukurti raktą su visa prieiga.“Spauskite Tęsti su apribotu raktu arba sukurkite raktą su prieiga prie visos paskyros ir spauskite Išbandyti kitą raktą.
„Jūsų raktas neturi teisės kurti bucket.“Naudokite raktą su visa prieiga arba sukurkite bucket savo skydelyje ir spauskite Jau sukūriau jį savo skydelyje.
„Šis pavadinimas pas šį teikėją jau naudojamas; išbandykite kitą.“Bucket pavadinimai unikalūs visame teikėjo tinkle: pasirinkite kitą.
„Jūsų raktas neturi teisės to sukonfigūruoti.“Pridėkite CORS taisyklę ranka, kaip paaiškinta aukščiau.
„Dar neveikia. Peržiūrėkite taisyklę ir patikrinkite dar kartą; kai kuriems teikėjams reikia minutės ją pritaikyti.“Patikrinkite, ar kilmė yra tiksliai https://nubbo.app be pasvirojo brūkšnio gale, palaukite minutę ir patikrinkite dar kartą.
„Šis bucket jau naudojamas.“Šis bucket jau prijungtas prie Nubbo, jūsų ar kitoje paskyroje.
„Neteisingi prisijungimo duomenys. Patikrinkite prieigos raktą ir slaptąjį prieigos raktą.“Patikrinkite, ar įklijavote žetono Access Key ID ir Secret Access Key, o ne Cloudflare API žetono reikšmę.
„Bucket nerastas. Patikrinkite pavadinimą ir regioną.“Patikrinkite pavadinimą ir ar jurisdikcija Nubbo sutampa su bucket jurisdikcija (R2 ją rodo bucket Settings).

Kiek tai kainuoja

R2 neima mokesčio už išeinantį srautą ir turi mėnesinį nemokamą lygį. Tai paaiškiname straipsnyje Cloudflare R2 nemokamas lygis.

Dažnai užduodami klausimai

Kur rasti savo Cloudflare Account ID?

R2 Overview puslapyje, skiltyje Account Details. Tai 32 simbolių eilutė iš skaičių ir raidžių nuo a iki f.

Kokios teisės reikia R2 žetonui?

Mažiausia prieiga, kurios reikia Nubbo, yra jūsų bucket apribotas Object Read & Write, naudojant riboto rakto kelią: įvedate bucket pavadinimą ir CORS taisyklę pridedate patys. Automatiniam keliui reikia Admin Read & Write, kad Nubbo galėtų gauti jūsų bucket sąrašą, sukurti naują ir nustatyti jo CORS.

Kurį regioną naudoti su R2?

Jokio: R2 naudoja regioną auto, ir Nubbo jį nustato už jus. Cloudflare vietos užuominos (location hints) nekeičia to, kaip bucket prijungiamas.

Ar galiu prijungti R2 bucket su jurisdikcija, pavyzdžiui, ES?

Taip. Žingsnyje Jūsų raktas pasirinkite bucket jurisdikciją (EU, FedRAMP arba US). Kiekviena turi savo endpoint, pavyzdžiui, https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, ir rodo tik joje sukurtus bucket.

Ar atsisiuntimai iš Nubbo R2 kainuoja už išeinantį srautą?

Ne. R2 neima mokesčio už išeinantį duomenų srautą. Atsisiuntimai vis dėlto skaičiuojami kaip skaitymo operacijos.

Šaltiniai

Kainos ir ribos paimtos iš toliau nurodytų oficialių puslapių. Teikėjai jas keičia, todėl patikrinkite prieš apsispręsdami.