Správca súborov pre Cloudflare R2: pripojte ho k Nubbo

Nubbo sa k Cloudflare R2 pripája pomocou API tokenu R2 a Account ID vášho účtu. Za pár minút máte buckety v prehliadači súborov s priamym nahrávaním, odkazmi na zdieľanie a galériami. Tento návod sleduje sprievodcu Nubbo krok za krokom a pokrýva obe cesty: automatickú aj s kľúčom obmedzeným na jeden bucket.

Čo získate

• Prehliadanie bucketu ako disku: priečinky, zobrazenia, vyhľadávanie, kôš, štítky a obľúbené.
• Nahrávanie a sťahovanie súborov priamo medzi vaším prehliadačom a Cloudflare R2. Súbory nikdy neprechádzajú cez servery Nubbo.
• Zdieľanie súborov a priečinkov s heslom, dátumom vypršania a limitom stiahnutí, prijímanie súborov do bucketu a vytváranie galérií.
• Vaše kľúče sú uložené zašifrované pomocou AES-256-GCM a bucket môžete kedykoľvek odpojiť.

Skôr než začnete

Potrebujete účet v Cloudflare R2 a účet v Nubbo. Každý pripojený bucket sa započítava do limitu vášho plánu: Bezplatný plán umožňuje 2, Personal 5 a Pro nemá limit. Pred prvým bucketom vás Cloudflare požiada, aby ste v dashboarde aktivovali predplatné R2. Ak má váš bucket jurisdikciu (EU, FedRAMP alebo US), vyberiete ju v sprievodcovi a Nubbo použije endpoint tejto jurisdikcie.

Zvoľte spôsob pripojenia

Sprievodca Nubbo ponúka dve cesty. Obe končia rovnako: bucket je pripojený a pripravený na nahrávanie z prehliadača.

Obmedzený kľúč je najmenší prístup, ktorý Nubbo potrebuje: Object Read & Write pre jeden bucket. S ním Nubbo nemôže vypísať vaše buckety ani vytvoriť nový, takže napíšete názov bucketu a pravidlo CORS pridáte sami.

Automatické pripojenie

Krok 1: vytvorte kľúč v Cloudflare R2

1. Prihláste sa na dash.cloudflare.com a otvorte R2 object storage. Panel môže zobrazovať ponuky vo vašom jazyku.
2. Otvorte API Tokens a stlačte Create Account API token. Dostanete sa tam aj z Overview, v Account Details, Manage.
3. Zvoľte oprávnenie Admin Read & Write a vytvorte token.
4. Skopírujte Access Key ID a Secret Access Key. Cloudflare zobrazí tajný kľúč iba raz. Použite tieto dva kľúče, nie hodnotu tokenu.
5. Skopírujte aj svoje Account ID, ktoré nájdete na stránke R2 Overview.

Krok 2: pripojte bucket v Nubbo

1. V Nubbo otvorte Buckety a stlačte Pripojiť bucket. Vyberte Cloudflare R2 a stlačte Pokračovať.

   

2. Zvoľte Automaticky a stlačte Pokračovať.

   

3. V kroku Váš kľúč vložte Access Key ID, Secret Access Key a Account ID. Nubbo z Account ID zostaví endpoint vášho účtu. Región R2 je vždy auto. Skôr ako stlačíte Overiť kľúč, vyberte Jurisdikcia svojho bucketu: Predvolená (bez jurisdikcie) pre väčšinu bucketov, alebo EU, FedRAMP či US. Endpoint sa s ňou mení (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com pre EÚ) a zoznam ukazuje iba buckety v tejto jurisdikcii. Stlačte Overiť kľúč. Nubbo overí, že kľúč funguje a že má prístup k celému účtu.

   

4. Vyberte jeden zo svojich bucketov a stlačte Použiť tento bucket, alebo zvoľte Vytvoriť nový, zadajte názov (a vyberte región, ak sa naň pýta) a stlačte Vytvoriť a pripraviť. Nubbo pridá do bucketu pravidlo CORS, ktoré povoľuje nahrávanie a sťahovanie len z aplikácie, a zachová pravidlá, ktoré už má.

   

5. Skontrolujte tri overenia, ak chcete, zmeňte Názov v Nubbo a stlačte Dokončiť. Bucket sa zobrazí v sekcii Buckety a môžete ho otvoriť v prehliadači súborov.

   

Ak Nubbo s vaším kľúčom nemôže pravidlo CORS pridať, sprievodca vás presunie do kroku CORS. Potom postupujte podľa časti Pridajte pravidlo CORS.

Pripojenie s obmedzeným kľúčom

Krok 1: pripravte bucket a kľúč v Cloudflare R2

1. V R2, Overview stlačte Create bucket a zadajte názov (malé písmená, číslice a spojovníky). Región sa nevyberá. Ak dáta musia zostať v EÚ, zvoľte jurisdikciu EU: endpoint sa s ňou mení.
2. Otvorte API Tokens a stlačte Create Account API token.
3. Zvoľte oprávnenie Object Read & Write a obmedzte ho na svoj bucket.
4. Skopírujte Access Key ID, Secret Access Key a svoje Account ID.

Krok 2: pripojte bucket v Nubbo

1. V sekcii Buckety stlačte Pripojiť bucket, vyberte Cloudflare R2 a potom S obmedzeným kľúčom.
2. Vložte Access Key ID, Secret Access Key a Account ID. Skôr ako stlačíte Overiť kľúč, vyberte rovnakú Jurisdikcia ako pri buckete. Stlačte Overiť kľúč.
3. Zadajte presný názov bucketu a stlačte Overiť prístup.
4. Sprievodca prejde do kroku CORS s pravidlom, ktoré treba pridať.

Pridajte pravidlo CORS

Pravidlo CORS umožňuje prehliadaču nahrávať a sťahovať súbory z vášho bucketu na https://nubbo.app. Je to to isté pravidlo, ktoré sprievodca zobrazuje v kroku CORS.

1. V R2 otvorte bucket a prejdite do Settings.
2. V časti CORS Policy stlačte Add CORS policy a vyberte kartu JSON.
3. Vložte pravidlo a stlačte Save. Cloudflare môže jeho použitie trvať až 30 sekúnd.

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

Keď ho uložíte, vráťte sa do Nubbo a stlačte Pridané, overiť. Ak má váš kľúč oprávnenie meniť CORS, Skúsiť to nastaviť za mňa to urobí za vás.

Keď niečo zlyhá

Koľko to stojí

R2 neúčtuje odchádzajúci prenos a má mesačnú bezplatnú úroveň. Vysvetľujeme to v článku Bezplatná úroveň Cloudflare R2.