Návody

Správce souborů pro Cloudflare R2: připojte ho k Nubbo

Jak připojit bucket Cloudflare R2 k Nubbo: API token, Account ID, průvodce krok za krokem, pravidlo CORS a co dělat, když něco selže.

Nubbo se ke Cloudflare R2 připojuje pomocí API tokenu R2 a Account ID vašeho účtu. Za pár minut máte své buckety v průzkumníku souborů s přímým nahráváním, odkazy ke sdílení a galeriemi. Tento návod prochází průvodce Nubbo krok za krokem, a to oběma cestami: automaticky, nebo s klíčem omezeným na jeden bucket.

Co získáte

  • Procházejte bucket jako disk: složky, zobrazení, vyhledávání, koš, štítky a oblíbené.
  • Nahrávejte a stahujte soubory přímo mezi prohlížečem a Cloudflare R2. Soubory nikdy neprocházejí servery Nubbo.
  • Sdílejte soubory a složky s heslem, datem vypršení a limitem stažení, přijímejte soubory do svého bucketu a vytvářejte galerie.
  • Vaše klíče se ukládají zašifrované pomocí AES-256-GCM a bucket můžete kdykoli odpojit.

Než začnete

Potřebujete účet u Cloudflare R2 a účet Nubbo. Každý připojený bucket se započítává do limitu vašeho tarifu: tarif Zdarma umožňuje 2, Personal 5 a Pro nemá limit. Před prvním bucketem po vás Cloudflare chce aktivovat předplatné R2 v dashboardu. Pokud má váš bucket jurisdikci (EU, FedRAMP nebo US), vyberete ji v průvodci a Nubbo použije endpoint této jurisdikce.

Zvolte způsob připojení

Průvodce Nubbo nabízí dvě cesty. Obě končí stejně: bucket je připojený a připravený na nahrávání z prohlížeče.

AutomatickyS omezeným klíčem
KlíčPřístup k celému účtuOmezený na jeden bucket
BucketNubbo použije některý váš nebo vytvoří novýVytvoříte ho předem
CORSNubbo přidá pravidlo za vásPravidlo přidáte vy
Kdy ji zvolitNejrychlejší cestaKdyž nechcete dát přístup k celému účtu

Omezený klíč je nejmenší přístup, který Nubbo potřebuje: Object Read & Write pro jeden bucket. S ním Nubbo nemůže vypsat vaše buckety ani vytvořit nový, takže napíšete název bucketu a pravidlo CORS přidáte sami.

Automatické připojení

Krok 1: vytvořte klíč v Cloudflare R2

  1. Přihlaste se na dash.cloudflare.com a otevřete R2 object storage. Panel může zobrazovat nabídky ve vašem jazyce.
  2. Otevřete API Tokens a stiskněte Create Account API token. Dostanete se tam i z Overview, v Account Details, Manage.
  3. Zvolte oprávnění Admin Read & Write a token vytvořte.
  4. Zkopírujte Access Key ID a Secret Access Key. Cloudflare ukáže secret jen jednou. Použijte tyto dva klíče, ne hodnotu tokenu.
  5. Zkopírujte také své Account ID, které najdete na stránce Overview v R2.

Krok 2: připojte bucket v Nubbo

  1. V Nubbo otevřete Buckety a stiskněte Připojit bucket. Zvolte Cloudflare R2 a stiskněte Pokračovat.

    Krok Poskytovatel v průvodci Nubbo s vybraným Cloudflare R2 Krok Poskytovatel v průvodci Nubbo s vybraným Cloudflare R2
  2. Zvolte Automaticky a stiskněte Pokračovat.

    Krok Způsob připojení s možnostmi Automaticky a S omezeným klíčem Krok Způsob připojení s možnostmi Automaticky a S omezeným klíčem
  3. V kroku Váš klíč vložte Access Key ID, Secret Access Key a Account ID. Nubbo z Account ID sestaví endpoint vašeho účtu. Region R2 je vždy auto. Než stisknete Ověřit klíč, vyberte Jurisdikce svého bucketu: Výchozí (bez jurisdikce) pro většinu bucketů, nebo EU, FedRAMP či US. Endpoint se s ní mění (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com pro EU) a seznam ukazuje jen buckety v této jurisdikci. Stiskněte Ověřit klíč. Nubbo ověří, že klíč funguje a má přístup k celému účtu.

    Krok Váš klíč pro Cloudflare R2 s rychlým průvodcem a poli pro klíč Krok Váš klíč pro Cloudflare R2 s rychlým průvodcem a poli pro klíč
  4. Vyberte jeden ze svých bucketů a stiskněte Použít tento bucket, nebo zvolte Vytvořit nový, zadejte název (a vyberte region, pokud se na něj průvodce zeptá) a stiskněte Vytvořit a připravit. Nubbo přidá do bucketu pravidlo CORS, které povoluje nahrávání a stahování jen z aplikace, a zachová pravidla, která už bucket má.

    Krok Váš bucket se seznamem bucketů a možností Vytvořit nový Krok Váš bucket se seznamem bucketů a možností Vytvořit nový
  5. Projděte tři kontroly, případně změňte Název v Nubbo a stiskněte Dokončit. Bucket se objeví v sekci Buckety a můžete ho otevřít v průzkumníku.

    Krok Hotovo s kontrolami připojení, bucketu a CORS Krok Hotovo s kontrolami připojení, bucketu a CORS

