Ghiduri

Manager de fișiere pentru Cloudflare R2: conectează-l la Nubbo

Cum conectezi un bucket Cloudflare R2 la Nubbo: tokenul API, Account ID, asistentul pas cu pas, regula CORS și ce faci dacă ceva nu merge.

Nubbo se conectează la Cloudflare R2 cu un token API R2 și cu Account ID-ul contului tău. În câteva minute, bucketurile tale ajung într-un explorator de fișiere cu încărcări directe, linkuri de partajare și galerii. Acest ghid urmează pas cu pas asistentul Nubbo, pe ambele căi: automată sau cu o cheie limitată la un singur bucket.

Ce obții

  • Explorezi bucketul ca pe un drive: foldere, vizualizări, căutare, coș de gunoi, etichete și favorite.
  • Încarci și descarci fișiere direct între browserul tău și Cloudflare R2. Fișierele nu trec niciodată prin serverele Nubbo.
  • Partajezi fișiere și foldere cu parolă, dată de expirare și limită de descărcări, primești fișiere în bucket și creezi galerii.
  • Cheile tale sunt păstrate criptate cu AES-256-GCM și poți deconecta bucketul oricând.

Înainte să începi

Ai nevoie de un cont Cloudflare R2 și de un cont Nubbo. Fiecare bucket pe care îl conectezi contează pentru limita planului tău: Gratuit permite 2, Personal 5, iar Pro nu are limită. Înainte de primul bucket, Cloudflare îți cere să activezi abonamentul R2 din dashboard. Dacă bucketul tău are jurisdicție (EU, FedRAMP sau US), o alegi în asistent și Nubbo folosește endpointul acelei jurisdicții.

Alege cum te conectezi

Asistentul Nubbo îți oferă două căi. Ambele se termină la fel: bucketul conectat și pregătit pentru încărcări din browser.

AutomatCu o cheie limitată
CheieAcces la tot contulLimitată la un singur bucket
BucketNubbo folosește unul de-al tău sau creează unulÎl creezi tu mai întâi
CORSNubbo adaugă regula pentru tineAdaugi tu regula
Când o alegiCea mai rapidă caleCând nu vrei să dai acces la tot contul

Cheia limitată este accesul minim de care are nevoie Nubbo: Object Read & Write pe un bucket. Cu ea Nubbo nu îți poate lista bucketurile și nu poate crea unul, așa că scrii numele bucketului și adaugi tu regula CORS.

Conectare automată

Pasul 1: creează cheia în Cloudflare R2

  1. Conectează-te la dash.cloudflare.com și deschide R2 object storage. Panoul poate afișa meniurile în limba ta.
  2. Deschide API Tokens și apasă Create Account API token. Ajungi acolo și din Overview, la Account Details, Manage.
  3. Alege permisiunea Admin Read & Write și creează tokenul.
  4. Copiază Access Key ID și Secret Access Key. Cloudflare afișează secretul o singură dată. Folosește aceste două chei, nu valoarea tokenului.
  5. Copiază și Account ID, afișat pe pagina Overview din R2.

Pasul 2: conectează bucketul în Nubbo

  1. În Nubbo, deschide Bucketuri și apasă Conectează bucket. Alege Cloudflare R2 și apasă Continuă.

    Pasul Provider din asistentul Nubbo cu Cloudflare R2 selectat Pasul Provider din asistentul Nubbo cu Cloudflare R2 selectat
  2. Alege Automat și apasă Continuă.

    Pasul Mod de conectare cu opțiunile Automat și Cu o cheie limitată Pasul Mod de conectare cu opțiunile Automat și Cu o cheie limitată
  3. La pasul Cheia ta, lipește Access Key ID, Secret Access Key și Account ID. Nubbo construiește endpointul contului tău pornind de la Account ID. Regiunea R2 este întotdeauna auto. Înainte să apeși Verifică cheia, alege Jurisdicție pentru bucketul tău: Implicită (fără jurisdicție) pentru majoritatea bucketurilor, sau EU, FedRAMP ori US. Endpointul se schimbă odată cu ea (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com pentru UE), iar lista arată doar bucketurile din acea jurisdicție. Apasă Verifică cheia. Nubbo verifică dacă cheia funcționează și dacă are acces la tot contul.

    Pasul Cheia ta pentru Cloudflare R2 cu ghidul rapid și câmpurile cheii Pasul Cheia ta pentru Cloudflare R2 cu ghidul rapid și câmpurile cheii
  4. Alege unul dintre bucketurile tale și apasă Folosește acest bucket sau selectează Creează unul nou, scrie un nume (și alege regiunea, dacă ți se cere) și apasă Creează și pregătește. Nubbo adaugă în bucket o regulă CORS care permite încărcări și descărcări doar din aplicație și păstrează regulile pe care le are deja.

    Pasul Bucketul tău cu lista de bucketuri și opțiunea Creează unul nou Pasul Bucketul tău cu lista de bucketuri și opțiunea Creează unul nou
  5. Verifică cele trei confirmări, schimbă Nume în Nubbo dacă vrei și apasă Finalizează. Bucketul apare în Bucketuri și îl poți deschide în explorator.

    Pasul Gata cu verificările pentru conexiune, bucket și CORS Pasul Gata cu verificările pentru conexiune, bucket și CORS

