Útmutatók

Fájlkezelő Backblaze B2-höz: csatlakoztasd a Nubbóhoz

Így csatlakoztatsz egy Backblaze B2 bucketet a Nubbóhoz: alkalmazáskulcs, régió, a varázsló lépésről lépésre, CORS a B2 CLI-vel és hibaelhárítás.

A Nubbo az S3-kompatibilis API-n keresztül, egy alkalmazáskulccsal és a fiókod régiójával csatlakozik a Backblaze B2-höz. Néhány perc alatt a bucketjeid egy fájlkezelőben lesznek, közvetlen feltöltéssel, megosztási linkekkel és galériákkal. Ez az útmutató lépésről lépésre követi a Nubbo varázslóját, mindkét úttal: automatikusan vagy egy bucketre korlátozott kulccsal.

Mit kapsz

  • Úgy böngészheted a bucketet, mint egy meghajtót: mappák, nézetek, keresés, lomtár, címkék és kedvencek.
  • A fájlok feltöltése és letöltése közvetlenül a böngésződ és a Backblaze B2 között zajlik. A fájlok soha nem haladnak át a Nubbo szerverein.
  • Megoszthatsz fájlokat és mappákat jelszóval, lejárati idővel és letöltési korláttal, fájlokat fogadhatsz a bucketedbe, és galériákat készíthetsz.
  • A kulcsaidat AES-256-GCM titkosítással tároljuk, a bucketet pedig bármikor leválaszthatod.

Mielőtt elkezdenéd

Szükséged van egy Backblaze B2-fiókra és egy Nubbo-fiókra. Minden csatlakoztatott bucket beleszámít a csomagod korlátjába: az Ingyenes csomag 2-t enged, a Personal 5-öt, a Pro pedig korlátlant. A B2-n a régiót a fiók létrehozásakor választod ki, és az összes bucketre érvényes. Bármelyik bucket endpointjában látod, s3.<region>.backblazeb2.com formában: ezt a régiót kell kiválasztanod a Nubbóban. A fiók fő kulcsa nem működik az S3 API-val, ezért mindig hozz létre egy alkalmazáskulcsot.

Válaszd ki, hogyan csatlakozol

A Nubbo varázslója két utat kínál. Mindkettő ugyanúgy végződik: a bucket csatlakoztatva van, és készen áll a böngészőből érkező feltöltésekre.

AutomatikusKorlátozott kulccsal
KulcsHozzáférés a teljes fiókhozEgy bucketre korlátozva
BucketA Nubbo a tiédet használja, vagy újat hoz létreElőbb te hozod létre
CORSA Nubbo hozzáadja helyetted a szabálytTe adod hozzá a szabályt
Mikor válaszdA leggyorsabb útHa nem akarsz hozzáférést adni a teljes fiókhoz

Automatikus csatlakozás

1. lépés: hozd létre a kulcsot a Backblaze B2-ben

  1. A backblaze.com oldalon nyisd meg a B2 Cloud Storage, Application Keys részt, és kattints az Add a New Application Key gombra. Ne a fő alkalmazáskulcsot (master application key) használd.
  2. Adj neki nevet, az Allow Access to Bucket(s) értéke legyen All, a Type of Access értéke pedig Read and Write. Kattints a Create New Key gombra.
  3. Másold ki a keyID-t (az access key) és az applicationKey-t (a secret). A Backblaze az applicationKey-t csak egyszer mutatja meg.
  4. A Buckets részen nézd meg bármelyik bucket endpointját, abból látod a régiódat.

