Oppaat

Tiedostonhallinta Cloudflare R2:lle: yhdistä se Nubboon

Näin yhdistät Cloudflare R2 -bucketin Nubboon: API-tunnus, Account ID, ohjattu toiminto vaihe vaiheelta, CORS-sääntö ja mitä tehdä ongelmatilanteessa.

Nubbo yhdistää Cloudflare R2:een R2:n API-tunnuksella ja tilisi Account ID:llä. Muutamassa minuutissa bucketisi ovat tiedostoselaimessa suorine lähetyksineen, jakolinkkeineen ja gallerioineen. Tämä opas seuraa Nubbon ohjattua toimintoa vaihe vaiheelta molempia tapoja käyttäen: automaattisesti tai yhteen bucketiin rajatulla avaimella.

Mitä saat

  • Selaa bucketia kuin levyä: kansiot, näkymät, haku, roskakori, tunnisteet ja suosikit.
  • Lähetä ja lataa tiedostoja suoraan selaimesi ja Cloudflare R2:n välillä. Tiedostot eivät koskaan kulje Nubbon palvelimien kautta.
  • Jaa tiedostoja ja kansioita salasanalla, vanhenemisajalla ja latausrajalla, vastaanota tiedostoja bucketiisi ja luo gallerioita.
  • Avaimesi tallennetaan AES-256-GCM-salattuina, ja voit irrottaa bucketin milloin tahansa.

Ennen kuin aloitat

Tarvitset Cloudflare R2 -tilin ja Nubbo-tilin. Jokainen yhdistämäsi bucket lasketaan tilauksesi rajaan: Ilmainen-tilaus sallii 2, Personal 5 ja Prossa ei ole rajaa. Ennen ensimmäistä bucketia Cloudflare pyytää aktivoimaan R2-tilauksen hallintapaneelista. Jos bucketillasi on lainkäyttöalue (EU, FedRAMP tai US), valitset sen ohjatussa toiminnossa, ja Nubbo käyttää sen lainkäyttöalueen endpointia.

Valitse yhdistämistapa

Nubbon ohjattu toiminto tarjoaa kaksi tapaa. Molemmat päättyvät samoin: bucket on yhdistetty ja valmis lähetyksiin selaimesta.

AutomaattinenRajatulla avaimella
AvainPääsy koko tiliinRajattu yhteen bucketiin
BucketNubbo käyttää omaasi tai luo uudenLuot sen ensin itse
CORSNubbo lisää säännön puolestasiLisäät säännön itse
Milloin valitaNopein tapaKun et halua antaa pääsyä koko tiliin

Rajattu avain on pienin käyttöoikeus, jonka Nubbo tarvitsee: Object Read & Write yhteen bucketiin. Sillä Nubbo ei voi listata bucketejasi eikä luoda uutta, joten kirjoitat bucketin nimen ja lisäät CORS-säännön itse.

Automaattinen yhdistäminen

Vaihe 1: luo avain Cloudflare R2:ssa

  1. Kirjaudu osoitteeseen dash.cloudflare.com ja avaa R2 object storage. Hallintapaneeli voi näyttää valikot omalla kielelläsi.
  2. Avaa API Tokens ja paina Create Account API token. Pääset sinne myös Overview-sivulta kohdasta Account Details, Manage.
  3. Valitse Admin Read & Write -oikeus ja luo tunnus.
  4. Kopioi Access Key ID ja Secret Access Key. Cloudflare näyttää secretin vain kerran. Käytä näitä kahta avainta, älä tunnuksen arvoa.
  5. Kopioi myös Account ID, joka näkyy R2:n Overview-sivulla.

