Pular para o conteúdo principal
Visão geral do serviço Blob Storage da Square Cloud

​
Por que escolher o Blob Storage da Square Cloud?

Como a maior plataforma de hospedagem de bots da América Latina, com a confiança de 80 dos 100 maiores servidores brasileiros do Discord, criamos o Blob Storage para resolver um problema que a nossa própria comunidade vivia enfrentando: a CDN do Discord nunca foi feita para ser um backend de armazenamento, e os links quebram, expiram ou sofrem rate limit. O Blob Storage substitui isso por um armazenamento de objetos projetado para durabilidade. A arquitetura é simples de propósito: um armazenamento de objetos compatível com S3 é a fonte da verdade dos seus arquivos, e uma CDN global os entrega a partir do edge. Você tem a durabilidade de 11 noves de um design S3 com a latência de leitura de um cache global, e todo plano inclui armazenamento generoso.

​
Recursos principais

Sem taxas de transferência

Zero taxas de entrada e saída. Faça upload e sirva o quanto precisar: você paga pelo armazenamento, nunca pela banda.

CDN global

Os arquivos públicos são servidos por uma CDN global, no edge, perto dos seus usuários, onde quer que eles estejam.

Arquivos privados

Armazene arquivos sem URL pública e entregue-os por meio de links temporários ou links de compartilhamento. Alterne qualquer arquivo entre público e privado a qualquer momento.

Links de compartilhamento

Links que expiram, podem ser revogados, limitam o número de downloads e, no Pro e no Enterprise, pedem uma senha.

Compatível com S3

Use aws-cli, boto3, rclone ou qualquer AWS SDK pelo gateway S3, com credenciais derivadas da sua chave de API.

Uploads pelo navegador

O seu servidor gera um token de upload e o navegador faz o upload diretamente, sem nunca ver a sua chave de API.

Regras por prefixo

Defina padrões (visibilidade, expiração, cache), limites (tamanho, tipos de arquivo) e exclusão automática após N dias para tudo sob um prefixo com as configurações da conta.

Operações no servidor

Copie, mova e renomeie arquivos sem baixá-los, e altere os cabeçalhos (cache, disposition, metadados) no próprio arquivo.

​
Como funciona

Os arquivos entram pela API REST, pelo navegador (com um token de upload) ou por qualquer ferramenta S3. Cada arquivo é público ou privado, e sai por uma URL pública, um link temporário ou um link de compartilhamento.

​
Armazenamento e preços

O armazenamento vem incluído no seu plano, e não há taxas de transferência: você só paga pelo que fica armazenado acima da cota.

​
Armazenamento incluído

Todo plano inclui armazenamento sem custo adicional, e ele cresce junto com o plano:

​
Ao atingir sua cota

Quando o seu uso atinge a cota incluída, novos uploads são recusados com STORAGE_QUOTA_EXCEEDED até você liberar espaço ou fazer upgrade do plano. Tudo o que já está armazenado continua sendo servido normalmente. O armazenamento mantido acima da cota (por exemplo, após um downgrade de plano) custa:

Armazenamento acima da cota

R$ 0,20 por GiB iniciado além da sua cota incluída.
O Account Stats informa o seu uso atual, a média deste mês e o custo estimado de qualquer armazenamento mantido além da cota.
O Blob Storage exige um plano ativo. Uma conta sem plano ativo ainda pode listar, baixar, excluir e tornar arquivos privados. Quando um plano expira ou é cancelado, os arquivos armazenados entram em uma fila de exclusão, então renove assim que possível: arquivos já excluídos não podem ser recuperados.

​
Recursos por plano

Todo plano tem a API completa: arquivos públicos e privados, links temporários, links de compartilhamento, gateway S3, tokens de upload e regras por prefixo. Algumas opções dependem do plano, e todas respondem com o mesmo código 403 UPGRADE_REQUIRED, com uma message que indica o plano (ou o limite) que se aplica:

​
Arquivos públicos e privados

Todo objeto é público ou privado, e o seu id indica qual: pub/<user_id>/<path> ou prv/<user_id>/<path>.
  • Arquivos públicos têm uma URL permanente na CDN: https://blob.squarecloud.dev/pub/<user_id>/<path>.
  • Arquivos privados não têm URL pública (url é null). Você os lê por meio de um link temporário, de um link de compartilhamento, da API ou do gateway S3.
  • Arquivos legados, enviados antes da atualização de setembro de 2026, mantêm o id original <user_id>/<path>, e toda rota aceita esse id. A URL original em https://public-blob.squarecloud.dev/<user_id>/<path> continua funcionando por 30 dias, até 25 de outubro de 2026: mova esses arquivos com Object Copy (move: true) para ganhar uma URL em blob.squarecloud.dev.