2. lépés: csatlakoztasd a bucketet a Nubbóban

  1. A Nubbóban nyisd meg a Bucketek oldalt, és kattints a Bucket csatlakoztatása gombra. Válaszd a Backblaze B2 lehetőséget, és kattints a Tovább gombra.

    A Nubbo varázslójának Szolgáltató lépése, kiválasztott Backblaze B2-vel A Nubbo varázslójának Szolgáltató lépése, kiválasztott Backblaze B2-vel
  2. Válaszd az Automatikus lehetőséget, és kattints a Tovább gombra.

    A Csatlakozás módja lépés az Automatikus és a Korlátozott kulccsal lehetőséggel A Csatlakozás módja lépés az Automatikus és a Korlátozott kulccsal lehetőséggel
  3. A Kulcsod lépésben illeszd be a keyID-t és az applicationKey-t, és válaszd ki a fiókod régióját. Kattints a Kulcs ellenőrzése gombra. A Nubbo ellenőrzi, hogy a kulcs működik-e, és hozzáfér-e a teljes fiókhoz.

    A Kulcsod lépés Backblaze B2-höz a gyors útmutatóval és a kulcsmezőkkel A Kulcsod lépés Backblaze B2-höz a gyors útmutatóval és a kulcsmezőkkel
  4. Válaszd ki valamelyik bucketedet, és kattints a Bucket használata gombra, vagy jelöld be az Új létrehozása lehetőséget, írj be egy nevet (és válaszd ki a régiót, ha kéri), majd kattints a Létrehozás és előkészítés gombra. A Nubbo hozzáad a buckethez egy CORS-szabályt, amely csak az alkalmazásból engedélyez feltöltést és letöltést, a meglévő szabályokat pedig megtartja.

    A Bucketed lépés a bucketek listájával és az Új létrehozása lehetőséggel A Bucketed lépés a bucketek listájával és az Új létrehozása lehetőséggel
  5. Nézd át a három ellenőrzést, ha szeretnéd, módosítsd a Név a Nubbóban mezőt, és kattints a Befejezés gombra. A bucket megjelenik a Bucketek oldalon, és megnyithatod a fájlkezelőben.

    A Kész lépés a kapcsolat, a bucket és a CORS ellenőrzésével A Kész lépés a kapcsolat, a bucket és a CORS ellenőrzésével

Ezután a bucketben nyisd meg a Lifecycle Settings beállításokat, és válaszd a Keep only the last version of the file lehetőséget. Ellenkező esetben a B2 minden verziót megőriz, és a Nubbóból való törlés nem szabadít fel helyet.

Ha a Nubbo a kulcsoddal nem tudja hozzáadni a CORS-szabályt, a varázsló a CORS lépésre visz. Ekkor kövesd A CORS-szabály hozzáadása részt.

Csatlakozás korlátozott kulccsal

1. lépés: készítsd elő a bucketet és a kulcsot a Backblaze B2-ben

  1. A Buckets részen kattints a Create a Bucket gombra, adj neki nevet, és hagyd Private beállításon.
  2. A bucketben nyisd meg a Lifecycle Settings beállításokat, és válaszd a Keep only the last version of the file lehetőséget.
  3. Nézd meg a bucket endpointját, abból látod a régiót.
  4. Az Application Keys részen kattints az Add a New Application Key gombra, korlátozd a hozzáférést a bucketedre Read and Write jogosultsággal, és jelöld be az Allow List All Bucket Names lehetőséget. Kattints a Create New Key gombra.
  5. Másold ki a keyID-t és az applicationKey-t.

2. lépés: csatlakoztasd a bucketet a Nubbóban

  1. A Bucketek oldalon kattints a Bucket csatlakoztatása gombra, válaszd a Backblaze B2 lehetőséget, majd a Korlátozott kulccsal lehetőséget.
  2. Illeszd be a keyID-t és az applicationKey-t, és válaszd ki a régiót. Kattints a Kulcs ellenőrzése gombra.
  3. Írd be a bucket pontos nevét, és kattints a Hozzáférés ellenőrzése gombra.
  4. A varázsló a CORS lépésre lép, ahol megjelenik a hozzáadandó szabály.

A CORS-szabály hozzáadása

A CORS-szabály teszi lehetővé, hogy a böngésző a https://nubbo.app oldalon fájlokat töltsön fel a bucketedbe és töltsön le onnan. Ugyanez a szabály jelenik meg a varázsló CORS lépésében.

A B2 konzol CORS-szabályai előre megadott sablonok, és nem engedik kiválasztani a műveleteket, ezért a Nubbo szabályát a B2 parancssori eszközével (b2) kell hozzáadni, egy olyan kulccsal, amely módosíthatja a bucket beállításait.

  1. Telepítsd a CLI-t, például a pip install b2 paranccsal.
  2. Jelentkezz be a keyID-del és az applicationKey-jel: b2 account authorize.
  3. Alkalmazd a szabályt úgy, hogy a your-bucket helyére a bucket nevét írod. Az allPrivate privátként tartja a bucketet.
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
A CORS lépés a buckethez hozzáadandó szabállyal A CORS lépés a buckethez hozzáadandó szabállyal

