Nubbo
Logg innRegistrer

Veiledninger

Filbehandler for MinIO og selvhostet S3: koble den til Nubbo

Slik kobler du din egen S3-kompatible lagring, som MinIO, Ceph eller SeaweedFS, til Nubbo: endepunkt, nøkkel, region, CORS og hva du gjør ved feil.

Nubbo kobler seg til all S3-kompatibel lagring som signerer med Signature V4, som MinIO, Ceph eller SeaweedFS, på din egen server eller hos en annen leverandør. Alt du trenger, er endepunkt-URL-en, en nøkkel og regionen. Denne veiledningen følger veiviseren i Nubbo steg for steg, med begge veiene: automatisk eller med en nøkkel som er begrenset til én bucket.

Dette får du

  • Bla gjennom bucketen som en disk: mapper, visninger, søk, papirkurv, etiketter og favoritter.
  • Last opp og ned filer direkte mellom nettleseren din og serveren din. Filene går aldri via Nubbos servere.
  • Del filer og mapper med passord, utløpsdato og nedlastingsgrense, motta filer i bucketen din og lag gallerier.
  • Nøklene dine lagres kryptert med AES-256-GCM, og du kan koble fra bucketen når som helst.

Før du begynner

Du trenger S3-kompatibel lagring og en Nubbo-konto. Hver bucket du kobler til, teller mot grensen i planen din: Gratis-planen tillater 2, Personal 5 og Pro har ingen grense. Endepunktet må være en offentlig URL som både Nubbos servere og nettleseren kan nå, og det må bruke HTTPS, fordi nettleseren ikke laster HTTP-innhold fra https://nubbo.app. Nubbo avviser endepunkter som peker til private eller lokale adresser. Hvis serveren din ikke har regioner, lar du us-east-1 stå.

Velg hvordan du kobler til

Veiviseren i Nubbo har to veier. Begge ender på samme måte: bucketen er tilkoblet og klar for opplastinger fra nettleseren.

AutomatiskMed en begrenset nøkkel
NøkkelTilgang til hele kontoenBegrenset til én bucket
BucketNubbo bruker en av dine eller oppretter en nyDu oppretter den først
CORSNubbo legger til regelen for degDu legger til regelen
Når du bør velge denDen raskeste veienNår du ikke vil gi tilgang til hele kontoen

Automatisk tilkobling

Steg 1: opprett nøkkelen på serveren din

  1. Sjekk at serveren din tilbyr S3 API-et med Signature V4 på en offentlig HTTPS-URL, for eksempel https://s3.your-domain.com.
  2. Opprett en nøkkel som kan opprette buckets og endre CORS for dem.
  3. Noter endepunkt-URL-en og regionen. Hvis serveren din ikke har regioner, bruker du us-east-1.

Steg 2: koble til bucketen i Nubbo

  1. I Nubbo åpner du Buckets og trykker på Koble til bucket. Velg Egendefinert S3 / Selvhostet og trykk på Fortsett.

    Steget Leverandør i Nubbo-veiviseren med Egendefinert S3 / Selvhostet valgt Steget Leverandør i Nubbo-veiviseren med Egendefinert S3 / Selvhostet valgt

  2. Velg Automatisk og trykk på Fortsett.

    Steget Tilkobling med valgene Automatisk og Med en begrenset nøkkel Steget Tilkobling med valgene Automatisk og Med en begrenset nøkkel

  3. I steget Din nøkkel limer du inn tilgangsnøkkelen, den hemmelige nøkkelen, endepunkt-URL-en og regionen. Trykk på Sjekk nøkkel. Nubbo sjekker at nøkkelen fungerer og at den har tilgang til hele kontoen.

    Steget Din nøkkel for Egendefinert S3 / Selvhostet med hurtigveiledningen og nøkkelfeltene Steget Din nøkkel for Egendefinert S3 / Selvhostet med hurtigveiledningen og nøkkelfeltene

  4. Velg en av bucketene dine og trykk på Bruk denne bucketen, eller velg Opprett en ny, skriv inn et navn (og velg regionen hvis du blir spurt) og trykk på Opprett og klargjør. Nubbo legger til en CORS-regel i bucketen som bare tillater opplastinger og nedlastinger fra appen, og beholder reglene som allerede finnes.

    Steget Din bucket med listen over bucketer og valget Opprett en ny Steget Din bucket med listen over bucketer og valget Opprett en ny

  5. Se over de tre sjekkene, endre Navn i Nubbo hvis du vil, og trykk på Fullfør. Bucketen dukker opp under Buckets, og du kan åpne den i utforskeren.

    Steget Ferdig med sjekkene for tilkobling, bucket og CORS Steget Ferdig med sjekkene for tilkobling, bucket og CORS

Hvis Nubbo ikke kan legge til CORS-regelen med nøkkelen din, tar veiviseren deg til steget CORS. Følg da Legg til CORS-regelen.

Tilkobling med en begrenset nøkkel

Steg 1: klargjør bucketen og nøkkelen på serveren din

  1. Opprett bucketen på serveren din (på MinIO for eksempel med mc mb).
  2. Opprett en nøkkel med lese- og skrivetilgang til den bucketen.
  3. Noter endepunkt-URL-en og regionen.

