Guies

Gestor de fitxers per a MinIO i S3 self-hosted: connecta'l a Nubbo

Com connectar el teu propi emmagatzematge compatible amb S3, com MinIO, Ceph o SeaweedFS, a Nubbo: endpoint, clau, regió, CORS i què fer si falla.

Nubbo es connecta a qualsevol emmagatzematge compatible amb S3 que signi amb Signature V4, com MinIO, Ceph o SeaweedFS, al teu propi servidor o amb un altre proveïdor. Només necessites la URL de l’endpoint, una clau i la regió. Aquesta guia segueix l’assistent de Nubbo pas a pas, pels dos camins: automàtic o amb una clau limitada a un bucket.

Què aconsegueixes

  • Explora el bucket com si fos un disc: carpetes, vistes, cerca, paperera, etiquetes i preferits.
  • Puja i baixa fitxers directament entre el teu navegador i el teu servidor. Els fitxers mai passen pels servidors de Nubbo.
  • Comparteix fitxers i carpetes amb contrasenya, caducitat i límit de baixades, rep fitxers al teu bucket i crea galeries.
  • Les teves claus es guarden xifrades amb AES-256-GCM i pots desconnectar el bucket quan vulguis.

Abans de començar

Necessites un emmagatzematge compatible amb S3 i un compte de Nubbo. Cada bucket que connectes compta per al límit del teu pla: Gratuït en permet 2, Personal 5 i Pro no té límit. L’endpoint ha de ser una URL pública a la qual puguin arribar tant els servidors de Nubbo com el navegador, i necessita HTTPS, perquè el navegador no carrega contingut HTTP des de https://nubbo.app. Nubbo rebutja els endpoints que apunten a adreces privades o locals. Si el teu servidor no té regions, deixa us-east-1.

Tria com connectar

L’assistent de Nubbo ofereix dos camins. Tots dos acaben igual: el bucket connectat i preparat per pujar fitxers des del navegador.

AutomàticAmb clau limitada
ClauAccés a tot el compteLimitada a un bucket
BucketNubbo en fa servir un dels teus o en crea un de nouEl crees tu primer
CORSNubbo hi afegeix la regla per tuHi afegeixes tu la regla
Quan triar-loLa via més ràpidaQuan no vols donar accés a tot el compte

Connexió automàtica

Pas 1: crea la clau al teu servidor

  1. Comprova que el teu servidor exposa l’API S3 amb signatura V4 en una URL HTTPS pública, per exemple https://s3.your-domain.com.
  2. Crea una clau que pugui crear buckets i canviar-ne el CORS.
  3. Apunta la URL de l’endpoint i la regió. Si el teu servidor no té regions, fes servir us-east-1.

Pas 2: connecta el bucket a Nubbo

  1. A Nubbo, obre Buckets i prem Connecta un bucket. Tria S3 personalitzat / Self-hosted i prem Continua.

    Pas Proveïdor de l'assistent de Nubbo amb S3 personalitzat / Self-hosted seleccionat Pas Proveïdor de l'assistent de Nubbo amb S3 personalitzat / Self-hosted seleccionat
  2. Tria Automàtic i prem Continua.

    Pas Com connectar amb les opcions Automàtic i Amb clau limitada Pas Com connectar amb les opcions Automàtic i Amb clau limitada
  3. Al pas La teva clau, enganxa l’access key, la secret key, la URL de l’endpoint i la regió. Prem Comprova la clau. Nubbo comprova que la clau funciona i que té accés a tot el compte.

    Pas La teva clau d'S3 personalitzat / Self-hosted amb la guia ràpida i els camps de la clau Pas La teva clau d'S3 personalitzat / Self-hosted amb la guia ràpida i els camps de la clau
  4. Tria un dels teus buckets i prem Fes servir aquest bucket, o selecciona Crea’n un de nou, escriu un nom (i tria la regió, si te la demana) i prem Crea i prepara. Nubbo afegeix al bucket una regla de CORS que només permet pujades i baixades des de l’app, i conserva les regles que ja tenia.

    Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou Pas El teu bucket amb la llista de buckets i l'opció Crea'n un de nou
  5. Revisa les tres comprovacions, canvia el Nom a Nubbo si vols i prem Acaba. El bucket apareix a Buckets i el pots obrir a l’explorador.

    Pas Fet amb les comprovacions de connexió, bucket i CORS Pas Fet amb les comprovacions de connexió, bucket i CORS

Si Nubbo no pot afegir la regla de CORS amb la teva clau, l’assistent et porta al pas CORS. Llavors segueix Afegeix la regla de CORS.

Connexió amb clau limitada

Pas 1: prepara el bucket i la clau al teu servidor

  1. Crea el bucket al teu servidor (a MinIO, per exemple, amb mc mb).
  2. Crea una clau amb permisos de lectura i escriptura sobre aquest bucket.
  3. Apunta la URL de l’endpoint i la regió.

