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).
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, comoCUBE_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
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 comisMultipart: 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.
