Passer au contenu principal
Aperçu du service Square Cloud Blob Storage

​
Pourquoi choisir Square Cloud Blob Storage ?

En tant que plus grande plateforme d’hébergement de bots d’Amérique latine, à laquelle font confiance 80 des 100 plus grands serveurs Discord brésiliens, nous avons conçu Blob Storage pour résoudre un problème que notre propre communauté rencontrait sans cesse : le CDN de Discord n’a jamais été conçu pour servir de backend de stockage, et les liens se cassent, expirent ou sont soumis à des limites de débit. Blob Storage remplace cela par un stockage d’objets conçu pour la durabilité. L’architecture est volontairement simple : un stockage d’objets compatible S3 est la source de vérité pour vos fichiers, et un CDN global les distribue depuis la périphérie. Vous bénéficiez de la durabilité à 11 neuf d’une conception S3 avec la latence de lecture d’un cache global, et chaque plan inclut un stockage généreux.

​
Fonctionnalités clés

Aucun frais de transfert

Zéro frais d’ingress et d’egress. Envoyez et servez autant que nécessaire : vous payez pour le stockage, jamais pour la bande passante.

CDN global

Les fichiers publics sont servis depuis un CDN global, en périphérie, au plus près de vos utilisateurs, où qu’ils soient.

Fichiers privés

Stockez des fichiers sans URL publique et distribuez-les via des liens temporaires ou des liens de partage. Passez n’importe quel fichier de public à privé, et inversement, à tout moment.

Liens de partage

Des liens qui expirent, peuvent être révoqués, limitent le nombre de téléchargements et, sur Pro et Enterprise, demandent un mot de passe.

Compatible S3

Utilisez aws-cli, boto3, rclone ou n’importe quel SDK AWS via la passerelle S3, avec des identifiants dérivés de votre clé API.

Envois depuis le navigateur

Votre serveur génère un jeton d’envoi et le navigateur envoie directement, sans jamais voir votre clé API.

Règles par préfixe

Définissez des valeurs par défaut (visibilité, expiration, cache), des limites (taille, types de fichiers) et une suppression automatique après N jours pour tout ce qui se trouve sous un préfixe, avec les paramètres du compte.

Opérations côté serveur

Copiez, déplacez et renommez des fichiers sans les télécharger, et modifiez les en-têtes (cache, disposition, métadonnées) sur place.

​
Comment ça marche

Les fichiers arrivent par l’API REST, par le navigateur (avec un jeton d’envoi) ou par n’importe quel outil S3. Chaque fichier est soit public, soit privé, et ressort par une URL publique, un lien temporaire ou un lien de partage.

​
Stockage et tarification

Le stockage est inclus dans votre plan, et il n’y a aucun frais de transfert : vous ne payez jamais que pour ce qui reste stocké au-delà du quota.

​
Stockage inclus

Chaque plan inclut du stockage sans coût supplémentaire, et il augmente avec le plan :

​
Atteindre votre quota

Lorsque votre utilisation atteint le quota inclus, les nouveaux envois sont refusés avec STORAGE_QUOTA_EXCEEDED jusqu’à ce que vous libériez de l’espace ou passiez à un plan supérieur. Tout ce qui est déjà stocké continue d’être servi normalement. Le stockage conservé au-delà du quota (par exemple après un passage à un plan inférieur) est facturé :

Stockage au-delà du quota

R$ 0,20 par GiB entamé au-delà de votre quota inclus.
Statistiques du compte indique votre utilisation actuelle, la moyenne du mois en cours et le coût estimé de tout stockage conservé au-delà du quota.
Blob Storage est uniquement disponible pour les abonnés disposant d’un plan actif. Un compte sans plan actif peut toujours lister, télécharger, supprimer et rendre privés ses fichiers. Lorsqu’un plan expire ou est annulé, les fichiers stockés entrent dans une file de suppression : renouvelez donc dès que possible, les fichiers déjà supprimés ne peuvent pas être récupérés.

​
Fonctionnalités par plan

Chaque plan a accès à l’API complète : fichiers publics et privés, liens temporaires, liens de partage, passerelle S3, jetons d’envoi et règles par préfixe. Quelques options dépendent du plan, et toutes répondent avec le même code 403 UPGRADE_REQUIRED, accompagné d’un message indiquant le plan (ou la limite) qui s’applique :

​
Fichiers publics et privés

Chaque objet est soit public, soit privé, et son id l’indique : pub/<user_id>/<path> ou prv/<user_id>/<path>.
  • Les fichiers publics ont une URL CDN permanente : https://blob.squarecloud.dev/pub/<user_id>/<path>.
  • Les fichiers privés n’ont pas d’URL publique (url vaut null). Vous les lisez via un lien temporaire, un lien de partage, l’API ou la passerelle S3.
  • Les fichiers hérités, envoyés avant la mise à jour de septembre 2026, conservent leur id d’origine <user_id>/<path>, et chaque route l’accepte. Leur URL d’origine sur https://public-blob.squarecloud.dev/<user_id>/<path> reste active pendant 30 jours, jusqu’au 25 octobre 2026 : déplacez-les avec Object Copy (move: true) pour obtenir une URL sur blob.squarecloud.dev.
Lisez Liens et partage pour savoir comment se comportent la publication, la dépublication et les différents types de liens.