Pas 2: connecta el bucket a Nubbo

  1. A Buckets, prem Connecta un bucket, tria S3 personalitzat / Self-hosted i després Amb clau limitada.
  2. Enganxa l’access key, la secret key, l’endpoint i la regió. Prem Comprova la clau.
  3. Escriu el nom exacte del bucket i prem Comprova l’accés.
  4. L’assistent passa al pas CORS amb la regla que has d’afegir.

Afegeix la regla de CORS

La regla de CORS permet que el navegador pugi i baixi fitxers del teu bucket a https://nubbo.app. És la mateixa regla que l’assistent mostra al pas CORS.

Com es configura el CORS depèn del programari:

  • MinIO (community edition) no accepta CORS per bucket: fa servir una configuració global (MINIO_API_CORS_ALLOW_ORIGIN) que per defecte permet qualsevol origen. Si no l’has canviada, no cal fer res: prem Ja l’he afegida, comprova-ho i la comprovació passarà. Si l’has canviada, inclou-hi https://nubbo.app.
  • Ceph i SeaweedFS accepten CORS per bucket a través de l’API S3. Aplica aquesta regla amb la teva eina habitual (per exemple, aws s3api put-bucket-cors amb el teu endpoint), o deixa que ho faci Nubbo al camí automàtic.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Pas CORS amb la regla que cal afegir al bucket Pas CORS amb la regla que cal afegir al bucket

Quan la regla estigui a punt, torna a Nubbo i prem Ja l’he afegida, comprova-ho. A Ceph i SeaweedFS, si la teva clau pot canviar el CORS, Intenta configurar-ho per mi ho fa per tu.

Si alguna cosa falla

Missatge a NubboQuè fer
“Les credencials no són vàlides. Revisa l’access key i la secret access key.”Torna a copiar les dues claus, sense espais al principi ni al final.
“Aquesta clau sembla limitada a un bucket. Pots continuar amb el camí limitat o crear una clau amb accés complet.”Prem Continua amb clau limitada, o crea una clau amb accés a tot el compte i prem Prova una altra clau.
“No s’ha trobat el bucket. Verifica el nom i la regió.”Comprova el nom exacte del bucket i que la regió triada és la del bucket.
“La teva clau no té permís per crear buckets.”Fes servir una clau amb accés complet, o crea el bucket al teu tauler i prem Ja l’he creat al meu tauler.
“Aquest nom ja està en ús en aquest proveïdor; prova’n un altre.”Els noms de bucket són únics a tot el proveïdor: tria’n un altre.
“La teva clau no té permís per configurar-ho.”Afegeix la regla de CORS a mà, com s’explica més amunt.
“Encara no funciona. Revisa la regla i torna-ho a comprovar; alguns proveïdors triguen un minut a aplicar-la.”Comprova que l’origen és exactament https://nubbo.app sense barra final, espera un minut i torna-ho a comprovar.
“Aquest bucket ja està en ús.”Aquest bucket ja està connectat a Nubbo, al teu compte o en un altre.
“No s’ha pogut arribar a l’endpoint d’S3. Verifica la URL de l’endpoint.”Comprova que la URL és pública, fa servir HTTPS i respon des d’internet, no només des de la teva xarxa.
“La URL de l’endpoint no és vàlida. Revisa’n el format.”Escriu la URL completa amb https:// i sense el nom del bucket. També apareix quan la URL apunta a una adreça privada o local, o quan el nom no es resol.
“S’ha esgotat el temps de connexió. Torna-ho a provar.”Revisa el tallafoc del teu servidor i que el port sigui accessible des de fora.

Quant costa

Si estàs comparant el teu propi emmagatzematge amb un proveïdor, compara preus i límits a S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.

Preguntes freqüents

Quins emmagatzematges self-hosted funcionen amb Nubbo?

Qualsevol emmagatzematge compatible amb l'API S3 amb signatura V4, com MinIO, Ceph o SeaweedFS, i també els proveïdors compatibles amb S3 que no són a la llista.

Puc connectar un MinIO de la meva xarxa local?

No. L'endpoint ha de ser una URL pública: Nubbo rebutja les adreces privades i locals, i el navegador també hi ha d'arribar.

Quina regió faig servir si el meu servidor no té regions?

us-east-1. És la regió per defecte de la majoria de servidors compatibles amb S3.

Per què Nubbo no pot configurar el CORS a MinIO?

Perquè l'edició community de MinIO no admet CORS per bucket. Fa servir una configuració global que per defecte permet qualsevol origen, i Nubbo la comprova.

Fonts

Els preus i els límits surten de les pàgines oficials de sota. Els proveïdors els canvien, així que comprova'ls abans de decidir.