Gidsen

Bestandsbeheer voor Cloudflare R2: koppel het aan Nubbo

Zo koppel je een Cloudflare R2-bucket aan Nubbo: de API-token, de Account ID, de wizard stap voor stap, de CORS-regel en wat te doen als iets misgaat.

Nubbo verbindt met Cloudflare R2 via een R2 API-token en de Account ID van je account. Binnen een paar minuten staan je buckets in een bestandsverkenner met directe uploads, deellinks en galerijen. Deze gids volgt de wizard van Nubbo stap voor stap, met beide routes: automatisch of met een sleutel die tot één bucket is beperkt.

Wat je krijgt

  • Blader door de bucket alsof het een schijf is: mappen, weergaven, zoeken, prullenbak, labels en favorieten.
  • Upload en download bestanden rechtstreeks tussen je browser en Cloudflare R2. Bestanden gaan nooit via de servers van Nubbo.
  • Deel bestanden en mappen met een wachtwoord, vervaldatum en downloadlimiet, ontvang bestanden in je bucket en maak galerijen.
  • Je sleutels worden versleuteld opgeslagen met AES-256-GCM en je kunt de bucket op elk moment loskoppelen.

Voordat je begint

Je hebt een account bij Cloudflare R2 en een Nubbo-account nodig. Elke bucket die je koppelt telt mee voor de limiet van je abonnement: het Gratis-abonnement staat er 2 toe, Personal 5 en Pro heeft geen limiet. Voor je eerste bucket vraagt Cloudflare je om het R2-abonnement te activeren via het dashboard. Heeft je bucket een jurisdictie (EU, FedRAMP of US), dan kies je die in de wizard en gebruikt Nubbo het endpoint van die jurisdictie.

Kies hoe je verbindt

De wizard van Nubbo biedt twee routes. Beide eindigen op dezelfde manier: de bucket is verbonden en klaar voor uploads vanuit de browser.

AutomatischMet een beperkte sleutel
SleutelToegang tot het hele accountBeperkt tot één bucket
BucketNubbo gebruikt een van de jouwe of maakt er eenJe maakt hem eerst zelf aan
CORSNubbo voegt de regel voor je toeJe voegt de regel zelf toe
Wanneer kiezenDe snelste manierAls je geen toegang tot het hele account wilt geven

De beperkte sleutel is de minste toegang die Nubbo nodig heeft: Object Read & Write op één bucket. Daarmee kan Nubbo je buckets niet tonen en er geen aanmaken, dus je typt de naam van de bucket en voegt de CORS-regel zelf toe.

Automatische verbinding

Stap 1: maak de sleutel aan in Cloudflare R2

  1. Log in op dash.cloudflare.com en open R2 object storage. Het dashboard kan de menu’s in jouw taal tonen.
  2. Open API Tokens en klik op Create Account API token. Je komt er ook via Overview, onder Account Details, Manage.
  3. Kies de machtiging Admin Read & Write en maak de token aan.
  4. Kopieer de Access Key ID en de Secret Access Key. Cloudflare toont de secret maar één keer. Gebruik deze twee sleutels, niet de waarde van de token.
  5. Kopieer ook je Account ID, die op de pagina Overview van R2 staat.

Stap 2: verbind de bucket in Nubbo

  1. Open in Nubbo Buckets en klik op Bucket koppelen. Kies Cloudflare R2 en klik op Doorgaan.

    Stap Provider van de Nubbo-wizard met Cloudflare R2 geselecteerd Stap Provider van de Nubbo-wizard met Cloudflare R2 geselecteerd
  2. Kies Automatisch en klik op Doorgaan.

    Stap Verbindingswijze met de opties Automatisch en Met een beperkte sleutel Stap Verbindingswijze met de opties Automatisch en Met een beperkte sleutel
  3. Plak in de stap Je sleutel de Access Key ID, de Secret Access Key en de Account ID. Nubbo stelt het endpoint van je account samen uit de Account ID. De regio van R2 is altijd auto. Kies voordat je op Sleutel controleren klikt de Jurisdictie van je bucket: Standaard (geen jurisdictie) voor de meeste buckets, of EU, FedRAMP of US. Het endpoint verandert mee (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com voor de EU) en de lijst toont alleen buckets in die jurisdictie. Klik op Sleutel controleren. Nubbo controleert of de sleutel werkt en of hij toegang heeft tot het hele account.

    Stap Je sleutel voor Cloudflare R2 met de snelle handleiding en de sleutelvelden Stap Je sleutel voor Cloudflare R2 met de snelle handleiding en de sleutelvelden
  4. Kies een van je buckets en klik op Deze bucket gebruiken, of selecteer Nieuwe maken, typ een naam (en kies de regio, als daarom gevraagd wordt) en klik op Maken en voorbereiden. Nubbo voegt een CORS-regel aan de bucket toe die alleen uploads en downloads vanuit de app toestaat, en laat de bestaande regels staan.

    Stap Je bucket met de lijst van buckets en de optie Nieuwe maken Stap Je bucket met de lijst van buckets en de optie Nieuwe maken
  5. Bekijk de drie controles, wijzig eventueel de Naam in Nubbo en klik op Afronden. De bucket verschijnt in Buckets en je kunt hem openen in de verkenner.

    Stap Klaar met de controles van verbinding, bucket en CORS Stap Klaar met de controles van verbinding, bucket en CORS

