Nubbo si collega a qualsiasi storage compatibile con S3 che firmi con Signature V4, come MinIO, Ceph o SeaweedFS, sul tuo server o presso un altro provider. Ti bastano l’URL dell’endpoint, una chiave e la regione. Questa guida segue passo passo l’assistente di Nubbo, con entrambi i percorsi: automatico o con una chiave limitata a un solo bucket.
Cosa ottieni
- Sfogli il bucket come un disco: cartelle, viste, ricerca, cestino, etichette e preferiti.
- Carichi e scarichi file direttamente tra il tuo browser e il tuo server. I file non passano mai dai server di Nubbo.
- Condividi file e cartelle con password, scadenza e limite di download, ricevi file nel tuo bucket e crei gallerie.
- Le tue chiavi sono salvate cifrate con AES-256-GCM e puoi scollegare il bucket in qualsiasi momento.
Prima di iniziare
Ti servono uno storage compatibile con S3 e un account Nubbo. Ogni bucket che colleghi rientra nel limite del tuo piano: Gratis ne consente 2, Personal 5 e Pro non ha limiti. L’endpoint deve essere un URL pubblico raggiungibile sia dai server di Nubbo sia dal browser, e serve HTTPS, perché il browser non carica contenuti HTTP da https://nubbo.app. Nubbo rifiuta gli endpoint che puntano a indirizzi privati o locali. Se il tuo server non ha regioni, lascia us-east-1.
Scegli come collegarlo
L’assistente di Nubbo offre due percorsi. Entrambi finiscono allo stesso modo: il bucket collegato e pronto per i caricamenti dal browser.
| Automatico | Con una chiave limitata | |
|---|---|---|
| Chiave | Accesso a tutto l’account | Limitata a un solo bucket |
| Bucket | Nubbo usa uno dei tuoi o ne crea uno nuovo | Lo crei tu prima |
| CORS | Nubbo aggiunge la regola per te | Aggiungi tu la regola |
| Quando sceglierlo | Il modo più rapido | Quando non vuoi dare accesso a tutto l’account |
Collegamento automatico
Passaggio 1: crea la chiave nel tuo server
- Controlla che il tuo server esponga l’API S3 con firme V4 su un URL HTTPS pubblico, per esempio
https://s3.your-domain.com. - Crea una chiave che possa creare bucket e modificarne il CORS.
- Annota l’URL dell’endpoint e la regione. Se il tuo server non ha regioni, usa
us-east-1.
Passaggio 2: collega il bucket in Nubbo
In Nubbo apri Bucket e premi Collega un bucket. Scegli S3 personalizzato / Self-hosted e premi Continua.
Scegli Automatico e premi Continua.
Nel passaggio La tua chiave incolla l’access key, la secret key, l’URL dell’endpoint e la regione. Premi Verifica chiave. Nubbo controlla che la chiave funzioni e che abbia accesso a tutto l’account.
Scegli uno dei tuoi bucket e premi Usa questo bucket, oppure seleziona Creane uno nuovo, scrivi un nome (e scegli la regione, se te la chiede) e premi Crea e prepara. Nubbo aggiunge al bucket una regola CORS che consente caricamenti e download solo dall’app e mantiene le regole che ha già.
Controlla le tre verifiche, cambia il Nome in Nubbo se vuoi e premi Termina. Il bucket compare in Bucket e puoi aprirlo nell’esploratore.
Se Nubbo non riesce ad aggiungere la regola CORS con la tua chiave, l’assistente ti porta al passaggio CORS. A quel punto segui Aggiungi la regola CORS.
Collegamento con una chiave limitata
Passaggio 1: prepara il bucket e la chiave nel tuo server
- Crea il bucket sul tuo server (su MinIO, per esempio, con
mc mb). - Crea una chiave con permessi di lettura e scrittura su quel bucket.
- Annota l’URL dell’endpoint e la regione.
Passaggio 2: collega il bucket in Nubbo
- In Bucket premi Collega un bucket, scegli S3 personalizzato / Self-hosted e poi Con una chiave limitata.
- Incolla l’access key, la secret key, l’endpoint e la regione. Premi Verifica chiave.
- Scrivi il nome esatto del bucket e premi Verifica accesso.
- L’assistente passa al passaggio CORS con la regola che devi aggiungere.
Aggiungi la regola CORS
La regola CORS permette al browser di caricare e scaricare file dal tuo bucket su https://nubbo.app. È la stessa regola che l’assistente mostra nel passaggio CORS.
Il modo di configurare CORS dipende dal software:
- MinIO (community edition) non accetta il CORS per bucket: usa un’impostazione globale (
MINIO_API_CORS_ALLOW_ORIGIN) che per impostazione predefinita consente qualsiasi origine. Se non l’hai cambiata, non devi fare nulla: premi L’ho aggiunta, verifica e la verifica andrà a buon fine. Se l’hai cambiata, includihttps://nubbo.app. - Ceph e SeaweedFS accettano il CORS per bucket tramite l’API S3. Applica questa regola con il tuo strumento abituale (per esempio,
aws s3api put-bucket-corscon il tuo endpoint), oppure lascia che lo faccia Nubbo nel percorso automatico.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
"AllowedOrigins": ["https://nubbo.app"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 3600
}
]
Quando la regola è pronta, torna in Nubbo e premi L’ho aggiunta, verifica. Su Ceph e SeaweedFS, se la tua chiave può modificare CORS, Prova a configurarlo per me lo fa al posto tuo.
Se qualcosa va storto
| Messaggio in Nubbo | Cosa fare |
|---|---|
| “Credenziali non valide. Controlla l’access key e la secret access key.” | Copia di nuovo entrambe le chiavi, senza spazi all’inizio o alla fine. |
| “Questa chiave sembra limitata a un solo bucket. Puoi continuare con il percorso limitato o creare una chiave con accesso completo.” | Premi Continua con una chiave limitata, oppure crea una chiave con accesso a tutto l’account e premi Prova un’altra chiave. |
| “Bucket non trovato. Verifica il nome e la regione.” | Controlla il nome esatto del bucket e che la regione scelta sia quella del bucket. |
| “La tua chiave non ha il permesso di creare bucket.” | Usa una chiave con accesso completo, oppure crea il bucket nel tuo pannello e premi L’ho creato nel mio pannello. |
| “Quel nome è già in uso su questo provider; provane un altro.” | I nomi dei bucket sono unici in tutto il provider: scegline un altro. |
| “La tua chiave non ha il permesso di configurarlo.” | Aggiungi la regola CORS a mano, come spiegato sopra. |
| “Non funziona ancora. Controlla la regola e verifica di nuovo; alcuni provider impiegano un minuto ad applicarla.” | Controlla che l’origine sia esattamente https://nubbo.app senza barra finale, aspetta un minuto e verifica di nuovo. |
| “Questo bucket è già in uso.” | Quel bucket è già collegato in Nubbo, nel tuo account o in un altro. |
| “Impossibile raggiungere l’endpoint S3. Verifica l’URL dell’endpoint.” | Controlla che l’URL sia pubblico, usi HTTPS e risponda da internet, non solo dalla tua rete. |
| “L’URL dell’endpoint non è valido. Controlla il formato.” | Scrivi l’URL completo con https:// e senza il nome del bucket. Compare anche quando l’URL punta a un indirizzo privato o locale, o il nome non si risolve. |
| “La connessione è scaduta. Riprova.” | Controlla il firewall del tuo server e che la porta sia raggiungibile dall’esterno. |
Quanto costa
Se stai valutando il tuo storage rispetto a un provider, confronta prezzi e limiti in S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.
Domande frequenti
Quali storage self-hosted funzionano con Nubbo?
Qualsiasi storage compatibile con l'API S3 con firme V4, come MinIO, Ceph o SeaweedFS, e anche i provider compatibili con S3 che non sono nell'elenco.
Posso collegare un MinIO nella mia rete locale?
No. L'endpoint deve essere un URL pubblico: Nubbo rifiuta gli indirizzi privati e locali, e anche il browser deve poterlo raggiungere.
Quale regione uso se il mio server non ha regioni?
us-east-1. È la regione predefinita della maggior parte dei server compatibili con S3.
Perché Nubbo non può configurare CORS su MinIO?
Perché l'edizione community di MinIO non supporta il CORS per bucket. Usa un'impostazione globale che per impostazione predefinita consente qualsiasi origine, e Nubbo la verifica.
Fonti
Prezzi e limiti provengono dalle pagine ufficiali qui sotto. I provider li cambiano, quindi controllali prima di decidere.