Juhendid

Failihaldur MinIO ja iseserveeritava S3 jaoks: ühenda see Nubboga

Kuidas ühendada oma S3-ühilduv salvestus, näiteks MinIO, Ceph või SeaweedFS, Nubboga: lõpp-punkt, võti, piirkond, CORS ja mida teha tõrke korral.

Nubbo ühendub iga S3-ühilduva salvestusega, mis allkirjastab Signature V4-ga, näiteks MinIO, Ceph või SeaweedFS, olgu see sinu enda serveris või mõne teise teenusepakkuja juures. Vaja on ainult lõpp-punkti URL-i, võtit ja piirkonda. See juhend järgib Nubbo viisardit samm-sammult mõlemal teel: automaatselt või ühe bucketiga piiratud võtmega.

Mida sa saad

  • Sirvi bucketit nagu ketast: kaustad, vaated, otsing, prügikast, sildid ja lemmikud.
  • Laadi faile üles ja alla otse oma brauseri ja serveri vahel. Failid ei läbi kunagi Nubbo servereid.
  • Jaga faile ja kaustu parooli, aegumise ja allalaadimiste piiranguga, võta faile vastu oma bucketisse ja loo galeriisid.
  • Sinu võtmed salvestatakse AES-256-GCM-iga krüpteeritult ja saad bucketi igal ajal lahti ühendada.

Enne alustamist

Vajad S3-ühilduvat salvestust ja Nubbo kontot. Iga ühendatud bucket arvestatakse sinu paketi limiidi hulka: Tasuta pakett lubab 2, Personal 5 ja Pro puhul piirangut pole. Lõpp-punkt peab olema avalik URL, millele pääsevad ligi nii Nubbo serverid kui ka brauser, ja see vajab HTTPS-i, sest brauser ei laadi aadressilt https://nubbo.app HTTP-sisu. Nubbo lükkab tagasi lõpp-punktid, mis osutavad privaatsetele või kohalikele aadressidele. Kui sinu serveril piirkondi pole, jäta us-east-1.

Vali ühendusviis

Nubbo viisard pakub kahte teed. Mõlemad lõpevad samamoodi: bucket on ühendatud ja valmis brauserist üleslaadimiseks.

AutomaatnePiiratud võtmega
VõtiJuurdepääs kogu kontolePiiratud ühe bucketiga
BucketNubbo kasutab üht sinu omadest või loob uueLood selle kõigepealt ise
CORSNubbo lisab reegli sinu eestLisad reegli ise
Millal validaKiireim viisKui sa ei taha anda juurdepääsu kogu kontole

Automaatne ühendus

1. samm: loo võti oma serveris

  1. Kontrolli, et sinu server pakub S3 API-t V4-allkirjadega avalikul HTTPS-aadressil, näiteks https://s3.your-domain.com.
  2. Loo võti, mis saab luua bucketeid ja muuta nende CORS-i.
  3. Pane kirja lõpp-punkti URL ja piirkond. Kui sinu serveril piirkondi pole, kasuta us-east-1.

2. samm: ühenda bucket Nubbos

  1. Ava Nubbos Bucketid ja vajuta Ühenda bucket. Vali Kohandatud S3 / iseserveeritav ja vajuta Jätka.

    Nubbo viisardi pakkuja samm, kus on valitud Kohandatud S3 / iseserveeritav Nubbo viisardi pakkuja samm, kus on valitud Kohandatud S3 / iseserveeritav
  2. Vali Automaatne ja vajuta Jätka.

    Ühendusviisi samm valikutega Automaatne ja Piiratud võtmega Ühendusviisi samm valikutega Automaatne ja Piiratud võtmega
  3. Kleebi sammus Sinu võti ligipääsuvõti, salajane võti, lõpp-punkti URL ja piirkond. Vajuta Kontrolli võtit. Nubbo kontrollib, et võti töötab ja et sellel on juurdepääs kogu kontole.

    Kohandatud S3 / iseserveeritav samm Sinu võti koos kiirjuhendi ja võtmeväljadega Kohandatud S3 / iseserveeritav samm Sinu võti koos kiirjuhendi ja võtmeväljadega
  4. Vali üks oma bucketitest ja vajuta Kasuta seda bucketit või vali Loo uus, sisesta nimi (ja vali piirkond, kui seda küsitakse) ning vajuta Loo ja valmista ette. Nubbo lisab bucketile CORS-reegli, mis lubab üles- ja allalaadimisi ainult rakendusest, ning säilitab bucketi olemasolevad reeglid.

    Samm Sinu bucket koos bucketite loendi ja valikuga Loo uus Samm Sinu bucket koos bucketite loendi ja valikuga Loo uus
  5. Vaata kolm kontrolli üle, muuda soovi korral välja Nimi Nubbos ja vajuta Lõpeta. Bucket ilmub jaotisse Bucketid ja saad selle failihalduris avada.

    Samm Valmis koos ühenduse, bucketi ja CORS-i kontrollidega Samm Valmis koos ühenduse, bucketi ja CORS-i kontrollidega

Kui Nubbo ei saa sinu võtmega CORS-reeglit lisada, viib viisard sind sammu CORS. Siis järgi juhiseid jaotises Lisa CORS-reegel.

Ühendus piiratud võtmega

1. samm: valmista oma serveris ette bucket ja võti

  1. Loo oma serveris bucket (MinIO-s näiteks käsuga mc mb).
  2. Loo võti, millel on selles bucketis lugemis- ja kirjutamisõigus.
  3. Pane kirja lõpp-punkti URL ja piirkond.

