Menedżer plików dla Cloudflare R2: połącz go z Nubbo

Nubbo łączy się z Cloudflare R2 za pomocą tokenu API R2 i Account ID twojego konta. W kilka minut twoje buckety trafiają do eksploratora plików z bezpośrednim przesyłaniem, linkami udostępniającymi i galeriami. Ten poradnik prowadzi krok po kroku przez kreator Nubbo, obiema ścieżkami: automatyczną lub z kluczem ograniczonym do jednego bucketu.

Co zyskujesz

• Przeglądasz bucket jak dysk: foldery, widoki, wyszukiwanie, kosz, etykiety i ulubione.
• Przesyłasz i pobierasz pliki bezpośrednio między przeglądarką a Cloudflare R2. Pliki nigdy nie przechodzą przez serwery Nubbo.
• Udostępniasz pliki i foldery z hasłem, datą wygaśnięcia i limitem pobrań, odbierasz pliki do swojego bucketu i tworzysz galerie.
• Twoje klucze są przechowywane w postaci zaszyfrowanej algorytmem AES-256-GCM, a bucket możesz odłączyć w każdej chwili.

Zanim zaczniesz

Potrzebujesz konta w Cloudflare R2 i konta w Nubbo. Każdy połączony bucket wlicza się do limitu twojego planu: plan Bezpłatny pozwala na 2, Personal na 5, a Pro nie ma limitu. Przed utworzeniem pierwszego bucketu Cloudflare prosi o aktywowanie subskrypcji R2 w panelu. Jeśli Twój bucket ma jurysdykcję (EU, FedRAMP lub US), wybierasz ją w kreatorze, a Nubbo używa endpointu tej jurysdykcji.

Wybierz sposób połączenia

Kreator Nubbo oferuje dwie ścieżki. Obie kończą się tak samo: bucket jest połączony i gotowy do przesyłania z przeglądarki.

Ograniczony klucz to najmniejszy dostęp, jakiego potrzebuje Nubbo: Object Read & Write do jednego bucketu. Z nim Nubbo nie może wyświetlić Twoich bucketów ani utworzyć nowego, więc wpisujesz nazwę bucketu i sam dodajesz regułę CORS.

Połączenie automatyczne

Krok 1: utwórz klucz w Cloudflare R2

1. Zaloguj się na dash.cloudflare.com i otwórz R2 object storage. Panel może wyświetlać menu w Twoim języku.
2. Otwórz API Tokens i naciśnij Create Account API token. Dotrzesz tam też z Overview, w Account Details, Manage.
3. Wybierz uprawnienie Admin Read & Write i utwórz token.
4. Skopiuj Access Key ID i Secret Access Key. Cloudflare pokazuje secret tylko raz. Używaj tych dwóch kluczy, a nie wartości tokenu.
5. Skopiuj też swoje Account ID, widoczne na stronie R2 Overview.

Krok 2: połącz bucket w Nubbo

1. W Nubbo otwórz Buckety i naciśnij Połącz bucket. Wybierz Cloudflare R2 i naciśnij Dalej.

   

2. Wybierz Automatycznie i naciśnij Dalej.

   

3. W kroku Twój klucz wklej Access Key ID, Secret Access Key i Account ID. Nubbo tworzy endpoint twojego konta na podstawie Account ID. Region R2 to zawsze auto. Zanim naciśniesz Sprawdź klucz, wybierz Jurysdykcja swojego bucketu: Domyślna (bez jurysdykcji) dla większości bucketów albo EU, FedRAMP lub US. Endpoint zmienia się razem z nią (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com dla UE), a lista pokazuje tylko buckety tej jurysdykcji. Naciśnij Sprawdź klucz. Nubbo sprawdza, czy klucz działa i czy ma dostęp do całego konta.

   

4. Wybierz jeden ze swoich bucketów i naciśnij Użyj tego bucketu albo zaznacz Utwórz nowy, wpisz nazwę (i wybierz region, jeśli o niego poprosi) i naciśnij Utwórz i przygotuj. Nubbo dodaje do bucketu regułę CORS, która pozwala na przesyłanie i pobieranie tylko z aplikacji, i zachowuje reguły, które bucket już ma.

   

5. Przejrzyj trzy weryfikacje, jeśli chcesz, zmień pole Nazwa w Nubbo i naciśnij Zakończ. Bucket pojawi się w sekcji Buckety i możesz go otworzyć w eksploratorze.

   

Jeśli Nubbo nie może dodać reguły CORS twoim kluczem, kreator przeniesie cię do kroku CORS. Wtedy postępuj według sekcji Dodaj regułę CORS.

Połączenie z ograniczonym kluczem

Krok 1: przygotuj bucket i klucz w Cloudflare R2

1. W R2, Overview naciśnij Create bucket i nadaj mu nazwę (małe litery, cyfry i łączniki). Nie trzeba wybierać regionu. Jeśli dane muszą zostać w UE, wybierz jurysdykcję EU: endpoint zmienia się razem z nią.
2. Otwórz API Tokens i naciśnij Create Account API token.
3. Wybierz uprawnienie Object Read & Write i ogranicz je do swojego bucketu.
4. Skopiuj Access Key ID, Secret Access Key i swoje Account ID.

Krok 2: połącz bucket w Nubbo

1. W sekcji Buckety naciśnij Połącz bucket, wybierz Cloudflare R2, a potem Z ograniczonym kluczem.
2. Wklej Access Key ID, Secret Access Key i Account ID. Zanim naciśniesz Sprawdź klucz, wybierz tę samą Jurysdykcja co bucket. Naciśnij Sprawdź klucz.
3. Wpisz dokładną nazwę bucketu i naciśnij Sprawdź dostęp.
4. Kreator przejdzie do kroku CORS z regułą, którą musisz dodać.

Dodaj regułę CORS

Reguła CORS pozwala przeglądarce przesyłać i pobierać pliki z twojego bucketu na https://nubbo.app. To ta sama reguła, którą kreator pokazuje w kroku CORS.

1. W R2 otwórz bucket i przejdź do Settings.
2. W sekcji CORS Policy naciśnij Add CORS policy i wybierz kartę JSON.
3. Wklej regułę i naciśnij Save. Cloudflare może potrzebować do 30 sekund, aby ją zastosować.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Po zapisaniu wróć do Nubbo i naciśnij Dodane, sprawdź. Jeśli twój klucz może zmieniać CORS, Spróbuj skonfigurować za mnie zrobi to za ciebie.

Jeśli coś pójdzie nie tak

Ile to kosztuje

R2 nie pobiera opłat za transfer wychodzący i ma miesięczny darmowy limit. Wyjaśniamy to w artykule Darmowy plan Cloudflare R2.