Saltar al contenido principal
Vista general del servicio Square Cloud Blob Storage

​
¿Por qué elegir Square Cloud Blob Storage?

Como la mayor plataforma de hospedaje de bots de Latinoamérica, en la que confían 80 de los 100 servidores de Discord brasileños más grandes, creamos Blob Storage para resolver un problema con el que nuestra propia comunidad tropezaba constantemente: la CDN de Discord nunca fue pensada como backend de almacenamiento, y los enlaces se rompen, expiran o quedan limitados por rate-limit. Blob Storage lo reemplaza con un almacén de objetos diseñado para la durabilidad. El diseño es simple a propósito: un almacenamiento de objetos compatible con S3 es la fuente de verdad de tus archivos, y una CDN global los entrega desde el edge. Obtienes la durabilidad de 11 nueves de un diseño S3 con la latencia de lectura de una caché global, y cada plan incluye almacenamiento generoso.

​
Características principales

Sin tarifas de transferencia

Cero tarifas de entrada y salida. Sube y sirve todo lo que necesites: pagas por el almacenamiento, nunca por el ancho de banda.

CDN global

Los archivos públicos se sirven desde una CDN global, en el edge, cerca de tus usuarios estén donde estén.

Archivos privados

Guarda archivos sin URL pública y entrégalos mediante enlaces temporales o enlaces compartidos. Cambia cualquier archivo entre público y privado en cualquier momento.

Enlaces compartidos

Enlaces que expiran, pueden revocarse, limitan el número de descargas y, en Pro y Enterprise, piden una contraseña.

Compatible con S3

Usa aws-cli, boto3, rclone o cualquier SDK de AWS a través del gateway S3, con credenciales derivadas de tu API key.

Subidas desde el navegador

Tu servidor emite un token de subida y el navegador sube directamente, sin ver nunca tu API key.

Reglas por prefijo

Define valores por defecto (visibilidad, expiración, caché), límites (tamaño, tipos de archivo) y eliminación automática tras N días para todo lo que esté bajo un prefijo con la configuración de la cuenta.

Operaciones en el servidor

Copia, mueve y renombra archivos sin descargarlos, y cambia cabeceras (caché, disposition, metadatos) en el mismo lugar.

​
Cómo funciona

Los archivos entran por la REST API, por el navegador (con un token de subida) o por cualquier herramienta S3. Cada archivo es público o privado, y sale por una URL pública, un enlace temporal o un enlace compartido.

​
Almacenamiento y precios

El almacenamiento se incluye en tu plan, y no hay tarifas de transferencia: solo pagas por lo que queda almacenado por encima de la cuota.

​
Almacenamiento incluido

Todos los planes incluyen almacenamiento sin coste adicional, y crece con el plan:

​
Al alcanzar tu cuota

Cuando tu uso alcanza la cuota incluida, las nuevas subidas se rechazan con STORAGE_QUOTA_EXCEEDED hasta que liberes espacio o mejores tu plan. Todo lo que ya está almacenado se sigue sirviendo con normalidad. El almacenamiento que queda por encima de la cuota (por ejemplo, tras bajar de plan) tiene este precio:

Almacenamiento por encima de la cuota

R$ 0.20 por GiB iniciado más allá de tu cuota incluida.
Account Stats informa de tu uso actual, la media de este mes y el coste estimado de cualquier almacenamiento por encima de la cuota.
Blob Storage está disponible únicamente con un plan activo. Una cuenta sin plan activo aún puede listar, descargar, eliminar y hacer privados sus archivos. Cuando un plan expira o se cancela, los archivos almacenados entran en una cola de eliminación, así que renueva cuanto antes: los archivos ya eliminados no se pueden recuperar.

​
Funciones por plan

Todos los planes tienen la API completa: archivos públicos y privados, enlaces temporales, enlaces compartidos, el gateway S3, tokens de subida y reglas por prefijo. Algunas opciones dependen del plan, y todas responden con el mismo código 403 UPGRADE_REQUIRED, con un message que indica el plan (o el límite) que aplica:

​
Archivos públicos y privados

Cada objeto es público o privado, y su id indica cuál: pub/<user_id>/<path> o prv/<user_id>/<path>.
  • Los archivos públicos tienen una URL permanente en la CDN: https://blob.squarecloud.dev/pub/<user_id>/<path>.
  • Los archivos privados no tienen URL pública (url es null). Se leen mediante un enlace temporal, un enlace compartido, la API o el gateway S3.
  • Los archivos heredados, subidos antes de la actualización de septiembre de 2026, conservan su id original <user_id>/<path>, y todas las rutas lo aceptan. Su URL original en https://public-blob.squarecloud.dev/<user_id>/<path> sigue funcionando durante 30 días, hasta el 25 de octubre de 2026: muévelos con Object Copy (move: true) para obtener una URL en blob.squarecloud.dev.
Lee Enlaces y uso compartido para ver cómo se comportan la publicación, la despublicación y los distintos tipos de enlace.