Leia Links e compartilhamento para entender como funcionam a publicação, a despublicação e os diferentes tipos de link.

​
Tipos de arquivo suportados

Praticamente qualquer tipo de arquivo é aceito, incluindo formatos sem tipo MIME registrado: .bam, .vcf, .fasta, .fastq, .parquet, .h5, .npy e assim por diante. A extensão armazenada vem do nome do arquivo que você envia, e sufixos compostos de compressão são preservados (reads.fastq.gz continua .fastq.gz). A única exceção é uma denylist de executáveis e instaladores (.exe, .msi, .bat, .apk e similares), recusados com BLOCKED_FILE_TYPE.
A entrega é segura por design: o Content-Type servido é definido no servidor, nunca pelo cliente. Formatos desconhecidos e tipos renderizáveis pelo navegador (.html, .svg, .xml) são sempre servidos como download (application/octet-stream), então uploads maliciosos nunca são renderizados no navegador.

​
Performance e durabilidade

O Blob Storage passou por benchmarks extensivos antes do lançamento. Principais resultados:
  • Latência: os arquivos são recebidos em ~11 ms em média.
  • Durabilidade: projetada para 99,999999999% (11 noves).
  • Entrega no edge: arquivos públicos ficam em cache na borda da CDN, então leituras repetidas nunca voltam até a origem.
  • Health check: https://blob.squarecloud.dev/pub/status responde OK e nunca fica em cache, então você pode apontar o seu monitoramento para ele.
Benchmark de latência global do Blob Storage
Observação: os resultados de benchmark vêm de testes controlados e variam conforme a localização geográfica, o tamanho do arquivo, a qualidade da rede e o horário de pico. Para ter números mais precisos, teste a partir do seu ambiente de produção.
Limitações regionais: usuários na África e em algumas regiões da Ásia podem ter latências maiores devido à distância física dos data centers e à infraestrutura de rede local.

​
Como hospedar seus arquivos

1

Obtenha uma chave de API

Crie uma chave de API com o escopo blob:write nas configurações da sua conta. Veja Autenticação.
2

Faça o upload

Envie arquivos de até 100 MB para o Envio de Objeto. Arquivos maiores, até 10 GiB, passam pelo fluxo de upload em partes. Prefere ferramentas S3? Aponte-as para o gateway S3.
3

Sirva os arquivos

Use a url da resposta para arquivos públicos, ou crie um link temporário ou um link de compartilhamento para os privados.
Para um primeiro upload e download com curl, siga o início rápido da API do Blob Storage.
Usando JavaScript? O SDK de Blob (@squarecloud/blob) cuida para você dos uploads simples e multipart, links, compartilhamentos, regras e do gateway S3, no Node.js e no navegador.

​
Perguntas frequentes

O Blob Storage está disponível em qualquer plano, a partir do Hobby, cada um com sua própria cota de armazenamento incluída (veja a tabela acima). Veja Planos e Preços para a comparação completa.
Novos uploads são recusados com STORAGE_QUOTA_EXCEEDED até você excluir objetos ou fazer upgrade do plano. Tudo o que já está armazenado continua sendo servido normalmente. O armazenamento mantido acima da cota (por exemplo, após um downgrade) custa R$ 0,20 por GiB iniciado, e o Account Stats mostra a estimativa a qualquer momento.
Sim. O gateway S3 em https://s3-blob.squarecloud.app funciona com aws-cli, boto3, rclone e os AWS SDKs. Obtenha o par de chaves de acesso em Credenciais S3: ele é derivado da sua chave de API, então revogar a chave revoga o par.
Todo plano tem regras por prefixo (5 no Hobby e no Standard, 10 no Pro, 20 no Enterprise). Metadados personalizados e links de compartilhamento protegidos por senha exigem Pro ou Enterprise. Expirações e exclusão automática abaixo de 7 dias, e arquivos servidos sem cache no edge, exigem Enterprise. Fora desses planos a requisição é recusada com 403 UPGRADE_REQUIRED, e a sua message indica o plano que libera o recurso.
Por 30 dias. Arquivos legados, enviados antes da atualização de setembro de 2026, mantêm a URL em public-blob.squarecloud.dev até 25 de outubro de 2026, e o id <user_id>/<path> continua valendo em toda rota. Para manter um link público depois disso, mova o arquivo com Object Copy (move: true): arquivos novos são servidos a partir de blob.squarecloud.dev/pub/..., e o id deles começa com pub/ ou prv/.