Miután alkalmaztad, térj vissza a Nubbóba, és kattints a Hozzáadtam, ellenőrzés gombra. Ha a kulcsod módosíthatja a CORS-t, a Próbáld meg beállítani helyettem gomb elvégzi helyetted.

Ha valami nem működik

Üzenet a NubbóbanTeendő
“Úgy tűnik, ez a kulcs egyetlen bucketre korlátozott. Folytathatod a korlátozott úton, vagy létrehozhatsz egy teljes hozzáférésű kulcsot.”Kattints a Folytatás korlátozott kulccsal gombra, vagy hozz létre egy kulcsot a teljes fiókhoz való hozzáféréssel, és kattints a Másik kulcs kipróbálása gombra.
“A bucket nem található. Ellenőrizd a nevet és a régiót.”Ellenőrizd a bucket pontos nevét, és hogy a kiválasztott régió a bucket régiója-e.
“A kulcsodnak nincs jogosultsága bucketek létrehozásához.”Használj teljes hozzáférésű kulcsot, vagy hozd létre a bucketet a paneleden, és kattints a Létrehoztam a panelemen gombra.
“Ez a név már foglalt ennél a szolgáltatónál; próbálj másikat.”A bucketnevek az egész szolgáltatónál egyediek: válassz másikat.
“A kulcsodnak nincs jogosultsága a beállításhoz.”Add hozzá kézzel a CORS-szabályt, a fent leírt módon.
“Még nem működik. Nézd át a szabályt, és ellenőrizd újra; egyes szolgáltatóknál egy percig tart az alkalmazása.”Ellenőrizd, hogy az origin pontosan https://nubbo.app legyen, záró perjel nélkül, várj egy percet, és ellenőrizd újra.
“Ez a bucket már használatban van.”Ez a bucket már csatlakoztatva van a Nubbóban, a te fiókodban vagy egy másikban.
“Érvénytelen hitelesítő adatok. Ellenőrizd az access key és a secret access key értékét.”Ellenőrizd, hogy nem a fő alkalmazáskulcsot használod-e, mert az nem működik az S3 API-val.
“A bucket másik régióban van. Ellenőrizd a beállított régiót.”Válaszd ki a Nubbóban a bucket endpointjában látható régiót.

Mennyibe kerül

A Backblaze B2 TB-onként számláz, 10 GB ingyenes tárhellyel és ingyenes kimenő forgalommal a tárolt mennyiség háromszorosáig. A Backblaze B2 árai cikkben magyarázzuk el.

Gyakori kérdések

Használhatom a Backblaze fő alkalmazáskulcsát?

Nem. A Backblaze nem támogatja a fő kulcsot az S3-kompatibilis API-ján. Hozz létre egy alkalmazáskulcsot az Application Keys részen.

Melyik régiót válasszam a Nubbóban a B2-höz?

Azt, amelyik a bucketjeid endpointjában szerepel, s3.<region>.backblazeb2.com formában. A B2-n egy fiók minden bucketje ugyanabban a régióban van.

Miért a B2 CLI-vel kell beállítani a CORS-t?

Mert a konzol szabályai előre megadott sablonok, és nem engedik kiválasztani a Nubbo által igényelt műveleteket. A CLI a legegyszerűbb módja a pontos szabály alkalmazásának; bármilyen S3-eszköz is megfelel, amely a B2 endpointján futtatja a PutBucketCors műveletet.

Miért nem szabadul fel hely a B2-n, ha a Nubbóban törlök?

Mert a B2 alapból megőrzi a korábbi verziókat. A bucket Lifecycle Settings beállításainál válaszd a Keep only the last version of the file lehetőséget.

Források

Az árak és korlátok az alábbi hivatalos oldalakról származnak. A szolgáltatók módosítják őket, ezért döntés előtt ellenőrizd.