Vaihe 2: yhdistä bucket Nubbossa

  1. Avaa Nubbossa Bucketit ja paina Yhdistä bucket. Valitse Cloudflare R2 ja paina Jatka.

    Nubbon ohjatun toiminnon Tarjoaja-vaihe, jossa Cloudflare R2 on valittuna Nubbon ohjatun toiminnon Tarjoaja-vaihe, jossa Cloudflare R2 on valittuna
  2. Valitse Automaattinen ja paina Jatka.

    Yhdistämistapa-vaihe, jossa ovat vaihtoehdot Automaattinen ja Rajatulla avaimella Yhdistämistapa-vaihe, jossa ovat vaihtoehdot Automaattinen ja Rajatulla avaimella
  3. Liitä Avaimesi-vaiheessa Access Key ID, Secret Access Key ja Account ID. Nubbo muodostaa tilisi endpointin Account ID:n perusteella. R2:n alue on aina auto. Ennen kuin painat Tarkista avain, valitse bucketisi Lainkäyttöalue: useimmille bucketeille Oletus (ei lainkäyttöaluetta), tai EU, FedRAMP tai US. Endpoint vaihtuu sen mukana (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com EU:lle), ja luettelo näyttää vain sen lainkäyttöalueen bucketit. Paina Tarkista avain. Nubbo tarkistaa, että avain toimii ja että sillä on pääsy koko tiliin.

    Cloudflare R2:n Avaimesi-vaihe, jossa ovat pika-asennusopas ja avainkentät Cloudflare R2:n Avaimesi-vaihe, jossa ovat pika-asennusopas ja avainkentät
  4. Valitse yksi bucketeistasi ja paina Käytä tätä bucketia, tai valitse Luo uusi, kirjoita nimi (ja valitse alue, jos sitä kysytään) ja paina Luo ja valmistele. Nubbo lisää bucketiin CORS-säännön, joka sallii lähetykset ja lataukset vain sovelluksesta, ja säilyttää bucketin nykyiset säännöt.

    Bucketisi-vaihe, jossa ovat bucketien luettelo ja vaihtoehto Luo uusi Bucketisi-vaihe, jossa ovat bucketien luettelo ja vaihtoehto Luo uusi
  5. Tarkista kolme tarkistusta, muuta halutessasi kohtaa Nimi Nubbossa ja paina Viimeistele. Bucket näkyy kohdassa Bucketit, ja voit avata sen tiedostoselaimessa.

    Valmis-vaihe, jossa ovat yhteyden, bucketin ja CORSin tarkistukset Valmis-vaihe, jossa ovat yhteyden, bucketin ja CORSin tarkistukset

Jos Nubbo ei voi lisätä CORS-sääntöä avaimellasi, ohjattu toiminto vie sinut CORS-vaiheeseen. Seuraa silloin ohjetta Lisää CORS-sääntö.

Yhdistäminen rajatulla avaimella

Vaihe 1: valmistele bucket ja avain Cloudflare R2:ssa

  1. Paina kohdassa R2, Overview Create bucket ja anna bucketille nimi (pieniä kirjaimia, numeroita ja yhdysmerkkejä). Aluetta ei tarvitse valita. Jos tietojen on pysyttävä EU:ssa, valitse lainkäyttöalueeksi EU: endpoint vaihtuu sen mukana.
  2. Avaa API Tokens ja paina Create Account API token.
  3. Valitse Object Read & Write -oikeus ja rajaa se bucketiisi.
  4. Kopioi Access Key ID, Secret Access Key ja Account ID.

Vaihe 2: yhdistä bucket Nubbossa

  1. Paina kohdassa Bucketit Yhdistä bucket, valitse Cloudflare R2 ja sitten Rajatulla avaimella.
  2. Liitä Access Key ID, Secret Access Key ja Account ID. Ennen kuin painat Tarkista avain, valitse sama Lainkäyttöalue kuin bucketilla. Paina Tarkista avain.
  3. Kirjoita bucketin tarkka nimi ja paina Tarkista pääsy.
  4. Ohjattu toiminto siirtyy CORS-vaiheeseen ja näyttää säännön, joka sinun on lisättävä.

Lisää CORS-sääntö

CORS-sääntö antaa selaimen lähettää ja ladata tiedostoja bucketistasi osoitteessa https://nubbo.app. Se on sama sääntö, jonka ohjattu toiminto näyttää CORS-vaiheessa.

  1. Avaa R2:ssa bucket ja siirry kohtaan Settings.
  2. Paina kohdassa CORS Policy Add CORS policy ja valitse JSON-välilehti.
  3. Liitä sääntö ja paina Save. Cloudflarella voi kestää jopa 30 sekuntia ottaa se käyttöön.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
