Vadovai

MinIO ir savo serverio S3 failų tvarkyklė: prijunkite ją prie Nubbo

Kaip prie Nubbo prijungti savo S3 suderinamą saugyklą, pavyzdžiui, MinIO, Ceph ar SeaweedFS: endpoint, raktas, regionas, CORS ir ką daryti, jei nepavyksta.

Nubbo jungiasi prie bet kurios S3 suderinamos saugyklos, kuri pasirašo Signature V4, pavyzdžiui, MinIO, Ceph ar SeaweedFS, jūsų serveryje arba pas kitą teikėją. Tereikia endpoint URL, rakto ir regiono. Šis vadovas žingsnis po žingsnio seka Nubbo vedlį abiem keliais: automatiškai arba su raktu, apribotu vienu bucket.

Ką gaunate

  • Naršykite bucket kaip diską: aplankai, rodiniai, paieška, šiukšlinė, žymos ir mėgstami.
  • Įkelkite ir atsisiųskite failus tiesiai tarp savo naršyklės ir savo serverio. Failai niekada nepereina per Nubbo serverius.
  • Bendrinkite failus ir aplankus su slaptažodžiu, galiojimo laiku ir atsisiuntimų limitu, gaukite failus į savo bucket ir kurkite galerijas.
  • Jūsų raktai saugomi užšifruoti AES-256-GCM, o bucket galite atjungti bet kada.

Prieš pradedant

Jums reikia S3 suderinamos saugyklos ir Nubbo paskyros. Kiekvienas prijungtas bucket įskaičiuojamas į jūsų plano limitą: Nemokamas planas leidžia 2, Personal 5, o Pro neturi ribos. Endpoint turi būti viešas URL, kurį pasiekia ir Nubbo serveriai, ir naršyklė, ir jam reikia HTTPS, nes naršyklė neįkelia HTTP turinio iš https://nubbo.app. Nubbo atmeta endpoint, rodančius į privačius ar vietinius adresus. Jei jūsų serveris neturi regionų, palikite us-east-1.

Pasirinkite prijungimo būdą

Nubbo vedlys siūlo du kelius. Abu baigiasi taip pat: bucket prijungtas ir paruoštas įkėlimams iš naršyklės.

AutomatiškaiSu apribotu raktu
RaktasPrieiga prie visos paskyrosApribotas vienu bucket
BucketNubbo naudoja vieną iš jūsų arba sukuria naująPirmiausia jį sukuriate jūs
CORSNubbo prideda taisyklę už jusTaisyklę pridedate jūs
Kada rinktisGreičiausias būdasKai nenorite suteikti prieigos prie visos paskyros

Automatinis prijungimas

1 žingsnis: sukurkite raktą savo serveryje

  1. Patikrinkite, ar jūsų serveris teikia S3 API su V4 parašais viešu HTTPS URL, pavyzdžiui, https://s3.your-domain.com.
  2. Sukurkite raktą, kuris gali kurti bucket ir keisti jų CORS.
  3. Užsirašykite endpoint URL ir regioną. Jei jūsų serveris neturi regionų, naudokite us-east-1.