Dacă Nubbo nu poate adăuga regula CORS cu cheia ta, asistentul te duce la pasul CORS. Urmează atunci secțiunea Adaugă regula CORS.

Conectare cu o cheie limitată

Pasul 1: pregătește bucketul și cheia în Cloudflare R2

  1. În R2, Overview, apasă Create bucket și dă-i un nume (litere mici, cifre și cratime). Nu ai nicio regiune de ales. Dacă datele trebuie să rămână în UE, alege jurisdicția EU: endpointul se schimbă odată cu ea.
  2. Deschide API Tokens și apasă Create Account API token.
  3. Alege permisiunea Object Read & Write și limitează-o la bucketul tău.
  4. Copiază Access Key ID, Secret Access Key și Account ID.

Pasul 2: conectează bucketul în Nubbo

  1. În Bucketuri, apasă Conectează bucket, alege Cloudflare R2 și apoi Cu o cheie limitată.
  2. Lipește Access Key ID, Secret Access Key și Account ID. Înainte să apeși Verifică cheia, alege aceeași Jurisdicție ca a bucketului. Apasă Verifică cheia.
  3. Scrie numele exact al bucketului și apasă Verifică accesul.
  4. Asistentul trece la pasul CORS, cu regula pe care trebuie să o adaugi.

Adaugă regula CORS

Regula CORS îi permite browserului să încarce și să descarce fișiere din bucketul tău pe https://nubbo.app. Este aceeași regulă pe care asistentul o arată la pasul CORS.

  1. În R2, deschide bucketul și mergi la Settings.
  2. La CORS Policy, apasă Add CORS policy și alege fila JSON.
  3. Lipește regula și apasă Save. Cloudflare poate avea nevoie de până la 30 de secunde ca să o aplice.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Pasul CORS cu regula de adăugat în bucket Pasul CORS cu regula de adăugat în bucket

După ce o salvezi, întoarce-te în Nubbo și apasă Am adăugat-o, verifică. Dacă cheia ta are voie să modifice CORS, Încearcă configurarea în locul meu o face pentru tine.

Dacă ceva nu merge

Mesajul din NubboCe faci
“Această cheie pare limitată la un singur bucket. Poți continua pe calea limitată sau poți crea o cheie cu acces complet.”Apasă Continuă cu o cheie limitată sau creează o cheie cu acces la tot contul și apasă Încearcă altă cheie.
“Cheia ta nu are permisiunea de a crea bucketuri.”Folosește o cheie cu acces complet sau creează bucketul în panoul tău și apasă L-am creat în panoul meu.
“Numele acesta este deja folosit la acest furnizor; încearcă altul.”Numele de bucketuri sunt unice la nivelul furnizorului: alege altul.
“Cheia ta nu are permisiunea de a-l configura.”Adaugă regula CORS manual, cum am explicat mai sus.
“Încă nu funcționează. Revizuiește regula și verifică din nou; unii provideri au nevoie de un minut ca să o aplice.”Verifică dacă originea este exact https://nubbo.app, fără bară la final, așteaptă un minut și verifică din nou.
“Acest bucket este deja folosit.”Bucketul este deja conectat în Nubbo, în contul tău sau în altul.
“Date de conectare nevalide. Verifică cheia de acces și cheia secretă de acces.”Verifică dacă ai lipit Access Key ID și Secret Access Key ale tokenului, nu valoarea tokenului API Cloudflare.
“Bucket-ul nu a fost găsit. Verifică numele și regiunea.”Verifică numele și dacă jurisdicția din Nubbo este cea a bucketului (R2 o arată în Settings ale bucketului).

Cât costă

R2 nu taxează traficul de ieșire și are un nivel gratuit lunar. Explicăm totul în Nivelul gratuit Cloudflare R2.

Întrebări frecvente

Unde găsesc Account ID-ul meu Cloudflare?

Pe pagina R2 Overview, la Account Details. Este un șir de 32 de caractere format din cifre și literele de la a la f.

Ce permisiune are nevoie tokenul R2?

Accesul minim de care are nevoie Nubbo este Object Read & Write limitat la bucketul tău, cu calea cu cheie limitată: scrii numele bucketului și adaugi tu regula CORS. Calea automată are nevoie de Admin Read & Write, cu care Nubbo îți listează bucketurile, creează unul și îi configurează CORS.

Ce regiune folosesc cu R2?

Niciuna: R2 folosește regiunea auto, iar Nubbo o setează pentru tine. Indicațiile de locație Cloudflare nu schimbă modul în care se conectează bucketul.

Pot conecta un bucket R2 cu jurisdicție, de exemplu cea a UE?

Da. La pasul Cheia ta, alege jurisdicția bucketului (EU, FedRAMP sau US). Fiecare are propriul endpoint, de exemplu https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, și arată doar bucketurile create în ea.

Descărcările din Nubbo costă trafic de ieșire în R2?

Nu. R2 nu taxează transferul de date spre exterior. Descărcările contează totuși ca operații de citire.

Surse

Prețurile și limitele provin din paginile oficiale de mai jos. Furnizorii le schimbă, așa că verifică-le înainte să te decizi.