Vodniki

Upravitelj datotek za MinIO in lastni S3: poveži ga z Nubbo

Kako z Nubbo povezati lastno S3-združljivo shrambo, kot so MinIO, Ceph ali SeaweedFS: endpoint, ključ, regija, CORS in kaj storiti, če ne deluje.

Nubbo se poveže s katero koli S3-združljivo shrambo, ki podpisuje s Signature V4, kot so MinIO, Ceph ali SeaweedFS, na tvojem strežniku ali pri drugem ponudniku. Potrebuješ samo URL endpointa, ključ in regijo. Ta vodnik po korakih sledi čarovniku Nubbo in pokriva obe poti: samodejno ali s ključem, omejenim na en bucket.

Kaj dobiš

  • Brskaš po bucketu kot po disku: mape, pogledi, iskanje, koš, oznake in priljubljene.
  • Datoteke nalagaš in prenašaš neposredno med brskalnikom in svojim strežnikom. Datoteke nikoli ne gredo skozi strežnike Nubbo.
  • Deliš datoteke in mape z geslom, rokom veljavnosti in omejitvijo prenosov, prejemaš datoteke v svoj bucket in ustvarjaš galerije.
  • Tvoji ključi so shranjeni šifrirani z AES-256-GCM, bucket pa lahko kadar koli odklopiš.

Preden začneš

Potrebuješ S3-združljivo shrambo in račun Nubbo. Vsak bucket, ki ga povežeš, se šteje v omejitev tvojega paketa: paket Brezplačno jih dovoli 2, Personal 5, Pro pa nima omejitve. Endpoint mora biti javen URL, do katerega lahko pridejo tako strežniki Nubbo kot brskalnik, in potrebuje HTTPS, ker brskalnik na https://nubbo.app ne naloži vsebine HTTP. Nubbo zavrne endpointe, ki kažejo na zasebne ali lokalne naslove. Če tvoj strežnik nima regij, pusti us-east-1.

Izberi način povezave

Čarovnik Nubbo ponuja dve poti. Obe se končata enako: bucket je povezan in pripravljen za nalaganje iz brskalnika.

SamodejnoZ omejenim ključem
KljučDostop do celotnega računaOmejen na en bucket
BucketNubbo uporabi enega od tvojih ali ustvari novegaNajprej ga ustvariš sam
CORSNubbo doda pravilo namesto tebePravilo dodaš sam
Kdaj ga izbratiNajhitrejša potKo ne želiš dati dostopa do celotnega računa

Samodejna povezava

1. korak: ustvari ključ na svojem strežniku

  1. Preveri, ali tvoj strežnik ponuja API S3 s podpisi V4 na javnem URL-ju HTTPS, na primer https://s3.your-domain.com.
  2. Ustvari ključ, ki lahko ustvarja buckete in spreminja njihov CORS.
  3. Zapiši si URL endpointa in regijo. Če tvoj strežnik nima regij, uporabi us-east-1.

2. korak: poveži bucket v Nubbo

  1. V Nubbo odpri Bucketi in pritisni Poveži bucket. Izberi Prilagojen S3 / samostojno gostovan in pritisni Nadaljuj.

    Korak Ponudnik v čarovniku Nubbo z izbranim Prilagojen S3 / samostojno gostovan Korak Ponudnik v čarovniku Nubbo z izbranim Prilagojen S3 / samostojno gostovan
  2. Izberi Samodejno in pritisni Nadaljuj.

    Korak Način povezave z možnostma Samodejno in Z omejenim ključem Korak Način povezave z možnostma Samodejno in Z omejenim ključem
  3. V koraku Tvoj ključ prilepi dostopni ključ, skrivni ključ, URL endpointa in regijo. Pritisni Preveri ključ. Nubbo preveri, ali ključ deluje in ali ima dostop do celotnega računa.

    Korak Tvoj ključ za Prilagojen S3 / samostojno gostovan s hitrim vodnikom in polji za ključ Korak Tvoj ključ za Prilagojen S3 / samostojno gostovan s hitrim vodnikom in polji za ključ
  4. Izberi enega od svojih bucketov in pritisni Uporabi ta bucket ali pa označi Ustvari novega, vpiši ime (in izberi regijo, če jo zahteva) ter pritisni Ustvari in pripravi. Nubbo bucketu doda pravilo CORS, ki dovoljuje nalaganje in prenašanje samo iz aplikacije, obstoječa pravila pa ohrani.

    Korak Tvoj bucket s seznamom bucketov in možnostjo Ustvari novega Korak Tvoj bucket s seznamom bucketov in možnostjo Ustvari novega
  5. Preglej tri preverjanja, po želji spremeni Ime v Nubbo in pritisni Končaj. Bucket se prikaže v razdelku Bucketi in ga lahko odpreš v raziskovalcu.

    Korak Končano s preverjanji povezave, bucketa in CORS Korak Končano s preverjanji povezave, bucketa in CORS

Če Nubbo s tvojim ključem ne more dodati pravila CORS, te čarovnik pelje na korak CORS. Takrat sledi razdelku Dodaj pravilo CORS.

Povezava z omejenim ključem

1. korak: pripravi bucket in ključ na svojem strežniku

  1. Na svojem strežniku ustvari bucket (na MinIO na primer z mc mb).
  2. Ustvari ključ z dovoljenji za branje in pisanje v ta bucket.
  3. Zapiši si URL endpointa in regijo.