2 žingsnis: prijunkite bucket Nubbo

  1. Nubbo atidarykite Bucket’ai ir spauskite Prijungti bucket. Pasirinkite Pasirinktinis S3 / savarankiškai talpinamas ir spauskite Tęsti.

    Nubbo vedlio teikėjo žingsnis su pasirinktu Pasirinktinis S3 / savarankiškai talpinamas Nubbo vedlio teikėjo žingsnis su pasirinktu Pasirinktinis S3 / savarankiškai talpinamas
  2. Pasirinkite Automatiškai ir spauskite Tęsti.

    Prijungimo būdo žingsnis su parinktimis Automatiškai ir Su apribotu raktu Prijungimo būdo žingsnis su parinktimis Automatiškai ir Su apribotu raktu
  3. Žingsnyje Jūsų raktas įklijuokite prieigos raktą, slaptąjį raktą, endpoint URL ir regioną. Spauskite Patikrinti raktą. Nubbo patikrina, ar raktas veikia ir ar jis turi prieigą prie visos paskyros.

    Pasirinktinio S3 žingsnis Jūsų raktas su greituoju vadovu ir rakto laukais Pasirinktinio S3 žingsnis Jūsų raktas su greituoju vadovu ir rakto laukais
  4. Pasirinkite vieną iš savo bucket ir spauskite Naudoti šį bucket arba pažymėkite Sukurti naują, įveskite pavadinimą (ir pasirinkite regioną, jei jo paprašoma) ir spauskite Sukurti ir paruošti. Nubbo prideda prie bucket CORS taisyklę, kuri leidžia įkėlimus ir atsisiuntimus tik iš programos, ir išsaugo jau esamas taisykles.

    Žingsnis Jūsų bucket su bucket sąrašu ir parinktimi Sukurti naują Žingsnis Jūsų bucket su bucket sąrašu ir parinktimi Sukurti naują
  5. Peržiūrėkite tris patikras, jei norite, pakeiskite Pavadinimas Nubbo ir spauskite Baigti. Bucket atsiranda skiltyje Bucket’ai ir jį galite atidaryti naršyklėje.

    Pabaigos žingsnis su ryšio, bucket ir CORS patikromis Pabaigos žingsnis su ryšio, bucket ir CORS patikromis

Jei Nubbo negali pridėti CORS taisyklės su jūsų raktu, vedlys nukreipia jus į žingsnį CORS. Tada sekite skyrių Pridėkite CORS taisyklę.

Prijungimas su apribotu raktu

1 žingsnis: paruoškite bucket ir raktą savo serveryje

  1. Sukurkite bucket savo serveryje (pavyzdžiui, MinIO tai daroma komanda mc mb).
  2. Sukurkite raktą su skaitymo ir rašymo teisėmis tam bucket.
  3. Užsirašykite endpoint URL ir regioną.

2 žingsnis: prijunkite bucket Nubbo

  1. Skiltyje Bucket’ai spauskite Prijungti bucket, pasirinkite Pasirinktinis S3 / savarankiškai talpinamas, tada Su apribotu raktu.
  2. Įklijuokite prieigos raktą, slaptąjį raktą, endpoint ir regioną. Spauskite Patikrinti raktą.
  3. Įveskite tikslų bucket pavadinimą ir spauskite Patikrinti prieigą.
  4. Vedlys pereina į žingsnį CORS su taisykle, kurią reikia pridėti.

Pridėkite CORS taisyklę

CORS taisyklė leidžia naršyklei įkelti ir atsisiųsti failus iš jūsų bucket svetainėje https://nubbo.app. Tai ta pati taisyklė, kurią vedlys rodo žingsnyje CORS.

Kaip nustatomas CORS, priklauso nuo programinės įrangos:

  • MinIO (bendruomenės versija) nepriima CORS kiekvienam bucket: ji naudoja visuotinį nustatymą (MINIO_API_CORS_ALLOW_ORIGIN), kuris pagal numatytuosius nustatymus leidžia bet kokią kilmę. Jei jo nekeitėte, nieko daryti nereikia: spauskite Pridėjau, patikrinti, ir patikra bus sėkminga. Jei jį pakeitėte, įtraukite https://nubbo.app.
  • Ceph ir SeaweedFS priima CORS kiekvienam bucket per S3 API. Pritaikykite šią taisyklę įprastu įrankiu (pavyzdžiui, aws s3api put-bucket-cors su savo endpoint) arba leiskite tai padaryti Nubbo automatiniu keliu.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
CORS žingsnis su taisykle, kurią reikia pridėti prie bucket CORS žingsnis su taisykle, kurią reikia pridėti prie bucket

Kai taisyklė paruošta, grįžkite į Nubbo ir spauskite Pridėjau, patikrinti. Ceph ir SeaweedFS atveju, jei jūsų raktas gali keisti CORS, Bandyti sukonfigūruoti už mane tai padarys už jus.

