Útmutatók

Fájlkezelő MinIO-hoz és saját S3-hoz: csatlakoztasd a Nubbóhoz

Így csatlakoztatod a saját S3-kompatibilis tárhelyedet (MinIO, Ceph vagy SeaweedFS) a Nubbóhoz: endpoint, kulcs, régió, CORS és hibaelhárítás.

A Nubbo bármilyen S3-kompatibilis tárhelyhez csatlakozik, amely Signature V4-gyel ír alá, például a MinIO-hoz, a Ceph-hez vagy a SeaweedFS-hez, akár a saját szervereden, akár egy másik szolgáltatónál. Csak az endpoint URL-re, egy kulcsra és a régióra van szükséged. 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 szervered 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 S3-kompatibilis tárhelyre é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 endpointnak olyan nyilvános URL-nek kell lennie, amelyet a Nubbo szerverei és a böngésző is elérnek, és HTTPS kell hozzá, mert a böngésző nem tölt be HTTP-tartalmat a https://nubbo.app oldalról. A Nubbo elutasítja a privát vagy helyi címekre mutató endpointokat. Ha a szerverednek nincsenek régiói, hagyd az us-east-1 értéket.

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 szervereden

  1. Ellenőrizd, hogy a szervered V4-aláírással teszi elérhetővé az S3 API-t egy nyilvános HTTPS URL-en, például https://s3.your-domain.com.
  2. Hozz létre egy kulcsot, amely bucketeket hozhat létre és módosíthatja a CORS-ukat.
  3. Jegyezd fel az endpoint URL-t és a régiót. Ha a szerverednek nincsenek régiói, használd az us-east-1 értéket.

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 az Egyéni S3 / önhoszingolt lehetőséget, és kattints a Tovább gombra.

    A Nubbo varázslójának Szolgáltató lépése, kiválasztott Egyéni S3 / önhoszingolt lehetőséggel A Nubbo varázslójának Szolgáltató lépése, kiválasztott Egyéni S3 / önhoszingolt lehetőséggel
  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 az access key-t, a secret key-t, az endpoint URL-t és a régió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 az Egyéni S3 / önhoszingolt lehetőséghez a gyors útmutatóval és a kulcsmezőkkel A Kulcsod lépés az Egyéni S3 / önhoszingolt lehetőséghez 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

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 szervereden

  1. Hozd létre a bucketet a szervereden (MinIO esetén például az mc mb paranccsal).
  2. Hozz létre egy kulcsot olvasási és írási jogosultsággal erre a bucketre.
  3. Jegyezd fel az endpoint URL-t és a régiót.

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

  1. A Bucketek oldalon kattints a Bucket csatlakoztatása gombra, válaszd az Egyéni S3 / önhoszingolt lehetőséget, majd a Korlátozott kulccsal lehetőséget.
  2. Illeszd be az access key-t, a secret key-t, az endpointot és 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 CORS beállítása a szoftvertől függ:

  • A MinIO (community edition) nem fogad el bucketenkénti CORS-t: egy globális beállítást (MINIO_API_CORS_ALLOW_ORIGIN) használ, amely alapból bármilyen origint engedélyez. Ha nem módosítottad, nincs teendőd: kattints a Hozzáadtam, ellenőrzés gombra, és az ellenőrzés sikeres lesz. Ha módosítottad, vedd fel a https://nubbo.app címet.
  • A Ceph és a SeaweedFS az S3 API-n keresztül elfogadja a bucketenkénti CORS-t. Alkalmazd ezt a szabályt a megszokott eszközöddel (például az aws s3api put-bucket-cors paranccsal, a saját endpointoddal), vagy hagyd, hogy az automatikus úton a Nubbo elvégezze.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
A CORS lépés a buckethez hozzáadandó szabállyal A CORS lépés a buckethez hozzáadandó szabállyal

Ha a szabály kész, térj vissza a Nubbóba, és kattints a Hozzáadtam, ellenőrzés gombra. Ceph és SeaweedFS esetén, 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ő
“Érvénytelen hitelesítő adatok. Ellenőrizd az access key és a secret access key értékét.”Másold be újra mindkét kulcsot, az elején és a végén szóközök nélkül.
“Ú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.
“Nem sikerült elérni az S3 endpointot. Ellenőrizd az endpoint URL-t.”Ellenőrizd, hogy az URL nyilvános, HTTPS-t használ, és az internetről is válaszol, nem csak a saját hálózatodról.
“Az endpoint URL nem érvényes. Ellenőrizd a formátumát.”Írd be a teljes URL-t https:// előtaggal és a bucket neve nélkül. Akkor is megjelenik, ha az URL privát vagy helyi címre mutat, vagy ha a név nem oldható fel.
“A kapcsolat túllépte az időkorlátot. Próbáld újra.”Ellenőrizd a szervered tűzfalát, és hogy a port kívülről is elérhető-e.

Mennyibe kerül

Ha a saját tárhelyedet egy szolgáltatóval veted össze, hasonlítsd össze az árakat és a korlátokat az S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2 cikkben.

Gyakori kérdések

Milyen saját üzemeltetésű tárhelyek működnek a Nubbóval?

Bármilyen tárhely, amely kompatibilis a V4-aláírású S3 API-val, például a MinIO, a Ceph vagy a SeaweedFS, és azok az S3-kompatibilis szolgáltatók is, amelyek nem szerepelnek a listán.

Csatlakoztathatok egy helyi hálózaton futó MinIO-t?

Nem. Az endpointnak nyilvános URL-nek kell lennie: a Nubbo elutasítja a privát és helyi címeket, és a böngészőnek is el kell érnie.

Melyik régiót használjam, ha a szerveremnek nincsenek régiói?

Az us-east-1 régiót. A legtöbb S3-kompatibilis szerver ezt használja alapértelmezésként.

Miért nem tudja a Nubbo beállítani a CORS-t a MinIO-n?

Mert a MinIO community edition nem támogatja a bucketenkénti CORS-t. Egy globális beállítást használ, amely alapból bármilyen origint engedélyez, és a Nubbo ezt ellenőrzi.

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.