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.
| Automatikus | Korlátozott kulccsal | |
|---|---|---|
| Kulcs | Hozzáférés a teljes fiókhoz | Egy bucketre korlátozva |
| Bucket | A Nubbo a tiédet használja, vagy újat hoz létre | Előbb te hozod létre |
| CORS | A Nubbo hozzáadja helyetted a szabályt | Te adod hozzá a szabályt |
| Mikor válaszd | A leggyorsabb út | Ha 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
- 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. - Hozz létre egy kulcsot, amely bucketeket hozhat létre és módosíthatja a CORS-ukat.
- 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
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.

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

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.

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.

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 szervereden
- Hozd létre a bucketet a szervereden (MinIO esetén például az
mc mbparanccsal). - Hozz létre egy kulcsot olvasási és írási jogosultsággal erre a bucketre.
- Jegyezd fel az endpoint URL-t és a régiót.
2. lépés: csatlakoztasd a bucketet a Nubbóban
- 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.
- Illeszd be az access key-t, a secret key-t, az endpointot és a régiót. Kattints a Kulcs ellenőrzése gombra.
- Írd be a bucket pontos nevét, és kattints a Hozzáférés ellenőrzése gombra.
- 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 ahttps://nubbo.appcí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-corsparanccsal, 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
}
]

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óban | Teendő |
|---|---|
| “É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.