Fájlkezelő Cloudflare R2-höz: csatlakoztasd a Nubbóhoz

A Nubbo egy R2 API-tokennel és a fiókod Account ID-jával csatlakozik a Cloudflare R2-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 Cloudflare R2 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 Cloudflare R2-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. Az első bucket előtt a Cloudflare kéri, hogy aktiváld az R2-előfizetést a vezérlőpulton. Ha a bucketed joghatósághoz kötött (EU, FedRAMP vagy US), a varázslóban kiválasztod, és a Nubbo annak a joghatóságnak az endpointját használja.

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.

A korlátozott kulcs a legkisebb hozzáférés, amire a Nubbónak szüksége van: Object Read & Write egy bucketre. Ezzel a Nubbo nem tudja listázni a bucketjeidet, és újat sem hozhat létre, ezért beírod a bucket nevét, és a CORS-szabályt te adod hozzá.

Automatikus csatlakozás

1. lépés: hozd létre a kulcsot a Cloudflare R2-ben

1. Jelentkezz be a dash.cloudflare.com oldalon, és nyisd meg az R2 object storage részt. A felület a te nyelveden is mutathatja a menüket.
2. Nyisd meg az API Tokens részt, és nyomd meg a Create Account API token gombot. Az Overview oldalról is eléred, az Account Details, Manage alatt.
3. Válaszd az Admin Read & Write jogosultságot, és hozd létre a tokent.
4. Másold ki az Access Key ID és a Secret Access Key értékét. A Cloudflare a secretet csak egyszer mutatja meg. Ezt a két kulcsot használd, ne a token értékét.
5. Másold ki az Account ID-t is, amely az R2 Overview oldalán látható.

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 Cloudflare R2 lehetőséget, és kattints a Tovább gombra.

   

2. Válaszd az Automatikus lehetőséget, és kattints a Tovább gombra.

   

3. A Kulcsod lépésben illeszd be az Access Key ID, a Secret Access Key és az Account ID értékét. A Nubbo az Account ID alapján állítja össze a fiókod endpointját. Az R2 régiója mindig auto. Mielőtt megnyomod a Kulcs ellenőrzése gombot, válaszd ki a bucketed Joghatóság értékét: a legtöbb buckethez Alapértelmezett (joghatóság nélkül), vagy EU, FedRAMP vagy US. Az endpoint vele együtt változik (az EU-ban https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com), és a lista csak az adott joghatóság bucketjeit mutatja. 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.

   

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.

   

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.

   

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 Cloudflare R2-ben

1. Az R2, Overview oldalon kattints a Create bucket gombra, és adj nevet a bucketnek (kisbetűk, számok és kötőjelek). Régiót nem kell választani. Ha az adatoknak az EU-ban kell maradniuk, válaszd az EU joghatóságot: az endpoint vele együtt változik.
2. Nyisd meg az API Tokens részt, és nyomd meg a Create Account API token gombot.
3. Válaszd az Object Read & Write jogosultságot, és korlátozd a bucketedre.
4. Másold ki az Access Key ID, a Secret Access Key és az Account ID értékét.

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

1. A Bucketek oldalon kattints a Bucket csatlakoztatása gombra, válaszd a Cloudflare R2 lehetőséget, majd a Korlátozott kulccsal lehetőséget.
2. Illeszd be az Access Key ID, a Secret Access Key és az Account ID értékét. Mielőtt megnyomod a Kulcs ellenőrzése gombot, válaszd ugyanazt a Joghatóság értéket, mint a bucketé. 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.

1. Az R2-ben nyisd meg a bucketet, és lépj a Settings részre.
2. A CORS Policy alatt kattints az Add CORS policy gombra, és válaszd a JSON fület.
3. Illeszd be a szabályt, és kattints a Save gombra. A Cloudflare-nek akár 30 másodpercbe is telhet, mire érvénybe lépteti.

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

Mentés után 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

Mennyibe kerül

Az R2 nem számláz a kimenő forgalomért, és havi ingyenes kerettel rendelkezik. A Cloudflare R2 ingyenes kerete cikkben magyarázzuk el.