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.
| Automaticky | S omezeným klíčem | |
|---|---|---|
| Klíč | Přístup k celému účtu | Omezený na jeden bucket |
| Bucket | Nubbo použije některý váš nebo vytvoří nový | Vytvoříte ho předem |
| CORS | Nubbo přidá pravidlo za vás | Pravidlo přidáte vy |
| Kdy ji zvolit | Nejrychlejší cesta | Když 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
- Přihlaste se na dash.cloudflare.com a otevřete R2 object storage. Panel může zobrazovat nabídky ve vašem jazyce.
- Otevřete API Tokens a stiskněte Create Account API token. Dostanete se tam i z Overview, v Account Details, Manage.
- Zvolte oprávnění Admin Read & Write a token vytvořte.
- Zkopírujte Access Key ID a Secret Access Key. Cloudflare ukáže secret jen jednou. Použijte tyto dva klíče, ne hodnotu tokenu.
- Zkopírujte také své Account ID, které najdete na stránce Overview v R2.
Krok 2: připojte bucket v Nubbo
V Nubbo otevřete Buckety a stiskněte Připojit bucket. Zvolte Cloudflare R2 a stiskněte Pokračovat.

Zvolte Automaticky a stiskněte Pokračovat.

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.compro 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.

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á.

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.

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
- 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í.
- Otevřete API Tokens a stiskněte Create Account API token.
- Zvolte oprávnění Object Read & Write a omezte ho na svůj bucket.
- Zkopírujte Access Key ID, Secret Access Key a své Account ID.
Krok 2: připojte bucket v Nubbo
- V sekci Buckety stiskněte Připojit bucket, zvolte Cloudflare R2 a potom S omezeným klíčem.
- 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íč.
- Zadejte přesný název bucketu a stiskněte Ověřit přístup.
- 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.
- V R2 otevřete bucket a přejděte do Settings.
- V části CORS Policy stiskněte Add CORS policy a vyberte kartu JSON.
- 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
}
]

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 Nubbo | Co 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.