Nubbo se conecta a cualquier almacenamiento compatible con S3 que firme con Signature V4, como MinIO, Ceph o SeaweedFS, en tu servidor o en otro proveedor. Solo necesitas la URL del endpoint, una clave y la región. Esta guía sigue el asistente de Nubbo paso a paso, con los dos caminos: automático o con una clave limitada a un bucket.
Qué consigues
- Explorar el bucket como un disco: carpetas, vistas, búsqueda, papelera, etiquetas y favoritos.
- Subir y descargar archivos directamente entre tu navegador y tu servidor. Los archivos no pasan por los servidores de Nubbo.
- Compartir archivos y carpetas con contraseña, caducidad y límite de descargas, recibir archivos en tu bucket y crear galerías.
- Tus claves se guardan cifradas con AES-256-GCM y puedes desconectar el bucket cuando quieras.
Antes de empezar
Necesitas un almacenamiento compatible con S3 y una cuenta de Nubbo. Cada bucket que conectas cuenta para el límite de tu plan: Gratuito permite 2, Personal 5 y Pro no tiene límite. El endpoint tiene que ser una URL pública a la que lleguen tanto los servidores de Nubbo como el navegador, y con HTTPS, porque el navegador no carga contenido HTTP desde https://nubbo.app. Nubbo rechaza endpoints que apuntan a direcciones privadas o locales. Si tu servidor no usa regiones, deja us-east-1.
Elige cómo conectar
El asistente de Nubbo ofrece dos caminos. Los dos acaban igual: el bucket conectado y listo para subir archivos desde el navegador.
| Automático | Con clave limitada | |
|---|---|---|
| Clave | Con acceso a toda la cuenta | Limitada a un bucket |
| Bucket | Nubbo usa uno tuyo o crea uno nuevo | Lo creas tú antes |
| CORS | Nubbo añade la regla por ti | Añades tú la regla |
| Cuándo elegirlo | Lo más rápido | Si no quieres dar acceso a toda la cuenta |
Conexión automática
Paso 1: crea la clave en tu servidor
- Comprueba que tu servidor expone la API S3 con firma V4 en una URL pública con HTTPS, por ejemplo
https://s3.tu-dominio.com. - Crea una clave que pueda crear buckets y cambiar su CORS.
- Apunta la URL del endpoint y la región. Si tu servidor no tiene regiones, usa
us-east-1.
Paso 2: conecta el bucket en Nubbo
En Nubbo, abre Buckets y pulsa Conectar bucket. Elige S3 personalizado / Self-hosted y pulsa Continuar.

Elige Automático y pulsa Continuar.

En el paso Tu clave, pega la access key, la secret key, la URL del endpoint y la región. Pulsa Comprobar clave. Nubbo comprueba que la clave funciona y que tiene acceso a toda la cuenta.

Elige uno de tus buckets y pulsa Usar este bucket, o marca Crear uno nuevo, escribe un nombre (y elige la región, si te la pide) y pulsa Crear y preparar. Nubbo añade al bucket una regla de CORS que solo permite subir y descargar desde la app y mantiene las reglas que ya tenga.

Revisa las tres comprobaciones, cambia el Nombre en Nubbo si quieres y pulsa Terminar. El bucket aparece en Buckets y ya puedes abrirlo en el explorador.

Si Nubbo no puede añadir la regla de CORS con tu clave, el asistente te lleva al paso CORS. Sigue entonces la sección Añade la regla de CORS.
Conexión con clave limitada
Paso 1: prepara el bucket y la clave en tu servidor
- Crea el bucket en tu servidor (en MinIO, por ejemplo, con
mc mb). - Crea una clave con permisos de lectura y escritura sobre ese bucket.
- Apunta la URL del endpoint y la región.
Paso 2: conecta el bucket en Nubbo
- En Buckets, pulsa Conectar bucket, elige S3 personalizado / Self-hosted y después Con clave limitada.
- Pega la access key, la secret key, el endpoint y la región. Pulsa Comprobar clave.
- Escribe el nombre exacto del bucket y pulsa Comprobar acceso.
- El asistente pasa al paso CORS con la regla que tienes que añadir.
Añade la regla de CORS
La regla de CORS permite que el navegador suba y descargue archivos de tu bucket desde https://nubbo.app. Es la misma que muestra el paso CORS del asistente.
Cómo se configura el CORS depende del software:
- MinIO (edición community) no acepta CORS por bucket: usa una configuración global (
MINIO_API_CORS_ALLOW_ORIGIN) que por defecto permite cualquier origen. Si no la has cambiado, no tienes que hacer nada: pulsa Ya la he añadido, comprobar y la comprobación saldrá bien. Si la cambiaste, incluyehttps://nubbo.app. - Ceph y SeaweedFS aceptan CORS por bucket con la API S3. Aplica esta regla con tu herramienta habitual (por ejemplo,
aws s3api put-bucket-corscon tu endpoint), o deja que Nubbo lo haga en el camino automático.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
"AllowedOrigins": ["https://nubbo.app"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 3600
}
]