Steg 2: koble til bucketen i Nubbo

  1. I Buckets trykker du på Koble til bucket, velger Egendefinert S3 / Selvhostet og deretter Med en begrenset nøkkel.
  2. Lim inn tilgangsnøkkelen, den hemmelige nøkkelen, endepunktet og regionen. Trykk på Sjekk nøkkel.
  3. Skriv inn det nøyaktige navnet på bucketen og trykk på Sjekk tilgang.
  4. Veiviseren går videre til steget CORS med regelen du må legge til.

Legg til CORS-regelen

CORS-regelen lar nettleseren laste opp og ned filer fra bucketen din på https://nubbo.app. Det er den samme regelen som veiviseren viser i steget CORS.

Hvordan CORS settes opp, avhenger av programvaren:

  • MinIO (community edition) godtar ikke CORS per bucket: den bruker en global innstilling (MINIO_API_CORS_ALLOW_ORIGIN) som tillater alle opprinnelser som standard. Hvis du ikke har endret den, er det ingenting å gjøre: trykk på Jeg har lagt den til, sjekk, så går sjekken gjennom. Hvis du har endret den, må du ta med https://nubbo.app.
  • Ceph og SeaweedFS godtar CORS per bucket via S3 API-et. Bruk denne regelen med verktøyet du vanligvis bruker (for eksempel aws s3api put-bucket-cors med endepunktet ditt), eller la Nubbo gjøre det på den automatiske veien.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Steget CORS med regelen som skal legges til i bucketen Steget CORS med regelen som skal legges til i bucketen

Når regelen er klar, går du tilbake til Nubbo og trykker på Jeg har lagt den til, sjekk. På Ceph og SeaweedFS gjør Prøv å konfigurere det for meg det for deg hvis nøkkelen din kan endre CORS.

Hvis noe går galt

Melding i NubboHva du gjør
«Ugyldig legitimasjon. Sjekk tilgangsnøkkelen og den hemmelige nøkkelen.»Kopier begge nøklene på nytt, uten mellomrom i starten eller slutten.
«Denne nøkkelen ser ut til å være begrenset til én bucket. Du kan fortsette med den begrensede veien eller opprette en nøkkel med full tilgang.»Trykk på Fortsett med begrenset nøkkel, eller opprett en nøkkel med tilgang til hele kontoen og trykk på Prøv en annen nøkkel.
«Fant ikke bucketen. Sjekk navnet og regionen.»Sjekk det nøyaktige navnet på bucketen og at regionen du har valgt, er bucketens region.
«Nøkkelen din har ikke tillatelse til å opprette buckets.»Bruk en nøkkel med full tilgang, eller opprett bucketen i panelet ditt og trykk på Jeg har opprettet den i panelet mitt.
«Det navnet er allerede i bruk hos denne leverandøren; prøv et annet.»Bucketnavn er unike hos hele leverandøren: velg et annet.
«Nøkkelen din har ikke tillatelse til å sette det opp.»Legg til CORS-regelen manuelt, som forklart ovenfor.
«Det fungerer ikke ennå. Gå gjennom regelen og sjekk igjen; noen leverandører bruker et minutt på å ta den i bruk.»Sjekk at opprinnelsen er nøyaktig https://nubbo.app uten skråstrek til slutt, vent et minutt og sjekk igjen.
«Denne bucketen er allerede i bruk.»Den bucketen er allerede tilkoblet i Nubbo, i kontoen din eller i en annen konto.
«Fikk ikke kontakt med S3-endepunktet. Sjekk endepunkt-URLen.»Sjekk at URL-en er offentlig, bruker HTTPS og svarer fra internett, ikke bare fra nettverket ditt.
«Endepunkt-URLen er ikke gyldig. Sjekk formatet.»Skriv inn hele URL-en med https:// og uten navnet på bucketen. Meldingen vises også når URL-en peker til en privat eller lokal adresse, eller når navnet ikke kan slås opp.
«Tilkoblingen tok for lang tid. Prøv igjen.»Sjekk brannmuren på serveren din og at porten kan nås utenfra.

Hva det koster

Hvis du vurderer egen lagring opp mot en leverandør, kan du sammenligne priser og grenser i S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.

Ofte stilte spørsmål

Hvilken selvhostet lagring fungerer med Nubbo?

All lagring som er kompatibel med S3 API-et med Signature V4, som MinIO, Ceph eller SeaweedFS, og også S3-kompatible leverandører som ikke står på listen.

Kan jeg koble til en MinIO på det lokale nettverket mitt?

Nei. Endepunktet må være en offentlig URL: Nubbo avviser private og lokale adresser, og nettleseren må også kunne nå det.

Hvilken region bruker jeg hvis serveren min ikke har regioner?

us-east-1. Det er standardregionen for de fleste S3-kompatible servere.

Hvorfor kan ikke Nubbo sette opp CORS på MinIO?

Fordi community-utgaven av MinIO ikke støtter CORS per bucket. Den bruker en global innstilling som tillater alle opprinnelser som standard, og Nubbo sjekker den.

Kilder

Priser og grenser er hentet fra de offisielle sidene nedenfor. Leverandørene endrer dem, så sjekk før du bestemmer deg.