​
Types de fichiers pris en charge

Pratiquement n’importe quel type de fichier est accepté, y compris les formats sans type MIME enregistré : .bam, .vcf, .fasta, .fastq, .parquet, .h5, .npy et ainsi de suite. L’extension stockée provient du nom de fichier que vous envoyez, et les suffixes de compression composés sont préservés (reads.fastq.gz reste .fastq.gz). La seule exception est une liste noire d’exécutables et d’installateurs (.exe, .msi, .bat, .apk et similaires), refusés avec BLOCKED_FILE_TYPE.
La diffusion est sûre par conception : le Content-Type servi est dérivé côté serveur, jamais du client. Les formats inconnus et les types rendus par le navigateur (.html, .svg, .xml) sont toujours servis en tant que téléchargements (application/octet-stream), afin que les envois malveillants ne s’affichent jamais dans le navigateur.

​
Performances et durabilité

Blob Storage a fait l’objet de benchmarks approfondis avant son lancement. Principaux résultats :
  • Latence : les fichiers sont reçus en ~11 ms en moyenne.
  • Durabilité : conçue pour 99,999999999 % (11 neuf).
  • Distribution en périphérie : les fichiers publics sont mis en cache en périphérie du CDN, de sorte que les lectures répétées ne repassent jamais par l’origine.
  • Health check : https://blob.squarecloud.dev/pub/status répond OK et n’est jamais mis en cache, vous pouvez donc y brancher votre monitoring.
Benchmark de latence globale de Blob Storage
Remarque : les résultats des benchmarks proviennent de tests contrôlés et varient selon la localisation géographique, la taille des fichiers, la qualité du réseau et les pics d’utilisation. Pour obtenir les chiffres les plus précis, testez depuis votre environnement de production.
Limitations régionales : les utilisateurs en Afrique et dans certaines régions d’Asie peuvent constater des latences plus élevées en raison de la distance physique par rapport aux centres de données et de l’infrastructure réseau locale.

​
Comment héberger vos fichiers

1

Obtenir une clé API

Créez une clé API avec le scope blob:write dans les paramètres de votre compte. Voir Authentification.
2

Envoyer

Envoyez les fichiers jusqu’à 100 Mo vers Object Post. Les fichiers plus volumineux, jusqu’à 10 GiB, passent par le flux d’envoi chunked. Vous préférez les outils S3 ? Pointez-les plutôt vers la passerelle S3.
3

Servir

Utilisez l’url de la réponse pour les fichiers publics, ou créez un lien temporaire ou un lien de partage pour les fichiers privés.
Pour un premier envoi et un premier téléchargement avec curl, suivez le guide de démarrage rapide de l’API Blob Storage.
Vous utilisez JavaScript ? Le SDK Blob (@squarecloud/blob) gère pour vous les envois simples et multipart, les liens, les partages, les règles et la passerelle S3, sur Node.js et dans le navigateur.

​
Questions fréquentes

Blob Storage est disponible sur tous les plans, à partir de Hobby, chacun avec son propre quota de stockage inclus (voir le tableau ci-dessus). Consultez Plans et tarifs pour la comparaison complète.
Les nouveaux envois sont refusés avec STORAGE_QUOTA_EXCEEDED jusqu’à ce que vous supprimiez des objets ou passiez à un plan supérieur. Tout ce qui est déjà stocké continue d’être servi normalement. Le stockage conservé au-delà du quota (par exemple après un passage à un plan inférieur) est facturé R$ 0,20 par GiB entamé, et Statistiques du compte affiche l’estimation à tout moment.
Un lien temporaire est valable jusqu’à 24 heures et ne peut pas être révoqué : utilisez-le pour remettre un fichier à un utilisateur sur le moment. Un lien de partage dure jusqu’à 30 jours, peut être révoqué, peut limiter le nombre de téléchargements et, sur Pro et Enterprise, peut demander un mot de passe. Voir Liens et partage.
Oui. La passerelle S3 à l’adresse https://s3-blob.squarecloud.app fonctionne avec aws-cli, boto3, rclone et les SDK AWS. Obtenez la paire de clés d’accès via Identifiants S3 : elle est dérivée de votre clé API, donc révoquer la clé révoque la paire.
Chaque plan a droit aux règles par préfixe (5 sur Hobby et Standard, 10 sur Pro, 20 sur Enterprise). Les métadonnées personnalisées et les liens de partage protégés par mot de passe nécessitent Pro ou Enterprise. Les expirations et la suppression automatique en dessous de 7 jours, ainsi que les fichiers servis sans cache en périphérie, nécessitent Enterprise. En dehors de ces plans, la requête est refusée avec 403 UPGRADE_REQUIRED, et son message indique le plan qui débloque la fonctionnalité.
Pendant 30 jours. Les fichiers hérités, envoyés avant la mise à jour de septembre 2026, conservent leur URL sur public-blob.squarecloud.dev jusqu’au 25 octobre 2026, et leur id <user_id>/<path> reste valable sur chaque route. Pour garder un lien public ensuite, déplacez le fichier avec Object Copy (move: true) : les nouveaux fichiers sont servis depuis blob.squarecloud.dev/pub/..., et leur id commence par pub/ ou prv/.