Jei kas nors nepavyksta

Pranešimas NubboKą daryti
„Neteisingi prisijungimo duomenys. Patikrinkite prieigos raktą ir slaptąjį prieigos raktą.“Nukopijuokite abu raktus iš naujo, be tarpų pradžioje ar pabaigoje.
„Panašu, kad šis raktas apribotas vienu bucket. Galite tęsti apribotu keliu arba sukurti raktą su visa prieiga.“Spauskite Tęsti su apribotu raktu arba sukurkite raktą su prieiga prie visos paskyros ir spauskite Išbandyti kitą raktą.
„Bucket nerastas. Patikrinkite pavadinimą ir regioną.“Patikrinkite tikslų bucket pavadinimą ir ar pasirinktas regionas yra bucket regionas.
„Jūsų raktas neturi teisės kurti bucket.“Naudokite raktą su visa prieiga arba sukurkite bucket savo skydelyje ir spauskite Jau sukūriau jį savo skydelyje.
„Šis pavadinimas pas šį teikėją jau naudojamas; išbandykite kitą.“Bucket pavadinimai unikalūs visame teikėjo tinkle: pasirinkite kitą.
„Jūsų raktas neturi teisės to sukonfigūruoti.“Pridėkite CORS taisyklę ranka, kaip paaiškinta aukščiau.
„Dar neveikia. Peržiūrėkite taisyklę ir patikrinkite dar kartą; kai kuriems teikėjams reikia minutės ją pritaikyti.“Patikrinkite, ar kilmė yra tiksliai https://nubbo.app be pasvirojo brūkšnio gale, palaukite minutę ir patikrinkite dar kartą.
„Šis bucket jau naudojamas.“Šis bucket jau prijungtas prie Nubbo, jūsų ar kitoje paskyroje.
„Nepavyko pasiekti S3 galinio taško. Patikrinkite galinio taško URL.“Patikrinkite, ar URL yra viešas, naudoja HTTPS ir atsako iš interneto, o ne tik iš jūsų tinklo.
„Galinio taško URL neteisingas. Patikrinkite formatą.“Įveskite visą URL su https:// ir be bucket pavadinimo. Šis pranešimas rodomas ir tada, kai URL rodo į privatų ar vietinį adresą arba pavadinimo nepavyksta išspręsti.
„Baigėsi ryšio laukimo laikas. Bandykite dar kartą.“Patikrinkite savo serverio ugniasienę ir ar prievadas pasiekiamas iš išorės.

Kiek tai kainuoja

Jei renkatės tarp savo saugyklos ir teikėjo, palyginkite kainas ir ribas straipsnyje S3, R2, Spaces, Wasabi ir Backblaze B2 palyginimas.

Dažnai užduodami klausimai

Kokia savo serveryje veikianti saugykla tinka Nubbo?

Bet kuri saugykla, suderinama su S3 API su V4 parašais, pavyzdžiui, MinIO, Ceph ar SeaweedFS, taip pat S3 suderinami teikėjai, kurių nėra sąraše.

Ar galiu prijungti MinIO savo vietiniame tinkle?

Ne. Endpoint turi būti viešas URL: Nubbo atmeta privačius ir vietinius adresus, be to, jį turi pasiekti ir naršyklė.

Kurį regioną naudoti, jei mano serveris neturi regionų?

us-east-1. Tai numatytasis daugumos S3 suderinamų serverių regionas.

Kodėl Nubbo negali nustatyti CORS MinIO serveryje?

Nes MinIO bendruomenės versija nepalaiko CORS kiekvienam bucket atskirai. Ji naudoja visuotinį nustatymą, kuris pagal numatytuosius nustatymus leidžia bet kokią kilmę, o Nubbo tai patikrina.

Šaltiniai

Kainos ir ribos paimtos iš toliau nurodytų oficialių puslapių. Teikėjai jas keičia, todėl patikrinkite prieš apsispręsdami.