Pokud Nubbo s vaším klíčem nemůže pravidlo CORS přidat, průvodce vás přesune do kroku CORS. Pak postupujte podle části Přidejte pravidlo CORS.

Připojení s omezeným klíčem

Krok 1: připravte bucket a klíč v Cloudflare R2

  1. V R2, Overview stiskněte Create bucket a pojmenujte ho (malá písmena, číslice a spojovníky). Region se nevolí. Pokud data musí zůstat v EU, zvolte jurisdikci EU: endpoint se s ní mění.
  2. Otevřete API Tokens a stiskněte Create Account API token.
  3. Zvolte oprávnění Object Read & Write a omezte ho na svůj bucket.
  4. Zkopírujte Access Key ID, Secret Access Key a své Account ID.

Krok 2: připojte bucket v Nubbo

  1. V sekci Buckety stiskněte Připojit bucket, zvolte Cloudflare R2 a potom S omezeným klíčem.
  2. Vložte Access Key ID, Secret Access Key a Account ID. Než stisknete Ověřit klíč, vyberte stejnou Jurisdikce jako u bucketu. Stiskněte Ověřit klíč.
  3. Zadejte přesný název bucketu a stiskněte Ověřit přístup.
  4. Průvodce přejde do kroku CORS s pravidlem, které musíte přidat.

Přidejte pravidlo CORS

Pravidlo CORS umožňuje prohlížeči nahrávat a stahovat soubory z vašeho bucketu na https://nubbo.app. Je to stejné pravidlo, jaké průvodce ukazuje v kroku CORS.

  1. V R2 otevřete bucket a přejděte do Settings.
  2. V části CORS Policy stiskněte Add CORS policy a vyberte kartu JSON.
  3. Vložte pravidlo a stiskněte Save. Cloudflare může trvat až 30 sekund, než ho začne uplatňovat.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Krok CORS s pravidlem, které je třeba přidat do bucketu Krok CORS s pravidlem, které je třeba přidat do bucketu

Jakmile je uložené, vraťte se do Nubbo a stiskněte Přidáno, ověřit. Pokud má váš klíč oprávnění měnit CORS, tlačítko Zkusit to nastavit za mě to udělá za vás.

Když něco selže

Zpráva v NubboCo dělat
“Tento klíč se zdá být omezený na jeden bucket. Můžete pokračovat omezenou cestou, nebo vytvořit klíč s plným přístupem.”Stiskněte Pokračovat s omezeným klíčem, nebo vytvořte klíč s přístupem k celému účtu a stiskněte Zkusit jiný klíč.
“Váš klíč nemá oprávnění vytvářet buckety.”Použijte klíč s plným přístupem, nebo vytvořte bucket ve svém panelu a stiskněte Už ho mám ve svém panelu.
“Tento název už se u tohoto poskytovatele používá; zkuste jiný.”Názvy bucketů jsou u poskytovatele jedinečné: zvolte jiný.
“Váš klíč nemá oprávnění to nastavit.”Přidejte pravidlo CORS ručně, jak je popsáno výše.
“Zatím to nefunguje. Zkontrolujte pravidlo a ověřte znovu; některým poskytovatelům trvá minutu, než ho použijí.”Zkontrolujte, že origin je přesně https://nubbo.app bez lomítka na konci, počkejte minutu a ověřte znovu.
“Tento bucket je již používán.”Tento bucket je už v Nubbo připojený, ve vašem účtu nebo v jiném.
“Neplatné přihlašovací údaje. Zkontrolujte přístupový klíč a tajný přístupový klíč.”Zkontrolujte, že jste vložili Access Key ID a Secret Access Key tokenu, ne hodnotu API tokenu Cloudflare.
“Bucket nebyl nalezen. Ověřte název a region.”Zkontrolujte název a to, zda jurisdikce v Nubbo odpovídá jurisdikci bucketu (R2 ji ukazuje v Settings bucketu).

Kolik to stojí

R2 neúčtuje odchozí přenos a má měsíční bezplatnou úroveň. Vysvětlujeme to v článku Bezplatná úroveň Cloudflare R2.

Časté dotazy

Kde najdu své Account ID v Cloudflare?

Na stránce R2 Overview v části Account Details. Je to řetězec 32 znaků složený z číslic a písmen a až f.

Jaké oprávnění potřebuje token R2?

Nejmenší přístup, který Nubbo potřebuje, je Object Read & Write omezený na váš bucket, s cestou s omezeným klíčem: napíšete název bucketu a pravidlo CORS přidáte sami. Automatická cesta potřebuje Admin Read & Write, se kterým Nubbo vypíše vaše buckety, vytvoří nový a nastaví jeho CORS.

Jaký region mám s R2 použít?

Žádný: R2 používá region auto a Nubbo ho nastaví za vás. Location hints od Cloudflare nemění způsob, jakým se bucket připojuje.

Mohu připojit bucket R2 s jurisdikcí, například EU?

Ano. V kroku Váš klíč vyberte jurisdikci bucketu (EU, FedRAMP nebo US). Každá má vlastní endpoint, například https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, a zobrazuje jen buckety v ní vytvořené.

Platím u R2 za odchozí přenos při stahování z Nubbo?

Ne. R2 neúčtuje odchozí přenos dat. Stahování se ale počítá jako operace čtení.

Zdroje

Ceny a limity pocházejí z níže uvedených oficiálních stránek. Poskytovatelé je mění, proto si je před rozhodnutím ověřte.