Guías

Xestor de ficheiros para MinIO e S3 self-hosted: conéctao a Nubbo

Como conectar o teu propio almacenamento compatible con S3, como MinIO, Ceph ou SeaweedFS, a Nubbo: endpoint, chave, rexión, CORS e que facer se falla.

Nubbo conéctase a calquera almacenamento compatible con S3 que asine con Signature V4, como MinIO, Ceph ou SeaweedFS, no teu propio servidor ou noutro provedor. Só necesitas a URL do endpoint, unha chave e a rexión. Esta guía segue o asistente de Nubbo paso a paso, cos dous camiños: automático ou cunha chave limitada a un bucket.

Que consegues

  • Explorar o bucket coma un disco: cartafoles, vistas, busca, papeleira, etiquetas e favoritos.
  • Subir e descargar ficheiros directamente entre o teu navegador e o teu servidor. Os ficheiros nunca pasan polos servidores de Nubbo.
  • Compartir ficheiros e cartafoles con contrasinal, caducidade e límite de descargas, recibir ficheiros no teu bucket e crear galerías.
  • As túas chaves gárdanse cifradas con AES-256-GCM e podes desconectar o bucket cando queiras.

Antes de comezar

Necesitas un almacenamento compatible con S3 e unha conta de Nubbo. Cada bucket que conectas conta para o límite do teu plan: Gratuíto permite 2, Personal 5 e Pro non ten límite. O endpoint ten que ser unha URL pública á que cheguen tanto os servidores de Nubbo como o navegador, e necesita HTTPS, porque o navegador non carga contido HTTP desde https://nubbo.app. Nubbo rexeita os endpoints que apuntan a enderezos privados ou locais. Se o teu servidor non ten rexións, deixa us-east-1.

Escolle como conectar

O asistente de Nubbo ofrece dous camiños. Os dous rematan igual: o bucket conectado e listo para subir ficheiros desde o navegador.

AutomáticoCon chave limitada
ChaveCon acceso a toda a contaLimitada a un bucket
BucketNubbo usa un teu ou crea un novoCréalo ti antes
CORSNubbo engade a regra por tiEngades ti a regra
Cando escolleloO máis rápidoSe non queres dar acceso a toda a conta

Conexión automática

Paso 1: crea a chave no teu servidor

  1. Comproba que o teu servidor expón a API S3 con sinatura V4 nunha URL HTTPS pública, por exemplo https://s3.your-domain.com.
  2. Crea unha chave que poida crear buckets e cambiar o seu CORS.
  3. Apunta a URL do endpoint e a rexión. Se o teu servidor non ten rexións, usa us-east-1.

Paso 2: conecta o bucket en Nubbo

  1. En Nubbo, abre Buckets e preme Conectar bucket. Escolle S3 personalizado / Self-hosted e preme Continuar.

    Paso Provedor do asistente de Nubbo con S3 personalizado / Self-hosted seleccionado Paso Provedor do asistente de Nubbo con S3 personalizado / Self-hosted seleccionado
  2. Escolle Automático e preme Continuar.

    Paso Como conectar coas opcións Automático e Con chave limitada Paso Como conectar coas opcións Automático e Con chave limitada
  3. No paso A túa chave, pega a access key, a secret key, a URL do endpoint e a rexión. Preme Comprobar chave. Nubbo comproba que a chave funciona e que ten acceso a toda a conta.

    Paso A túa chave para S3 personalizado / Self-hosted coa guía rápida e os campos da chave Paso A túa chave para S3 personalizado / Self-hosted coa guía rápida e os campos da chave
  4. Escolle un dos teus buckets e preme Usar este bucket, ou marca Crear un novo, escribe un nome (e escolle a rexión, se cha pide) e preme Crear e preparar. Nubbo engade ao bucket unha regra de CORS que só permite subir e descargar desde a app e mantén as regras que xa teña.

    Paso O teu bucket coa lista de buckets e a opción Crear un novo Paso O teu bucket coa lista de buckets e a opción Crear un novo
  5. Revisa as tres comprobacións, cambia o Nome en Nubbo se queres e preme Rematar. O bucket aparece en Buckets e xa podes abrilo no explorador.

    Paso Listo coas comprobacións de conexión, bucket e CORS Paso Listo coas comprobacións de conexión, bucket e CORS

Se Nubbo non pode engadir a regra de CORS coa túa chave, o asistente lévate ao paso CORS. Segue entón a sección Engade a regra de CORS.

Conexión con chave limitada

