File manager per Cloudflare R2: collegalo a Nubbo

Nubbo si collega a Cloudflare R2 con un token API di R2 e l’Account ID del tuo account. In pochi minuti i tuoi bucket sono in un esploratore di file con caricamenti diretti, link di condivisione e gallerie. 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 Cloudflare R2. 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 un account Cloudflare R2 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. Prima del tuo primo bucket, Cloudflare ti chiede di attivare l’abbonamento a R2 dalla dashboard. Se il tuo bucket ha una giurisdizione (EU, FedRAMP o US), la scegli nella procedura guidata e Nubbo usa l’endpoint di quella giurisdizione.

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.

La chiave limitata è l’accesso minimo di cui Nubbo ha bisogno: Object Read & Write su un bucket. Con essa Nubbo non può elencare i tuoi bucket né crearne uno, quindi scrivi il nome del bucket e aggiungi tu la regola CORS.

Collegamento automatico

Passaggio 1: crea la chiave in Cloudflare R2

1. Accedi a dash.cloudflare.com e apri R2 object storage. La dashboard può mostrare i menu nella tua lingua.
2. Apri API Tokens e premi Create Account API token. Ci arrivi anche da Overview, in Account Details, Manage.
3. Scegli il permesso Admin Read & Write e crea il token.
4. Copia l’Access Key ID e la Secret Access Key. Cloudflare mostra la secret una sola volta. Usa queste due chiavi, non il valore del token.
5. Copia anche il tuo Account ID, che compare nella pagina Overview di R2.

Passaggio 2: collega il bucket in Nubbo

1. In Nubbo apri Bucket e premi Collega un bucket. Scegli Cloudflare R2 e premi Continua.

   

2. Scegli Automatico e premi Continua.

   

3. Nel passaggio La tua chiave incolla l’Access Key ID, la Secret Access Key e l’Account ID. Nubbo costruisce l’endpoint del tuo account a partire dall’Account ID. La regione di R2 è sempre auto. Prima di premere Verifica chiave, scegli la Giurisdizione del tuo bucket: Predefinita (nessuna giurisdizione) per la maggior parte dei bucket, oppure EU, FedRAMP o US. L’endpoint cambia con essa (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com per l’UE) e l’elenco mostra solo i bucket di quella giurisdizione. Premi Verifica chiave. Nubbo controlla che la chiave funzioni e che abbia accesso a tutto l’account.

   

4. 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à.

   

5. 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 in Cloudflare R2

1. In R2, Overview, premi Create bucket e dagli un nome (lettere minuscole, numeri e trattini). Non c’è nessuna regione da scegliere. Se i dati devono restare nell’UE, scegli la giurisdizione EU: l’endpoint cambia con essa.
2. Apri API Tokens e premi Create Account API token.
3. Scegli il permesso Object Read & Write e limitalo al tuo bucket.
4. Copia l’Access Key ID, la Secret Access Key e il tuo Account ID.

Passaggio 2: collega il bucket in Nubbo

1. In Bucket premi Collega un bucket, scegli Cloudflare R2 e poi Con una chiave limitata.
2. Incolla l’Access Key ID, la Secret Access Key e l’Account ID. Prima di premere Verifica chiave, scegli la stessa Giurisdizione del bucket. Premi Verifica chiave.
3. Scrivi il nome esatto del bucket e premi Verifica accesso.
4. 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.

1. In R2 apri il bucket e vai su Settings.
2. Sotto CORS Policy premi Add CORS policy e scegli la scheda JSON.
3. Incolla la regola e premi Save. Cloudflare può impiegare fino a 30 secondi ad applicarla.

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

Una volta salvata, torna in Nubbo e premi L’ho aggiunta, verifica. Se la tua chiave ha il permesso di modificare CORS, Prova a configurarlo per me lo fa al posto tuo.

Se qualcosa va storto

Quanto costa

R2 non addebita il traffico in uscita e ha un piano gratuito mensile. Lo spieghiamo in Il piano gratuito di Cloudflare R2.