Vodiči

Upravitelj datoteka za Cloudflare R2: poveži ga s Nubbom

Kako povezati Cloudflare R2 bucket s Nubbom: API token, Account ID, čarobnjak korak po korak, CORS pravilo i što učiniti ako nešto ne uspije.

Nubbo se s Cloudflare R2 povezuje pomoću R2 API tokena i Account ID-ja tvog računa. Za nekoliko minuta tvoji su bucketi u pregledniku datoteka s izravnim prijenosima, poveznicama za dijeljenje i galerijama. Ovaj vodič prati Nubbov čarobnjak korak po korak, s oba puta: automatski ili s ključem ograničenim na jedan bucket.

Što dobivaš

  • Pregledavaj bucket kao disk: mape, prikazi, pretraživanje, smeće, oznake i favoriti.
  • Prenosi i preuzimaj datoteke izravno između svog preglednika i Cloudflare R2. Datoteke nikad ne prolaze kroz Nubbove servere.
  • Dijeli datoteke i mape s lozinkom, istekom i ograničenjem preuzimanja, primaj datoteke u svoj bucket i izrađuj galerije.
  • Tvoji se ključevi spremaju šifrirani algoritmom AES-256-GCM i bucket možeš odspojiti u bilo kojem trenutku.

Prije nego što počneš

Trebaš račun na Cloudflare R2 i Nubbo račun. Svaki bucket koji povežeš ulazi u ograničenje tvog plana: plan Besplatno dopušta 2, Personal 5, a Pro nema ograničenja. Prije prvog bucketa Cloudflare traži da na nadzornoj ploči aktiviraš R2 pretplatu. Ako tvoj bucket ima jurisdikciju (EU, FedRAMP ili US), odabereš je u čarobnjaku i Nubbo koristi endpoint te jurisdikcije.

Odaberi način povezivanja

Nubbov čarobnjak nudi dva puta. Oba završavaju jednako: bucket je povezan i spreman za prijenose iz preglednika.

AutomatskiS ograničenim ključem
KljučPristup cijelom računuOgraničen na jedan bucket
BucketNubbo koristi jedan od tvojih ili izrađuje noviIzradiš ga najprije sam
CORSNubbo dodaje pravilo umjesto tebePravilo dodaješ ti
Kada ga odabratiNajbrži načinKad ne želiš dati pristup cijelom računu

Ograničeni ključ je najmanji pristup koji Nubbo treba: Object Read & Write na jednom bucketu. S njim Nubbo ne može prikazati tvoje buckete ni izraditi novi, pa upišeš naziv bucketa i sam dodaš CORS pravilo.

Automatsko povezivanje

Korak 1: izradi ključ u Cloudflare R2

  1. Prijavi se na dash.cloudflare.com i otvori R2 object storage. Nadzorna ploča može prikazivati izbornike na tvom jeziku.
  2. Otvori API Tokens i pritisni Create Account API token. Do njega dolaziš i iz Overview, pod Account Details, Manage.
  3. Odaberi dopuštenje Admin Read & Write i izradi token.
  4. Kopiraj Access Key ID i Secret Access Key. Cloudflare tajnu prikazuje samo jednom. Koristi ta dva ključa, ne vrijednost tokena.
  5. Kopiraj i svoj Account ID, prikazan na stranici R2 Overview.

Korak 2: poveži bucket u Nubbu

  1. U Nubbu otvori Bucketi i pritisni Poveži bucket. Odaberi Cloudflare R2 i pritisni Nastavi.

    Korak Pružatelj usluge u Nubbovom čarobnjaku s odabranim Cloudflare R2 Korak Pružatelj usluge u Nubbovom čarobnjaku s odabranim Cloudflare R2
  2. Odaberi Automatski i pritisni Nastavi.

    Korak Način povezivanja s opcijama Automatski i S ograničenim ključem Korak Način povezivanja s opcijama Automatski i S ograničenim ključem
  3. U koraku Tvoj ključ zalijepi Access Key ID, Secret Access Key i Account ID. Nubbo iz Account ID-ja sastavlja endpoint tvog računa. Regija za R2 uvijek je auto. Prije nego pritisneš Provjeri ključ, odaberi Jurisdikcija svog bucketa: Zadana (bez jurisdikcije) za većinu bucketa, ili EU, FedRAMP ili US. Endpoint se mijenja s njom (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com za EU), a popis prikazuje samo buckete te jurisdikcije. Pritisni Provjeri ključ. Nubbo provjerava radi li ključ i ima li pristup cijelom računu.

    Korak Tvoj ključ za Cloudflare R2 s brzim vodičem i poljima ključa Korak Tvoj ključ za Cloudflare R2 s brzim vodičem i poljima ključa
  4. Odaberi jedan od svojih bucketa i pritisni Koristi ovaj bucket ili odaberi Izradi novi, upiši naziv (i odaberi regiju, ako je traži) te pritisni Izradi i pripremi. Nubbo dodaje bucketu CORS pravilo koje dopušta prijenos i preuzimanje samo iz aplikacije i zadržava pravila koja bucket već ima.

    Korak Tvoj bucket s popisom bucketa i opcijom Izradi novi Korak Tvoj bucket s popisom bucketa i opcijom Izradi novi
  5. Pregledaj tri provjere, po želji promijeni Naziv u Nubbu i pritisni Završi. Bucket se pojavljuje u odjeljku Bucketi i možeš ga otvoriti u pregledniku.

    Korak Gotovo s provjerama veze, bucketa i CORS-a Korak Gotovo s provjerama veze, bucketa i CORS-a