Paso 1: prepara o bucket e a chave no teu servidor

  1. Crea o bucket no teu servidor (en MinIO, por exemplo, con mc mb).
  2. Crea unha chave con permisos de lectura e escritura sobre ese bucket.
  3. Apunta a URL do endpoint e a rexión.

Paso 2: conecta o bucket en Nubbo

  1. En Buckets, preme Conectar bucket, escolle S3 personalizado / Self-hosted e despois Con chave limitada.
  2. Pega a access key, a secret key, o endpoint e a rexión. Preme Comprobar chave.
  3. Escribe o nome exacto do bucket e preme Comprobar acceso.
  4. O asistente pasa ao paso CORS coa regra que tes que engadir.

Engade a regra de CORS

A regra de CORS permite que o navegador suba e descargue ficheiros do teu bucket desde https://nubbo.app. É a mesma regra que mostra o paso CORS do asistente.

Como se configura o CORS depende do software:

  • MinIO (community edition) non acepta CORS por bucket: usa unha configuración global (MINIO_API_CORS_ALLOW_ORIGIN) que por defecto permite calquera orixe. Se non a cambiaches, non tes que facer nada: preme Xa a engadín, comprobar e a comprobación pasará. Se a cambiaches, inclúe https://nubbo.app.
  • Ceph e SeaweedFS aceptan CORS por bucket a través da API S3. Aplica esta regra coa túa ferramenta habitual (por exemplo, aws s3api put-bucket-cors co teu endpoint), ou deixa que Nubbo o faga no camiño automático.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Paso CORS coa regra que hai que engadir ao bucket Paso CORS coa regra que hai que engadir ao bucket

Cando a regra estea lista, volve a Nubbo e preme Xa a engadín, comprobar. En Ceph e SeaweedFS, se a túa chave pode cambiar o CORS, Tentar configuralo por min faino por ti.

Se algo falla

Mensaxe en NubboQue facer
«As credenciais non son válidas. Revisa a access key e a secret access key.»Copia de novo as dúas chaves, sen espazos ao principio nin ao final.
«Esta chave parece limitada a un bucket. Podes seguir co camiño limitado ou crear unha chave con acceso completo.»Preme Seguir con chave limitada ou crea unha chave con acceso a toda a conta e preme Probar outra chave.
«Non se atopou o bucket. Verifica o nome e a rexión.»Revisa o nome exacto do bucket e que a rexión escollida sexa a súa.
«A túa chave non ten permiso para crear buckets.»Usa unha chave con acceso completo ou crea o bucket no teu panel e preme Xa o creei no meu panel.
«Ese nome xa está en uso neste provedor; proba con outro.»Os nomes de bucket son únicos en todo o provedor: escolle outro.
«A túa chave non ten permiso para configuralo.»Engade a regra de CORS a man, como se explica arriba.
«Aínda non funciona. Revisa a regra e volve comprobar; algúns provedores tardan un minuto en aplicala.»Comproba que a orixe sexa exactamente https://nubbo.app, sen barra final, agarda un minuto e volve comprobar.
«Este bucket xa está en uso.»Ese bucket xa está conectado en Nubbo, na túa conta ou noutra.
«Non se puido acceder ao endpoint de S3. Verifica a URL do endpoint.»Comproba que a URL é pública, usa HTTPS e responde desde internet, non só desde a túa rede.
«A URL do endpoint non é válida. Revisa o formato.»Escribe a URL completa con https:// e sen o nome do bucket. Tamén aparece cando a URL apunta a un enderezo privado ou local, ou o nome non se resolve.
«A conexión esgotou o tempo de espera. Téntao de novo.»Revisa o firewall do teu servidor e que o porto sexa accesible desde fóra.

Canto custa

Se estás comparando o teu propio almacenamento cun provedor, compara prezos e límites en S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.

Preguntas frecuentes

Que almacenamento self-hosted funciona con Nubbo?

Calquera almacenamento compatible coa API S3 con sinatura V4, como MinIO, Ceph ou SeaweedFS, e tamén provedores compatibles con S3 que non están na lista.

Podo conectar un MinIO da miña rede local?

Non. O endpoint ten que ser unha URL pública: Nubbo rexeita os enderezos privados e locais, e o navegador tamén ten que chegar a el.

Que rexión uso se o meu servidor non ten rexións?

us-east-1. É a rexión por defecto da maioría dos servidores compatibles con S3.

Por que Nubbo non pode configurar o CORS en MinIO?

Porque a edición community de MinIO non admite CORS por bucket. Usa unha configuración global que por defecto permite calquera orixe, e Nubbo compróbaa.

Fontes

Os prezos e límites saen das páxinas oficiais de abaixo. Os provedores cámbianos, así que compróbaos antes de decidir.