Aktar
IT
DownloadDownload

Circa 5 minuti

Come caricare file su Cloudflare R2 e condividere link

Cloudflare R2 è perfetto per Aktar: nessun costo per il traffico in uscita, un piano gratuito che copre la maggior parte degli screenshot e domini personalizzati serviti dalla rete di Cloudflare. Aktar ha un preset dedicato a R2, quindi ti servono solo l’Account ID, un token API e un bucket.

Cosa ti serve

  • Un account Cloudflare con R2 attivo
  • Un dominio su Cloudflare, se vuoi i link sul tuo dominio (facoltativo)
  • Aktar installata sul tuo Mac

Passo passo

  1. 1

    Crea un bucket

    Nella dashboard di Cloudflare, apri R2 Object Storage e clicca Create bucket. Scegli un nome breve come screenshots e lascia la posizione automatica.

  2. 2

    Dai al bucket un indirizzo pubblico

    Apri le Settings del bucket. In Custom Domains, collega un dominio o un sottodominio che gestisci su Cloudflare, per esempio files.example.com. È l’opzione migliore per l’uso reale.

    Per una prova veloce puoi invece attivare il Public Development URL (pub-….r2.dev). Cloudflare limita le richieste a quell’URL e non lo consiglia in produzione.

  3. 3

    Crea un token API

    Torna alla pagina di riepilogo di R2, apri Manage API tokens e crea un token con il permesso Object Read & Write, limitato al tuo bucket. Copia l’Access Key ID e la Secret Access Key: la chiave segreta viene mostrata una sola volta.

    Il tuo Account ID compare nella stessa pagina, ed è anche la prima parte dell’endpoint S3 https://<ACCOUNT_ID>.r2.cloudflarestorage.com.

  4. 4

    Aggiungi la destinazione in Aktar

    Apri Impostazioni → Destinazioni → Aggiungi destinazione in Aktar, scegli Cloudflare R2 e compila i campi come nella tabella qui sotto. Aktar ricava l’endpoint dal tuo Account ID.

  5. 5

    Verifica e salva

    Clicca Verifica connessione. Aktar carica un piccolo file di prova, controlla che sia raggiungibile tramite il tuo indirizzo pubblico e poi lo elimina. Quando è tutto verde, clicca Salva e trascina il tuo primo file sull’icona della barra dei menu.

Impostazioni in Aktar

Inserisci questi valori in Impostazioni → Destinazioni → Aggiungi destinazione. I nomi dei campi corrispondono a quelli dell’app.

CampoValore di esempio
ProviderCloudflare R2
Nome profiloPersonaleUn nome qualsiasi.
ID account3f9a71c0e2b8…Dalla pagina di riepilogo di R2.
RegioneautoLascia il valore predefinito.
ID chiave di accessoa1b2c3d4…Dal token API di R2.
Chiave di accesso segreta••••••••Salvata nel Portachiavi di macOS.
Bucketscreenshots
URL di base pubblicofiles.example.comIl tuo dominio personalizzato o l’URL r2.dev.
Percorso oggetto{year}/{month}/{uuid}.{ext}Facoltativo, vedi nomi dei file e cartelle.

Suggerimenti

  • Limita il token API al solo bucket usato da Aktar. Se il token dovesse trapelare, nient’altro sarebbe esposto.
  • Un dominio personalizzato viene messo in cache da Cloudflare, quindi i link più popolari si caricano velocemente in tutto il mondo senza costi aggiuntivi.
  • Vuoi cartelle in ordine? Cambia il percorso degli oggetti, per esempio in shots/{date}/{filename}-{random}.{ext}. Vedi nomi dei file e cartelle.
  • Vuoi caricamenti che si eliminano da soli dopo un periodo da 1 a 30 giorni? Con un token Admin Read & Write, Aktar aggiunge per te le regole del ciclo di vita del bucket. Con un token Object Read & Write, aggiungile tu in Object Lifecycle Rules nelle Settings del bucket. Vedi caricamenti con scadenza.

Risoluzione dei problemi

Il link restituisce Access Denied o 403

Assicurati che l’URL di base pubblico sia il tuo dominio personalizzato o l’URL r2.dev. L’endpoint …r2.cloudflarestorage.com serve solo per l’API e non distribuisce mai file pubblici. Maggiori dettagli in errori Access Denied.

Verifica connessione dice che le credenziali non sono valide

Usa l’Access Key ID e la Secret Access Key del token API di R2, non un normale token API di Cloudflare né la tua Global API Key. Controlla che l’ID account non contenga spazi in più.

I caricamenti funzionano ma i link sono lenti o limitati

Probabilmente stai usando l’URL di sviluppo r2.dev. Per l’uso in produzione collega un dominio personalizzato.

Sei ancora bloccato?Consulta le FAQ o chiedi su GitHub.