Pular para o conteúdo principal
O Blob guarda arquivos da sua conta: imagens, anexos, relatórios, o que o seu bot ou site precisar. Cada arquivo é público, com um link fixo que não vence, ou privado, e aí só sai por um link temporário que você (ou o seu código) pede na hora.

Link curto, com o nome do arquivo

Público: https://cdn.cubehost.dev/q7Rf2kLm9xA1/logo.png, que não vence. Privado: https://cdn.cubehost.dev/s/…/logo.png, que vence em minutos.

Fotos mais leves

Pelo painel, as fotos do celular e do computador são reduzidas antes de subir, com o mesmo nome, e o painel mostra quanto economizou.

Pastas pelo nome

img/logo.png fica na pasta img. Crie quantas pastas quiser, só pelo nome dos arquivos.

Pelo painel, pela API e pela CLI

A página Blob do painel, as rotas /blob/objects e cube blob, com uma chave feita para o código do projeto.

Regras de pasta

Padrões e limites para cada pasta: visibilidade, expiração, cache, tamanho, extensões e apagar o que é antigo.

Arquivo grande, em partes

Acima de 16 MB, o envio vai em partes e continua de onde parou se a conexão cair.

Planos e limites

Cada arquivo vai até 1/5 da cota do plano, no máximo 4 GB, pelo painel, pela API e pela CLI, e não há tamanho mínimo (um .keep vazio vale). A cota conta o que já está guardado e os envios em andamento (o envio simples nos 15 minutos do link, o em partes por até 24 horas, até terminar ou ser apagado); um envio que passaria dela é recusado, e o que já está no Blob continua lá. Arquivo público conta na mesma cota. Quem desce de plano precisa caber no Blob do plano menor, e quem volta ao Free continua listando, baixando e apagando o que guardou (só não envia mais). Como os projetos, os arquivos de uma conta suspensa ou no Free podem ser apagados depois de 30 dias assim, com um e-mail 3 dias antes: baixe o que quiser guardar ou assine um plano até lá. Veja Pagamento por Pix. Veja Planos e memória.

Público ou privado

A imagem (PNG, JPEG, GIF, WebP, AVIF, BMP) abre no navegador, pronta para o avatar de um bot, o banner de um site ou um anexo numa mensagem; o resto baixa como anexo, com o nome do arquivo. O link abre com qualquer programa, sem cabeçalho nenhum: o navegador, o curl, o wget, o fetch do Node e o urllib ou o requests do Python. Tornar privado ou apagar tira o link público do ar na hora, até para quem já tinha aberto (o navegador confere o link a cada uso), e tornar público de novo volta o mesmo link. Trocar um arquivo por outro com o mesmo nome gera um link novo (o do antigo para). Com a conta suspensa pela equipe, os links públicos param de abrir até a suspensão sair, e o temporário sai só pelo painel, com 5 minutos (pela chave de API, não sai).

Pelo painel

1

Abra o Blob

No painel, clique em Blob na barra lateral. Em cima fica o uso da cota.
2

Envie

Clique em Enviar arquivos (ou arraste arquivos e pastas para a área de envio). No Enviar arquivos, escolha mais arquivos ou uma pasta inteira (as subpastas vão junto), a Pasta de destino (a aberta já vem preenchida), Público ou Privado, a Expiração (Nunca expira, ou em 1, 7, 30 ou 90 dias ou 1 ano; com a regra da pasta, o padrão dela) e, se quiser, Substituir se já existir um arquivo com o mesmo nome, Adicionar um sufixo de segurança ao nome (um trecho aleatório antes da extensão, como foto-k3j9x2qa.png) e Forçar download ao abrir o link. Sem escolher a visibilidade ou a expiração, cada arquivo segue a regra da pasta dele, inclusive o de uma subpasta enviada junto que tem regra própria. O que a regra da pasta não aceita aparece antes de enviar e fica de fora. Acima de 16 MB, o arquivo vai em partes: se a conexão cair, a parte vai de novo sozinha quando ela voltar, e escolhendo o mesmo arquivo para a mesma pasta em até 24 horas, o envio continua de onde parou. As fotos (JPEG, PNG e WebP) são reduzidas antes de subir: o lado maior fica com até 2560 px, no mesmo formato e com o mesmo nome, então reenviar banner.jpg troca o banner.jpg (a PNG só diminui de tamanho, sem perder qualidade nem a transparência). No Safari e no iPhone, a foto em HEIC vira .jpg; nos outros navegadores ela sobe como está. A foto reduzida perde os dados de localização. A tela mostra quanto economizou, como “6,2 MB → 288 KB”. O aviso do fim traz Copiar link quando o arquivo é público. Com Substituir desligado, um arquivo com o mesmo nome fica como estava e o aviso diz quais.
3