2. samm: ühenda bucket Nubbos

  1. Vajuta jaotises Bucketid Ühenda bucket, vali Kohandatud S3 / iseserveeritav ja seejärel Piiratud võtmega.
  2. Kleebi ligipääsuvõti, salajane võti, lõpp-punkt ja piirkond. Vajuta Kontrolli võtit.
  3. Sisesta bucketi täpne nimi ja vajuta Kontrolli juurdepääsu.
  4. Viisard liigub sammu CORS koos reegliga, mille pead lisama.

Lisa CORS-reegel

CORS-reegel lubab brauseril sinu bucketist faile üles ja alla laadida aadressil https://nubbo.app. See on sama reegel, mida viisard näitab sammus CORS.

CORS-i seadistamine sõltub tarkvarast:

  • MinIO (community edition) ei aktsepteeri bucketipõhist CORS-i: see kasutab globaalset seadet (MINIO_API_CORS_ALLOW_ORIGIN), mis lubab vaikimisi mis tahes päritolu. Kui sa pole seda muutnud, pole midagi vaja teha: vajuta Lisasin, kontrolli ja kontroll läheb läbi. Kui muutsid seda, lisa https://nubbo.app.
  • Ceph ja SeaweedFS aktsepteerivad bucketipõhist CORS-i S3 API kaudu. Rakenda see reegel oma tavapärase tööriistaga (näiteks aws s3api put-bucket-cors koos oma lõpp-punktiga) või lase Nubbol seda automaatsel teel teha.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
CORS-i samm koos reegliga, mis tuleb bucketile lisada CORS-i samm koos reegliga, mis tuleb bucketile lisada

Kui reegel on valmis, mine tagasi Nubbosse ja vajuta Lisasin, kontrolli. Ceph’is ja SeaweedFS-is teeb Proovi see minu eest seadistada selle sinu eest ära, kui sinu võti saab CORS-i muuta.

Kui midagi läheb valesti

Teade NubbosMida teha
“Vigased mandaadid. Kontrolli ligipääsuvõtit ja salajast ligipääsuvõtit.”Kopeeri mõlemad võtmed uuesti, ilma tühikuteta alguses või lõpus.
“See võti näib olevat piiratud ühe bucketiga. Võid jätkata piiratud teed või luua täieliku juurdepääsuga võtme.”Vajuta Jätka piiratud võtmega või loo võti, millel on juurdepääs kogu kontole, ja vajuta Proovi teist võtit.
“Bucketit ei leitud. Kontrolli nime ja regiooni.”Kontrolli bucketi täpset nime ja et valitud piirkond oleks bucketi piirkond.
“Sinu võtmel pole õigust bucketeid luua.”Kasuta täieliku juurdepääsuga võtit või loo bucket oma paneelil ja vajuta Lõin selle oma paneelil.
“See nimi on selle teenusepakkuja juures juba kasutusel; proovi mõnda teist.”Bucketite nimed on kogu teenusepakkuja ulatuses unikaalsed: vali mõni teine.
“Sinu võtmel pole õigust seda seadistada.”Lisa CORS-reegel käsitsi, nagu ülal kirjeldatud.
“See ei tööta veel. Vaata reegel üle ja kontrolli uuesti; mõnel pakkujal kulub selle rakendamiseks minut.”Kontrolli, et päritolu oleks täpselt https://nubbo.app ilma kaldkriipsuta lõpus, oota minut ja kontrolli uuesti.
“See bucket on juba kasutusel.”See bucket on Nubbos juba ühendatud, sinu kontol või mõnel teisel.
“S3 lõpp-punktiga ei õnnestunud ühendust saada. Kontrolli lõpp-punkti URL-i.”Kontrolli, et URL on avalik, kasutab HTTPS-i ja vastab internetist, mitte ainult sinu võrgust.
“Lõpp-punkti URL ei ole kehtiv. Kontrolli vormingut.”Sisesta täielik URL koos https:// osaga ja ilma bucketi nimeta. Teade ilmub ka siis, kui URL osutab privaatsele või kohalikule aadressile või nime ei lahendata.
“Ühendus aegus. Proovi uuesti.”Kontrolli oma serveri tulemüüri ja et port oleks väljastpoolt ligipääsetav.

Mis see maksab

Kui kaalud oma salvestust teenusepakkuja omaga, võrdle hindu ja piiranguid artiklis S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.

Korduma kippuvad küsimused

Milline iseserveeritav salvestus Nubboga töötab?

Iga salvestus, mis ühildub S3 API-ga V4-allkirjadega, näiteks MinIO, Ceph või SeaweedFS, ning ka S3-ühilduvad teenusepakkujad, keda loendis pole.

Kas saan ühendada oma kohtvõrgus oleva MinIO?

Ei. Lõpp-punkt peab olema avalik URL: Nubbo lükkab privaatsed ja kohalikud aadressid tagasi ning brauser peab samuti sellele ligi pääsema.

Millist piirkonda kasutan, kui mu serveril piirkondi pole?

us-east-1. See on enamiku S3-ühilduvate serverite vaikepiirkond.

Miks ei saa Nubbo MinIO-s CORS-i seadistada?

Sest MinIO kogukonnaversioon ei toeta bucketipõhist CORS-i. See kasutab globaalset seadet, mis lubab vaikimisi mis tahes päritolu, ja Nubbo kontrollib seda.

Allikad

Hinnad ja piirangud pärinevad allpool toodud ametlikelt lehtedelt. Teenusepakkujad muudavad neid, seega kontrolli enne otsustamist.