2. korak: poveži bucket v Nubbo

  1. V razdelku Bucketi pritisni Poveži bucket, izberi Prilagojen S3 / samostojno gostovan in nato Z omejenim ključem.
  2. Prilepi dostopni ključ, skrivni ključ, endpoint in regijo. Pritisni Preveri ključ.
  3. Vpiši natančno ime bucketa in pritisni Preveri dostop.
  4. Čarovnik preide na korak CORS s pravilom, ki ga moraš dodati.

Dodaj pravilo CORS

Pravilo CORS brskalniku omogoča nalaganje in prenašanje datotek iz tvojega bucketa na https://nubbo.app. To je isto pravilo, ki ga čarovnik prikaže v koraku CORS.

Kako se nastavi CORS, je odvisno od programske opreme:

  • MinIO (skupnostna izdaja) ne sprejema CORS za posamezen bucket: uporablja globalno nastavitev (MINIO_API_CORS_ALLOW_ORIGIN), ki privzeto dovoljuje kateri koli izvor. Če je nisi spremenil, ni treba storiti ničesar: pritisni Dodano, preveri in preverjanje bo uspešno. Če si jo spremenil, vključi https://nubbo.app.
  • Ceph in SeaweedFS sprejemata CORS za posamezen bucket prek API-ja S3. To pravilo uporabi s svojim običajnim orodjem (na primer aws s3api put-bucket-cors s svojim endpointom) ali pa naj to po samodejni poti naredi Nubbo.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Korak CORS s pravilom, ki ga je treba dodati bucketu Korak CORS s pravilom, ki ga je treba dodati bucketu

Ko je pravilo pripravljeno, se vrni v Nubbo in pritisni Dodano, preveri. Na Ceph in SeaweedFS, če lahko tvoj ključ spreminja CORS, to namesto tebe naredi Poskusi ga nastaviti namesto mene.

Če gre kaj narobe

Sporočilo v NubboKaj storiti
“Neveljavne poverilnice. Preveri dostopni ključ in skrivni dostopni ključ.”Znova kopiraj oba ključa, brez presledkov na začetku ali koncu.
“Ta ključ je videti omejen na en bucket. Lahko nadaljuješ po omejeni poti ali ustvariš ključ s polnim dostopom.”Pritisni Nadaljuj z omejenim ključem ali ustvari ključ z dostopom do celotnega računa in pritisni Poskusi drug ključ.
“Bucket ni najden. Preveri ime in regijo.”Preveri natančno ime bucketa in ali je izbrana regija tista, v kateri je bucket.
“Tvoj ključ nima dovoljenja za ustvarjanje bucketov.”Uporabi ključ s polnim dostopom ali ustvari bucket v svoji nadzorni plošči in pritisni Že ga imam v svoji nadzorni plošči.
“To ime je pri tem ponudniku že v uporabi; poskusi z drugim.”Imena bucketov so pri ponudniku edinstvena: izberi drugo.
“Tvoj ključ nima dovoljenja, da bi to nastavil.”Pravilo CORS dodaj ročno, kot je razloženo zgoraj.
“Še ne deluje. Preglej pravilo in preveri znova; nekateri ponudniki potrebujejo minuto, da ga uveljavijo.”Preveri, ali je izvor natanko https://nubbo.app brez poševnice na koncu, počakaj minuto in preveri znova.
“Ta bucket je že v uporabi.”Ta bucket je v Nubbo že povezan, v tvojem ali v drugem računu.
“S3 končne točke ni bilo mogoče doseči. Preveri URL končne točke.”Preveri, ali je URL javen, uporablja HTTPS in se odziva iz interneta, ne samo iz tvojega omrežja.
“URL končne točke ni veljaven. Preveri obliko zapisa.”Vpiši celoten URL s https:// in brez imena bucketa. Sporočilo se prikaže tudi, ko URL kaže na zasebni ali lokalni naslov ali ko imena ni mogoče razrešiti.
“Povezava je potekla. Poskusi znova.”Preveri požarni zid svojega strežnika in ali je vrata mogoče doseči od zunaj.

Koliko stane

Če tehtaš med lastno shrambo in ponudnikom, primerjaj cene in omejitve v članku S3, R2, Spaces, Wasabi in Backblaze B2 v primerjavi.

Pogosta vprašanja

Katera lastna shramba deluje z Nubbo?

Vsaka shramba, združljiva z API-jem S3 s podpisi V4, kot so MinIO, Ceph ali SeaweedFS, pa tudi S3-združljivi ponudniki, ki jih ni na seznamu.

Ali lahko povežem MinIO v svojem lokalnem omrežju?

Ne. Endpoint mora biti javen URL: Nubbo zavrne zasebne in lokalne naslove, do njega pa mora priti tudi brskalnik.

Katero regijo uporabim, če moj strežnik nima regij?

us-east-1. To je privzeta regija večine S3-združljivih strežnikov.

Zakaj Nubbo na MinIO ne more nastaviti CORS?

Ker skupnostna izdaja MinIO ne podpira CORS za posamezen bucket. Uporablja globalno nastavitev, ki privzeto dovoljuje kateri koli izvor, Nubbo pa jo preveri.

Viri

Cene in omejitve so povzete po spodnjih uradnih straneh. Ponudniki jih spreminjajo, zato jih preveri, preden se odločiš.