Ako Nubbo tvojim ključem ne može dodati CORS pravilo, čarobnjak te vodi na korak CORS. Tada slijedi Dodaj CORS pravilo.

Povezivanje s ograničenim ključem

Korak 1: pripremi bucket i ključ u Cloudflare R2

  1. U R2, Overview, pritisni Create bucket i daj mu naziv (mala slova, brojke i crtice). Nema regije za odabir. Ako podaci moraju ostati u EU, odaberi jurisdikciju EU: endpoint se mijenja s njom.
  2. Otvori API Tokens i pritisni Create Account API token.
  3. Odaberi dopuštenje Object Read & Write i ograniči ga na svoj bucket.
  4. Kopiraj Access Key ID, Secret Access Key i svoj Account ID.

Korak 2: poveži bucket u Nubbu

  1. U odjeljku Bucketi pritisni Poveži bucket, odaberi Cloudflare R2, a zatim S ograničenim ključem.
  2. Zalijepi Access Key ID, Secret Access Key i Account ID. Prije nego pritisneš Provjeri ključ, odaberi istu Jurisdikcija kao za bucket. Pritisni Provjeri ključ.
  3. Upiši točan naziv bucketa i pritisni Provjeri pristup.
  4. Čarobnjak prelazi na korak CORS s pravilom koje trebaš dodati.

Dodaj CORS pravilo

CORS pravilo dopušta pregledniku prijenos i preuzimanje datoteka iz tvog bucketa na https://nubbo.app. To je isto pravilo koje čarobnjak prikazuje u koraku CORS.

  1. U R2 otvori bucket i idi na Settings.
  2. Pod CORS Policy pritisni Add CORS policy i odaberi karticu JSON.
  3. Zalijepi pravilo i pritisni Save. Cloudflareu može trebati do 30 sekundi da ga primijeni.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Korak CORS s pravilom koje treba dodati bucketu Korak CORS s pravilom koje treba dodati bucketu

Kad ga spremiš, vrati se u Nubbo i pritisni Dodano, provjeri. Ako tvoj ključ smije mijenjati CORS, Pokušaj ga postaviti umjesto mene to radi umjesto tebe.

Ako nešto pođe po zlu

Poruka u NubbuŠto učiniti
“Čini se da je ovaj ključ ograničen na jedan bucket. Možeš nastaviti ograničenim putem ili izraditi ključ s potpunim pristupom.”Pritisni Nastavi s ograničenim ključem ili izradi ključ s pristupom cijelom računu i pritisni Isprobaj drugi ključ.
“Tvoj ključ nema dopuštenje za izradu bucketa.”Koristi ključ s potpunim pristupom ili izradi bucket u svojoj upravljačkoj ploči i pritisni Već ga imam u svojoj upravljačkoj ploči.
“Taj se naziv već koristi kod ovog pružatelja usluge; pokušaj s drugim.”Nazivi bucketa jedinstveni su na razini cijelog pružatelja: odaberi drugi.
“Tvoj ključ nema dopuštenje da to postavi.”Dodaj CORS pravilo ručno, kako je objašnjeno iznad.
“Još ne radi. Pregledaj pravilo i provjeri ponovno; nekim pružateljima treba minuta da ga primijene.”Provjeri je li ishodište točno https://nubbo.app bez kose crte na kraju, pričekaj minutu i provjeri ponovno.
“Ovaj bucket se već koristi.”Taj je bucket već povezan u Nubbu, na tvom ili na nekom drugom računu.
“Nevažeće vjerodajnice. Provjeri pristupni ključ i tajni pristupni ključ.”Provjeri jesi li zalijepio Access Key ID i Secret Access Key tokena, a ne vrijednost Cloudflare API tokena.
“Bucket nije pronađen. Provjeri naziv i regiju.”Provjeri naziv i odgovara li jurisdikcija u Nubbu onoj bucketa (R2 je prikazuje u Settings bucketa).

Koliko košta

R2 ne naplaćuje odlazni promet i ima mjesečnu besplatnu razinu. Objašnjavamo to u članku Besplatna razina Cloudflare R2.

Česta pitanja

Gdje mogu pronaći svoj Cloudflare Account ID?

Na stranici R2 Overview, pod Account Details. To je niz od 32 znaka sastavljen od brojki i slova od a do f.

Koje dopuštenje treba R2 token?

Najmanji pristup koji Nubbo treba je Object Read & Write ograničen na tvoj bucket, s putem s ograničenim ključem: upišeš naziv bucketa i sam dodaš CORS pravilo. Automatski put treba Admin Read & Write, kojim Nubbo prikazuje tvoje buckete, izrađuje novi i postavlja njegov CORS.

Koju regiju koristim s R2?

Nijednu: R2 koristi regiju auto i Nubbo je postavlja umjesto tebe. Cloudflareovi location hints ne mijenjaju način na koji se bucket povezuje.

Mogu li povezati R2 bucket s jurisdikcijom, npr. onom EU-a?

Da. U koraku Tvoj ključ odaberi jurisdikciju bucketa (EU, FedRAMP ili US). Svaka ima vlastiti endpoint, npr. https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, i prikazuje samo buckete izrađene u njoj.

Naplaćuje li R2 odlazni promet za preuzimanja iz Nubba?

Ne. R2 ne naplaćuje odlazni prijenos podataka. Preuzimanja se ipak računaju kao operacije čitanja.

Izvori

Cijene i ograničenja potječu sa službenih stranica u nastavku. Pružatelji ih mijenjaju, pa ih provjeri prije nego što se odlučiš.