Filhåndtering til MinIO og selv-hostet S3: forbind den med Nubbo

Nubbo forbinder til al S3-kompatibel lagring, der signerer med Signature V4, f.eks. MinIO, Ceph eller SeaweedFS, på din egen server eller hos en anden udbyder. Du skal kun bruge endpoint-URL’en, en nøgle og regionen. Denne guide følger Nubbos forbindelsesguide trin for trin med begge veje: automatisk eller med en nøgle, der er begrænset til én bucket.

Det får du

• Gennemse bucketen som et drev: mapper, visninger, søgning, papirkurv, labels og favoritter.
• Upload og download filer direkte mellem din browser og din server. Filerne passerer aldrig gennem Nubbos servere.
• Del filer og mapper med adgangskode, udløbsdato og downloadgrænse, modtag filer i din bucket, og opret gallerier.
• Dine nøgler gemmes krypteret med AES-256-GCM, og du kan til enhver tid afbryde forbindelsen til bucketen.

Før du går i gang

Du skal have S3-kompatibel lagring og en Nubbo-konto. Hver bucket, du forbinder, tæller med i din plans grænse: Gratis-planen tillader 2, Personal 5, og Pro har ingen grænse. Endpointet skal være en offentlig URL, som både Nubbos servere og browseren kan nå, og den skal bruge HTTPS, fordi browseren ikke indlæser HTTP-indhold fra https://nubbo.app. Nubbo afviser endpoints, der peger på private eller lokale adresser. Hvis din server ikke har regioner, så lad us-east-1 stå.

Vælg, hvordan du forbinder

Nubbos forbindelsesguide tilbyder to veje. Begge ender ens: bucketen er forbundet og klar til uploads fra browseren.

Automatisk forbindelse

Trin 1: opret nøglen på din server

1. Tjek, at din server udstiller S3 API’et med Signature V4 på en offentlig HTTPS-URL, f.eks. https://s3.your-domain.com.
2. Opret en nøgle, der kan oprette buckets og ændre deres CORS.
3. Notér endpoint-URL’en og regionen. Hvis din server ikke har regioner, så brug us-east-1.

Trin 2: forbind bucketen i Nubbo

1. Åbn Buckets i Nubbo, og tryk på Forbind bucket. Vælg Tilpasset S3 / selv-hostet, og tryk på Fortsæt.

   

2. Vælg Automatisk, og tryk på Fortsæt.

   

3. I trinnet Din nøgle indsætter du access key, secret key, endpoint-URL og region. Tryk på Tjek nøgle. Nubbo tjekker, at nøglen virker, og at den har adgang til hele kontoen.

   

4. Vælg en af dine buckets, og tryk på Brug denne bucket, eller markér Opret en ny, skriv et navn (og vælg regionen, hvis du bliver spurgt), og tryk på Opret og klargør. Nubbo tilføjer en CORS-regel til bucketen, der kun tillader uploads og downloads fra appen, og beholder de regler, den allerede har.

   

5. Gennemse de tre tjek, ret Navn i Nubbo, hvis du vil, og tryk på Afslut. Bucketen vises under Buckets, og du kan åbne den i stifinderen.

   

Hvis Nubbo ikke kan tilføje CORS-reglen med din nøgle, sender forbindelsesguiden dig til trinnet CORS. Følg så Tilføj CORS-reglen.

Forbindelse med en begrænset nøgle

Trin 1: klargør bucketen og nøglen på din server

1. Opret bucketen på din server (på MinIO f.eks. med mc mb).
2. Opret en nøgle med læse- og skriverettigheder til den bucket.
3. Notér endpoint-URL’en og regionen.

Trin 2: forbind bucketen i Nubbo

1. Tryk på Forbind bucket under Buckets, vælg Tilpasset S3 / selv-hostet og derefter Med en begrænset nøgle.
2. Indsæt access key, secret key, endpoint og region. Tryk på Tjek nøgle.
3. Skriv bucketens nøjagtige navn, og tryk på Tjek adgang.
4. Forbindelsesguiden går videre til trinnet CORS med den regel, du skal tilføje.

Tilføj CORS-reglen

CORS-reglen lader browseren uploade og downloade filer fra din bucket på https://nubbo.app. Det er den samme regel, som forbindelsesguiden viser i trinnet CORS.

Hvordan CORS opsættes, afhænger af softwaren:

• MinIO (community edition) accepterer ikke CORS pr. bucket: den bruger en global indstilling (MINIO_API_CORS_ALLOW_ORIGIN), der som standard tillader alle origins. Har du ikke ændret den, er der intet at gøre: tryk på Jeg har tilføjet den, tjek, så går tjekket igennem. Har du ændret den, så tilføj https://nubbo.app.
• Ceph og SeaweedFS accepterer CORS pr. bucket gennem S3 API’et. Anvend denne regel med dit sædvanlige værktøj (f.eks. aws s3api put-bucket-cors med dit endpoint), eller lad Nubbo gøre det på den automatiske vej.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Når reglen er klar, går du tilbage til Nubbo og trykker på Jeg har tilføjet den, tjek. På Ceph og SeaweedFS klarer Prøv at konfigurere det for mig det for dig, hvis din nøgle må ændre CORS.

Hvis noget går galt

Hvad det koster

Hvis du overvejer din egen lagring over for en udbyder, så sammenlign priser og grænser i S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.