CORS-vaihe, jossa on bucketiin lisättävä sääntö CORS-vaihe, jossa on bucketiin lisättävä sääntö

Kun sääntö on tallennettu, palaa Nubboon ja paina Lisäsin sen, tarkista. Jos avaimellasi on oikeus muuttaa CORSia, Yritä määrittää se puolestani tekee sen puolestasi.

Jos jokin menee pieleen

Viesti NubbossaMitä tehdä
“Tämä avain näyttää olevan rajattu yhteen bucketiin. Voit jatkaa rajatulla tavalla tai luoda avaimen, jolla on täydet käyttöoikeudet.”Paina Jatka rajatulla avaimella, tai luo avain, jolla on pääsy koko tiliin, ja paina Kokeile toista avainta.
“Avaimellasi ei ole oikeutta luoda bucketeja.”Käytä avainta, jolla on täydet käyttöoikeudet, tai luo bucket hallintapaneelissasi ja paina Loin sen hallintapaneelissani.
“Nimi on jo käytössä tällä palveluntarjoajalla; kokeile toista.”Bucketien nimet ovat yksilöllisiä koko palveluntarjoajalla: valitse toinen nimi.
“Avaimellasi ei ole oikeutta määrittää sitä.”Lisää CORS-sääntö käsin yllä kuvatulla tavalla.
“Se ei toimi vielä. Tarkista sääntö ja kokeile uudelleen; joillakin tarjoajilla sen käyttöönotto kestää minuutin.”Tarkista, että origin on täsmälleen https://nubbo.app ilman kauttaviivaa lopussa, odota minuutti ja tarkista uudelleen.
“Tämä bucket on jo käytössä.”Bucket on jo yhdistetty Nubboon, joko sinun tililläsi tai toisella tilillä.
“Virheelliset tunnukset. Tarkista access key ja secret access key.”Tarkista, että liitit tunnuksen Access Key ID:n ja Secret Access Keyn etkä Cloudflaren API-tunnuksen arvoa.
“Buckettia ei löytynyt. Tarkista nimi ja alue.”Tarkista nimi ja että Nubbon lainkäyttöalue on sama kuin bucketin (R2 näyttää sen bucketin Settings-kohdassa).

Mitä se maksaa

R2 ei laskuta ulospäin siirrosta, ja siinä on kuukausittainen ilmainen taso. Selitämme sen artikkelissa Cloudflare R2:n ilmainen taso.

Usein kysytyt kysymykset

Mistä löydän Cloudflaren Account ID:n?

R2:n Overview-sivulta kohdasta Account Details. Se on 32 merkin jono, jossa on numeroita ja kirjaimia a:sta f:ään.

Mitä oikeutta R2-tunnus tarvitsee?

Pienin käyttöoikeus, jonka Nubbo tarvitsee, on bucketiisi rajattu Object Read & Write rajatun avaimen polulla: kirjoitat bucketin nimen ja lisäät CORS-säännön itse. Automaattinen polku vaatii Admin Read & Write -oikeuden, jolla Nubbo voi listata bucketisi, luoda uuden ja määrittää sen CORSin.

Mitä aluetta käytän R2:n kanssa?

Ei mitään: R2 käyttää aluetta auto, ja Nubbo asettaa sen puolestasi. Cloudflaren sijaintivihjeet eivät muuta sitä, miten bucket yhdistetään.

Voinko yhdistää R2-bucketin, jolla on lainkäyttöalue, esimerkiksi EU?

Kyllä. Valitse vaiheessa Avaimesi bucketin lainkäyttöalue (EU, FedRAMP tai US). Jokaisella on oma endpointinsa, esimerkiksi https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, ja se näyttää vain siihen luodut bucketit.

Maksavatko lataukset Nubbosta R2:ssa ulospäin siirtoa?

Eivät. R2 ei laskuta ulospäin siirretystä datasta. Lataukset lasketaan kuitenkin lukutoiminnoiksi.

Lähteet

Hinnat ja rajat ovat alla olevilta virallisilta sivuilta. Palveluntarjoajat muuttavat niitä, joten tarkista ne ennen kuin sitoudut.