Návody

Správce souborů pro Backblaze B2: připojte ho k Nubbo

Jak připojit bucket Backblaze B2 k Nubbo: aplikační klíč, region, průvodce krok za krokem, CORS přes B2 CLI a co dělat, když něco selže.

Nubbo se k Backblaze B2 připojuje přes jeho API kompatibilní s S3, pomocí aplikačního klíče a regionu 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 Backblaze B2. 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 Backblaze B2 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. V B2 se region volí při vytvoření účtu a platí pro všechny jeho buckety. Najdete ho v endpointu libovolného bucketu ve tvaru s3.<region>.backblazeb2.com: právě tento region zvolte v Nubbo. Hlavní klíč účtu s S3 API nefunguje, proto si vždy vytvořte aplikační klíč.

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

Automatické připojení

Krok 1: vytvořte klíč v Backblaze B2

  1. Na backblaze.com otevřete B2 Cloud Storage, Application Keys a stiskněte Add a New Application Key. Nepoužívejte master application key.
  2. Pojmenujte klíč, v Allow Access to Bucket(s) nastavte All a v Type of Access zvolte Read and Write. Stiskněte Create New Key.
  3. Zkopírujte keyID (access key) a applicationKey (secret). Backblaze ukáže applicationKey jen jednou.
  4. V Buckets se podívejte na endpoint libovolného bucketu a zjistíte svůj region.

Krok 2: připojte bucket v Nubbo

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

    Krok Poskytovatel v průvodci Nubbo s vybraným Backblaze B2 Krok Poskytovatel v průvodci Nubbo s vybraným Backblaze B2
  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 keyID a applicationKey a zvolte region svého účtu. Stiskněte Ověřit klíč. Nubbo ověří, že klíč funguje a má přístup k celému účtu.

    Krok Váš klíč pro Backblaze B2 s rychlým průvodcem a poli pro klíč Krok Váš klíč pro Backblaze B2 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

Potom v bucketu otevřete Lifecycle Settings a zvolte Keep only the last version of the file. Jinak si B2 ponechá všechny verze a mazání z Nubbo neuvolní místo.

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 Backblaze B2

  1. V Buckets stiskněte Create a Bucket, pojmenujte ho a nechte ho jako Private.
  2. V bucketu otevřete Lifecycle Settings a zvolte Keep only the last version of the file.
  3. Podívejte se na endpoint bucketu a zjistíte region.
  4. V Application Keys stiskněte Add a New Application Key, omezte přístup na svůj bucket s Read and Write a zaškrtněte Allow List All Bucket Names. Stiskněte Create New Key.
  5. Zkopírujte keyID a applicationKey.

Krok 2: připojte bucket v Nubbo

  1. V sekci Buckety stiskněte Připojit bucket, zvolte Backblaze B2 a potom S omezeným klíčem.
  2. Vložte keyID a applicationKey a zvolte region. 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.

Pravidla CORS v konzoli B2 jsou předvolby a nedovolí vybrat operace, proto se pravidlo Nubbo přidává příkazovým nástrojem B2 (b2) s klíčem, který může měnit nastavení bucketu.

  1. Nainstalujte CLI, například pomocí pip install b2.
  2. Přihlaste se svým keyID a applicationKey: b2 account authorize.
  3. Použijte pravidlo a nahraďte your-bucket názvem bucketu. allPrivate nechává bucket soukromý.
b2 bucket update --cors-rules '[{"corsRuleName":"nubbo","allowedOrigins":["https://nubbo.app"],"allowedOperations":["s3_get","s3_head","s3_put","s3_post","s3_delete"],"allowedHeaders":["*"],"exposeHeaders":["etag"],"maxAgeSeconds":3600}]' your-bucket allPrivate
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 použité, 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íč.
“Bucket nebyl nalezen. Ověřte název a region.”Zkontrolujte přesný název bucketu a že zvolený region je region bucketu.
“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 nepoužíváte master application key, který s S3 API nefunguje.
“Bucket se nachází v jiném regionu. Ověřte nastavený region.”Zvolte v Nubbo region uvedený v endpointu bucketu.

Kolik to stojí

Backblaze B2 účtuje za TB, s 10 GB zdarma a odchozím přenosem zdarma až do trojnásobku uloženého objemu. Vysvětlujeme to v článku Ceny Backblaze B2.

Časté dotazy

Mohu použít master application key od Backblaze?

Ne. Backblaze hlavní klíč ve svém API kompatibilním s S3 nepodporuje. Vytvořte si aplikační klíč v Application Keys.

Jaký region mám v Nubbo pro B2 zvolit?

Ten z endpointu vašich bucketů, ve tvaru s3.<region>.backblazeb2.com. V B2 jsou všechny buckety jednoho účtu ve stejném regionu.

Proč se CORS nastavuje přes B2 CLI?

Protože pravidla v konzoli jsou předvolby a nedovolí vybrat operace, které Nubbo potřebuje. CLI je nejjednodušší způsob, jak použít přesné pravidlo; funguje i jakýkoli nástroj pro S3, který spustí PutBucketCors proti endpointu B2.

Proč mazání v Nubbo neuvolní místo v B2?

Protože B2 ve výchozím stavu uchovává předchozí verze. V Lifecycle Settings bucketu zvolte Keep only the last version of the file.

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.