Use

O botão de link de cada arquivo copia o link público (ou, no privado, um link temporário de 1 hora). No menu: Baixar, Copiar link público, Copiar link temporário (1 hora), Tornar público ou Tornar privado e Apagar. Nova pasta abre uma pasta pelo nome; ela aparece na lista quando tiver um arquivo. A busca procura no nome inteiro, dentro da pasta aberta.

Regras de pasta

Na aba Regras de pasta do Blob, cada regra vale para uma pasta e as subpastas dela (backups cobre backups/diarios, nunca backups-velhos). Quando duas regras cobrem a mesma pasta, vale a de caminho mais longo, inteira: a regra de backups/diarios vale lá, mesmo que a de backups diga outra coisa. O envio que fere a regra é recusado com o porquê (extension_not_allowed, folder_file_too_large), pelo painel, pela API e pela CLI. O plano tem 1 regra por GB da cota, até 50 (Block 5, Stack 10, Tower 25).
Apagar arquivos com mais de só começa a apagar 24 horas depois de você salvar a regra (trocar o número, ou tirar ou renomear a regra de uma subpasta dela, recomeça as 24 horas), e a aba mostra quando começa. Arquivo apagado não volta: baixe o que quiser guardar antes.
Pela API: Ver as regras e Salvar as regras (a chave Só Blob não mexe nelas).

Pelo código do projeto

Crie em Chaves de API uma chave com a permissão Só Blob e guarde numa variável de ambiente do projeto, como CUBE_API_KEY. Essa chave lista, envia, baixa, troca a visibilidade e apaga no Blob e nada mais: se ela vazar junto do código, não vê nem para os seus projetos. Pela API, o arquivo sobe do jeito que você mandar (sem reduzir), até o teto do plano e dentro das regras de pasta. O envio tem dois passos com a API, mais o arquivo no meio (o arquivo grande também pode ir em partes):
Node.js
As rotas estão na Referência da API: listar, pedir o envio, as URLs das partes, as partes que chegaram, confirmar, ver, pedir o link temporário, tornar público ou privado, apagar e as regras de pasta.
Nunca mande a chave de API no PUT do envio nem nos links: eles já trazem a autorização deles. E nunca mande a chave para o navegador de quem usa o seu site; entregue só o link.
Outras opções do pedido: expiresAt (a data em que o arquivo vence; null, nunca), isDownloadForced (o link sempre baixa), shouldOverwrite: false (não troca o arquivo de mesmo nome: 409 object_exists) e shouldAddRandomSuffix (um trecho aleatório no nome). Veja Pedir o envio.

Envio em partes

Para um arquivo grande, peça o envio com isMultipart: true: ele vai em partes de 16 MB, cada uma pela própria URL, e pode continuar por até 24 horas. Se o seu script cair no meio, veja as partes que chegaram e mande só as que faltam; mandar uma parte de novo troca a anterior.
Node.js

Pela CLI

Com a CLI na versão 0.2.3 ou mais nova (cube --version):

Segurança

  • Cada arquivo é da sua conta: pedir, baixar, trocar a visibilidade ou apagar um arquivo de outra conta responde 404, igual a um que não existe.
  • O link temporário é assinado e vence: com qualquer parte mudada, ou depois do prazo, responde 403. O público só existe enquanto você quiser.
  • HTML, SVG, XML e JavaScript saem sempre como binário, com X-Content-Type-Options: nosniff: um link do Blob nunca vira página aberta no navegador.
  • Enviar, gerar um link, tornar público ou privado, apagar e salvar as regras de pasta entram na Atividade da conta, com a chave usada; os arquivos que vencem ou que a regra apaga também, com quantos foram.
  • As partes de um envio grande vão direto ao armazenamento, cada uma pela própria URL assinada (1 hora, só com o tamanho dela). As regras de uma conta nunca valem para outra.

Erros

Os códigos do Blob (blob_not_in_plan, blob_quota_exceeded, file_too_large, extension_not_allowed, folder_file_too_large, object_exists, upload_incomplete, upload_expired…) estão em Códigos de erro.