Als Nubbo de CORS-regel niet met je sleutel kan toevoegen, brengt de wizard je naar de stap CORS. Volg dan Voeg de CORS-regel toe.

Verbinding met een beperkte sleutel

Stap 1: bereid de bucket en de sleutel voor in Cloudflare R2

  1. Klik in R2, Overview op Create bucket en geef hem een naam (kleine letters, cijfers en koppeltekens). Er is geen regio om te kiezen. Als de gegevens in de EU moeten blijven, kies dan de jurisdictie EU: het endpoint verandert mee.
  2. Open API Tokens en klik op Create Account API token.
  3. Kies de machtiging Object Read & Write en beperk die tot je bucket.
  4. Kopieer de Access Key ID, de Secret Access Key en je Account ID.

Stap 2: verbind de bucket in Nubbo

  1. Klik in Buckets op Bucket koppelen, kies Cloudflare R2 en daarna Met een beperkte sleutel.
  2. Plak de Access Key ID, de Secret Access Key en de Account ID. Kies voordat je op Sleutel controleren klikt dezelfde Jurisdictie als de bucket. Klik op Sleutel controleren.
  3. Typ de exacte naam van de bucket en klik op Toegang controleren.
  4. De wizard gaat naar de stap CORS met de regel die je moet toevoegen.

Voeg de CORS-regel toe

Met de CORS-regel kan de browser bestanden uit je bucket uploaden en downloaden op https://nubbo.app. Het is dezelfde regel die de wizard in de stap CORS toont.

  1. Open in R2 de bucket en ga naar Settings.
  2. Klik onder CORS Policy op Add CORS policy en kies het tabblad JSON.
  3. Plak de regel en klik op Save. Het kan tot 30 seconden duren voordat Cloudflare hem toepast.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Stap CORS met de regel die je aan de bucket toevoegt Stap CORS met de regel die je aan de bucket toevoegt

Ga na het opslaan terug naar Nubbo en klik op Toegevoegd, controleren. Als je sleutel CORS mag wijzigen, doet Probeer het voor mij in te stellen het voor je.

Als er iets misgaat

Melding in NubboWat te doen
“Deze sleutel lijkt beperkt tot één bucket. Je kunt doorgaan met de beperkte route of een sleutel met volledige toegang maken.”Klik op Doorgaan met een beperkte sleutel, of maak een sleutel met toegang tot het hele account en klik op Andere sleutel proberen.
“Je sleutel heeft geen toestemming om buckets te maken.”Gebruik een sleutel met volledige toegang, of maak de bucket in je paneel en klik op Ik heb hem in mijn paneel gemaakt.
“Die naam is al in gebruik bij deze provider; probeer een andere.”Bucketnamen zijn uniek binnen de provider: kies een andere.
“Je sleutel heeft geen toestemming om dit in te stellen.”Voeg de CORS-regel handmatig toe, zoals hierboven uitgelegd.
“Het werkt nog niet. Controleer de regel en probeer het opnieuw; sommige providers hebben een minuut nodig om hem toe te passen.”Controleer of de origin precies https://nubbo.app is, zonder slash aan het eind, wacht een minuut en controleer opnieuw.
“Deze bucket is al in gebruik.”Die bucket is al gekoppeld in Nubbo, in je eigen account of in een ander account.
“Ongeldige gegevens. Controleer de access key en secret access key.”Controleer of je de Access Key ID en de Secret Access Key van de token hebt geplakt, en niet de waarde van de Cloudflare API-token.
“Bucket niet gevonden. Controleer de naam en regio.”Controleer de naam en of de jurisdictie in Nubbo die van de bucket is (R2 toont die in de Settings van de bucket).

Wat het kost

R2 rekent niets voor egress en heeft een maandelijkse gratis laag. We leggen het uit in Gratis laag van Cloudflare R2.

Veelgestelde vragen

Waar vind ik mijn Cloudflare Account ID?

Op de pagina R2 Overview, onder Account Details. Het is een reeks van 32 tekens met cijfers en de letters a tot en met f.

Welke machtiging heeft de R2-token nodig?

De minste toegang die Nubbo nodig heeft is Object Read & Write beperkt tot je bucket, met de route met beperkte sleutel: je typt de naam van de bucket en voegt de CORS-regel zelf toe. De automatische route heeft Admin Read & Write nodig, zodat Nubbo je buckets kan tonen, er een kan aanmaken en de CORS kan instellen.

Welke regio gebruik ik met R2?

Geen: R2 gebruikt de regio auto en Nubbo stelt die voor je in. De location hints van Cloudflare veranderen niets aan hoe de bucket verbindt.

Kan ik een R2-bucket met een jurisdictie koppelen, zoals die van de EU?

Ja. Kies in de stap Je sleutel de jurisdictie van de bucket (EU, FedRAMP of US). Elke jurisdictie heeft een eigen endpoint, zoals https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, en toont alleen de buckets die erin zijn gemaakt.

Kosten downloads vanuit Nubbo egress bij R2?

Nee. R2 rekent niets voor uitgaand dataverkeer. Downloads tellen wel als leesbewerkingen.

Bronnen

Prijzen en limieten komen van de officiële pagina's hieronder. Providers passen ze aan, dus controleer ze voordat je een keuze maakt.