Vai al contenuto principale
Panoramica del servizio Square Cloud Blob Storage

​
Perché scegliere Square Cloud Blob Storage?

Essendo la più grande piattaforma di hosting di bot dell’America Latina, con la fiducia di 80 dei 100 più grandi server Discord brasiliani, abbiamo costruito Blob Storage per risolvere un problema che la nostra stessa community incontrava di continuo: la CDN di Discord non è mai stata pensata come backend di storage, e i link si rompono, scadono o vengono limitati (rate-limited). Blob Storage la sostituisce con un object store progettato per la durabilità. L’architettura è semplice per scelta: un object storage compatibile con S3 è la source of truth per i tuoi file e una CDN globale li distribuisce dall’edge. Ottieni la durabilità di 11 nove di un design S3 con la latenza di lettura di una cache globale, e ogni piano include uno storage generoso.

​
Caratteristiche principali

Nessun costo di trasferimento

Zero costi di ingress ed egress. Carica e distribuisci quanto ti serve: paghi lo storage, mai la banda.

CDN globale

I file pubblici vengono distribuiti da una CDN globale, all’edge, vicino ai tuoi utenti ovunque si trovino.

File privati

Archivia file senza URL pubblico e distribuiscili tramite link temporanei o link di condivisione. Puoi passare qualsiasi file da pubblico a privato e viceversa in qualunque momento.

Link di condivisione

Link che scadono, possono essere revocati, limitano il numero di download e, su Pro ed Enterprise, richiedono una password.

Compatibile con S3

Usa aws-cli, boto3, rclone o qualsiasi SDK AWS tramite il gateway S3, con credenziali derivate dalla tua chiave API.

Upload dal browser

Il tuo server genera un upload token e il browser carica direttamente, senza mai vedere la tua chiave API.

Regole per prefisso

Imposta valori predefiniti (visibilità, scadenza, cache), limiti (dimensione, tipi di file) e l’eliminazione automatica dopo N giorni per tutto ciò che si trova sotto un prefisso con le impostazioni dell’account.

Operazioni lato server

Copia, sposta e rinomina i file senza scaricarli e modifica gli header (cache, disposition, metadati) sul posto.

​
Come funziona

I file entrano tramite la REST API, il browser (con un upload token) o qualsiasi strumento S3. Ogni file è pubblico o privato ed esce tramite un URL pubblico, un link temporaneo o un link di condivisione.

​
Storage e prezzi

Lo storage è incluso nel tuo piano, e non ci sono costi di trasferimento: paghi solo per ciò che resta archiviato oltre la quota.

​
Storage incluso

Ogni piano include storage senza costi aggiuntivi, e cresce con il piano:

​
Raggiungimento della quota

Quando il tuo utilizzo raggiunge la quota inclusa, i nuovi upload vengono rifiutati con STORAGE_QUOTA_EXCEEDED finché non liberi spazio o passi a un piano superiore. Tutto ciò che è già archiviato continua a essere distribuito normalmente. Lo storage mantenuto oltre la quota (ad esempio dopo un downgrade del piano) ha questo prezzo:

Storage oltre la quota

R$ 0,20 per ogni GiB iniziato oltre la tua quota inclusa.
Account Stats riporta il tuo utilizzo attuale, la media del mese corrente e il costo stimato dello storage mantenuto oltre la quota.
Blob Storage è disponibile solo con un piano attivo. Un account senza piano attivo può comunque elencare, scaricare, eliminare e rendere privati i file. Quando un piano scade o viene annullato, i file archiviati entrano in una coda di eliminazione: rinnova il prima possibile, i file già eliminati non possono essere recuperati.

​
Funzionalità per piano

Ogni piano ha accesso all’API completa: file pubblici e privati, link temporanei, link di condivisione, gateway S3, upload token e regole per prefisso. Alcune opzioni dipendono dal piano e rispondono tutte con lo stesso codice 403 UPGRADE_REQUIRED, con un message che indica il piano (o il limite) applicabile:

​
File pubblici e privati

Ogni oggetto è pubblico oppure privato, e il suo id lo indica: pub/<user_id>/<path> oppure prv/<user_id>/<path>.
  • I file pubblici hanno un URL CDN permanente: https://blob.squarecloud.dev/pub/<user_id>/<path>.
  • I file privati non hanno un URL pubblico (url è null). Li leggi tramite un link temporaneo, un link di condivisione, l’API o il gateway S3.
  • I file legacy, caricati prima dell’aggiornamento di settembre 2026, mantengono il loro id originale <user_id>/<path>, e ogni route lo accetta. Il loro URL originale su https://public-blob.squarecloud.dev/<user_id>/<path> resta attivo per 30 giorni, fino al 25 ottobre 2026: spostali con Object Copy (move: true) per ottenere un URL su blob.squarecloud.dev.