Cuando la regla esté lista, vuelve a Nubbo y pulsa Ya la he añadido, comprobar. En Ceph y SeaweedFS, si tu clave puede cambiar el CORS, Intentar configurarlo por mí lo hace por ti.
Si algo falla
| Mensaje en Nubbo | Qué hacer |
|---|---|
| «Las credenciales no son válidas. Revisa la access key y la secret access key.» | Copia de nuevo las dos claves, sin espacios al principio ni al final. |
| «Esta clave parece limitada a un bucket. Puedes seguir con el camino limitado o crear una clave con acceso completo.» | Pulsa Seguir con clave limitada o crea una clave con acceso a toda la cuenta y pulsa Probar otra clave. |
| «No se ha encontrado el bucket. Verifica el nombre y la región.» | Revisa el nombre exacto del bucket y que la región elegida sea la suya. |
| «Tu clave no tiene permiso para crear buckets.» | Usa una clave con acceso completo o crea el bucket en tu panel y pulsa Ya lo he creado en mi panel. |
| «Ese nombre ya está en uso en este proveedor; prueba con otro.» | Los nombres de bucket son únicos en todo el proveedor: elige otro. |
| «Tu clave no tiene permiso para configurarlo.» | Añade la regla de CORS a mano, como se explica arriba. |
| «Aún no funciona. Revisa la regla y vuelve a comprobar; algunos proveedores tardan un minuto en aplicarla.» | Comprueba que el origen sea exactamente https://nubbo.app, sin barra final, espera un minuto y vuelve a comprobar. |
| «Este bucket ya está en uso.» | Ese bucket ya está conectado en Nubbo, en tu cuenta o en otra. |
| «No se pudo alcanzar el endpoint de S3. Verifica la URL del endpoint.» | Comprueba que la URL es pública, usa HTTPS y responde desde internet, no solo desde tu red. |
| «La URL del endpoint no es válida. Revisa el formato.» | Escribe la URL completa con https:// y sin el nombre del bucket. También sale si apunta a una dirección privada o local, o si el nombre no resuelve. |
| «La conexión ha caducado. Inténtalo de nuevo.» | Revisa el cortafuegos de tu servidor y que el puerto sea accesible desde fuera. |
Cuánto cuesta
Si dudas entre montar tu propio almacenamiento o usar un proveedor, compara precios y límites en S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.
Preguntas frecuentes
¿Qué almacenamientos propios funcionan con Nubbo?
Cualquiera compatible con la API S3 con firma V4, como MinIO, Ceph o SeaweedFS, y también proveedores compatibles con S3 que no aparecen en la lista.
¿Puedo conectar un MinIO de mi red local?
No. El endpoint tiene que ser una URL pública: Nubbo rechaza direcciones privadas y locales, y el navegador también necesita llegar a ella.
¿Qué región pongo si mi servidor no tiene regiones?
us-east-1. Es la región por defecto de la mayoría de servidores compatibles con S3.
¿Por qué Nubbo no puede poner el CORS en MinIO?
Porque la edición community de MinIO no admite CORS por bucket. Usa una configuración global que por defecto permite cualquier origen, y Nubbo lo comprueba.
Fuentes
Los precios y límites salen de las páginas oficiales de abajo. Los proveedores los cambian, así que compruébalos antes de decidir.