​
Tipos de archivo compatibles

Se acepta prácticamente cualquier tipo de archivo, incluidos formatos sin tipo MIME registrado: .bam, .vcf, .fasta, .fastq, .parquet, .h5, .npy, etc. La extensión almacenada proviene del nombre de archivo que subes, y los sufijos de compresión compuestos se conservan (reads.fastq.gz sigue siendo .fastq.gz). La única excepción es una lista de bloqueo de ejecutables e instaladores (.exe, .msi, .bat, .apk y similares), que se rechazan con BLOCKED_FILE_TYPE.
Servir es seguro por diseño: el Content-Type servido se determina en el servidor, nunca a partir del cliente. Los formatos desconocidos y los tipos que el navegador puede renderizar (.html, .svg, .xml) se sirven siempre como descargas (application/octet-stream), así que las subidas maliciosas nunca se renderizan en el navegador.

​
Rendimiento y durabilidad

Blob Storage pasó por benchmarks exhaustivos antes del lanzamiento. Resultados clave:
  • Latencia: los archivos se reciben en ~11 ms en promedio.
  • Durabilidad: diseñada para 99.999999999% (11 nueves).
  • Entrega en el edge: los archivos públicos se guardan en caché en el edge de la CDN, así que las lecturas repetidas nunca vuelven al origen.
  • Health check: https://blob.squarecloud.dev/pub/status responde OK y nunca se guarda en caché, así que puedes apuntar tu monitoreo a él.
Benchmark de latencia global de Blob Storage
Nota: los resultados de los benchmarks se basan en pruebas controladas y varían según la ubicación geográfica, el tamaño de los archivos, la calidad de la red y los picos de uso. Para obtener los números más precisos, haz pruebas desde tu entorno de producción.
Limitaciones regionales: los usuarios de África y de algunas regiones de Asia pueden experimentar latencias más altas debido a la distancia física de los centros de datos y a la infraestructura de red local.

​
Cómo alojar tus archivos

1

Obtén una API key

Crea una API key con el scope blob:write en la configuración de tu cuenta. Consulta Autenticación.
2

Sube

Envía archivos de hasta 100 MB a Object Post. Los archivos más grandes, de hasta 10 GiB, pasan por el flujo de subida por partes. ¿Prefieres herramientas S3? Apúntalas al gateway S3.
3

Sirve

Usa la url de la respuesta para los archivos públicos, o crea un enlace temporal o un enlace compartido para los privados.
Para una primera subida y descarga con curl, sigue la guía rápida de la API de Blob Storage.
¿Usas JavaScript? El SDK de Blob (@squarecloud/blob) se encarga por ti de las subidas simples y multipart, los enlaces, los enlaces compartidos, las reglas y el gateway S3, en Node.js y en el navegador.

​
Preguntas frecuentes

Blob Storage está disponible en cualquier plan, desde Hobby en adelante, cada uno con su propia cuota de almacenamiento incluida (consulta la tabla anterior). Consulta Planes y precios para ver la comparación completa.
Las nuevas subidas se rechazan con STORAGE_QUOTA_EXCEEDED hasta que elimines objetos o mejores tu plan. Todo lo que ya está almacenado se sigue sirviendo con normalidad. El almacenamiento por encima de la cuota (por ejemplo, tras bajar de plan) tiene un precio de R$ 0.20 por GiB iniciado, y Account Stats muestra la estimación en cualquier momento.
Un enlace temporal es válido hasta 24 horas y no se puede revocar: úsalo para entregar un archivo a un usuario en este momento. Un enlace compartido dura hasta 30 días, se puede revocar, puede limitar el número de descargas y, en Pro y Enterprise, puede pedir una contraseña. Consulta Enlaces y uso compartido.
Sí. El gateway S3 en https://s3-blob.squarecloud.app funciona con aws-cli, boto3, rclone y los SDK de AWS. Obtén el par de claves de acceso en S3 Credentials: se deriva de tu API key, así que revocar la key revoca el par.
Todos los planes tienen reglas por prefijo (5 en Hobby y Standard, 10 en Pro, 20 en Enterprise). Los metadatos personalizados y los enlaces compartidos protegidos con contraseña requieren Pro o Enterprise. Las expiraciones y la eliminación automática por debajo de 7 días, y los archivos servidos sin caché en el edge, requieren Enterprise. Fuera de esos planes la solicitud se rechaza con 403 UPGRADE_REQUIRED, y su message indica el plan que desbloquea la función.
Durante 30 días. Los archivos heredados, subidos antes de la actualización de septiembre de 2026, conservan su URL en public-blob.squarecloud.dev hasta el 25 de octubre de 2026, y su id <user_id>/<path> sigue valiendo en todas las rutas. Para mantener un enlace público después, mueve el archivo con Object Copy (move: true): los archivos nuevos se sirven desde blob.squarecloud.dev/pub/..., y su id empieza por pub/ o prv/.