Leggi Link e condivisione per capire come si comportano la pubblicazione, la rimozione dalla pubblicazione e i diversi tipi di link.

​
Tipi di file supportati

Praticamente qualsiasi tipo di file è accettato, compresi i formati senza un tipo MIME registrato: .bam, .vcf, .fasta, .fastq, .parquet, .h5, .npy e così via. L’estensione archiviata deriva dal nome del file che carichi e i suffissi di compressione composti vengono preservati (reads.fastq.gz resta .fastq.gz). L’unica eccezione è una denylist di eseguibili e installer (.exe, .msi, .bat, .apk e simili), rifiutati con BLOCKED_FILE_TYPE.
La distribuzione è sicura per design: il Content-Type servito è derivato lato server, mai dal client. I formati sconosciuti e i tipi renderizzabili dal browser (.html, .svg, .xml) vengono sempre serviti come download (application/octet-stream), così gli upload malevoli non vengono mai renderizzati nel browser.

​
Prestazioni e durabilità

Blob Storage è stato sottoposto a benchmark approfonditi prima del lancio. Risultati principali:
  • Latenza: i file vengono ricevuti in ~11 ms in media.
  • Durabilità: progettata per 99,999999999% (11 nove).
  • Distribuzione edge: i file pubblici sono in cache all’edge della CDN, quindi le letture ripetute non tornano mai all’origine.
  • Health check: https://blob.squarecloud.dev/pub/status risponde OK e non viene mai messo in cache, così puoi usarlo per il tuo monitoraggio.
Benchmark della latenza globale di Blob Storage
Nota: i risultati dei benchmark provengono da test controllati e variano in base a posizione geografica, dimensione dei file, qualità della rete e picchi di utilizzo. Per i numeri più precisi, esegui i test dal tuo ambiente di produzione.
Limitazioni regionali: gli utenti in Africa e in alcune regioni asiatiche possono riscontrare latenze più elevate a causa della distanza fisica dai data center e dell’infrastruttura di rete locale.

​
Come ospitare i tuoi file

1

Ottieni una chiave API

Crea una chiave API con lo scope blob:write nelle impostazioni del tuo account. Vedi Autenticazione.
2

Carica

Invia file fino a 100 MB a Object Post. I file più grandi, fino a 10 GiB, passano per il flusso di upload chunked. Preferisci gli strumenti S3? Puntali invece al gateway S3.
3

Distribuisci

Usa l’url della risposta per i file pubblici, oppure crea un link temporaneo o un link di condivisione per quelli privati.
Per un primo upload e download con curl, segui la guida rapida dell’API di Blob Storage.
Usi JavaScript? L’SDK Blob (@squarecloud/blob) gestisce per te upload semplici e multipart, link, condivisioni, regole e il gateway S3, su Node.js e nel browser.

​
Domande frequenti

Blob Storage è disponibile con qualsiasi piano, da Hobby in su, ognuno con la propria quota di storage inclusa (vedi la tabella sopra). Consulta Piani e prezzi per il confronto completo.
I nuovi upload vengono rifiutati con STORAGE_QUOTA_EXCEEDED finché non elimini oggetti o passi a un piano superiore. Tutto ciò che è già archiviato continua a essere distribuito normalmente. Lo storage mantenuto oltre la quota (ad esempio dopo un downgrade) costa R$ 0,20 per ogni GiB iniziato, e Account Stats mostra la stima in qualsiasi momento.
Sì. Il gateway S3 su https://s3-blob.squarecloud.app funziona con aws-cli, boto3, rclone e gli SDK AWS. Ottieni la coppia di chiavi di accesso da S3 Credentials: è derivata dalla tua chiave API, quindi revocare la chiave revoca anche la coppia.
Ogni piano ha le regole per prefisso (5 su Hobby e Standard, 10 su Pro, 20 su Enterprise). I metadati personalizzati e i link di condivisione protetti da password richiedono Pro o Enterprise. Le scadenze e l’eliminazione automatica sotto i 7 giorni, e i file distribuiti senza cache edge, richiedono Enterprise. Al di fuori di questi piani la richiesta viene rifiutata con 403 UPGRADE_REQUIRED e il suo message indica il piano che sblocca la funzionalità.
Per 30 giorni. I file legacy, caricati prima dell’aggiornamento di settembre 2026, mantengono il loro URL su public-blob.squarecloud.dev fino al 25 ottobre 2026, e il loro id <user_id>/<path> resta valido su ogni route. Per avere un link pubblico anche dopo, sposta il file con Object Copy (move: true): i nuovi file sono distribuiti da blob.squarecloud.dev/pub/... e il loro id inizia con pub/ o prv/.