Armazenando arquivos com o Nest Storage

O que é o Nest Storage e quando devo usá-lo?

O Nest Storage é o armazenamento de objetos da Anested Cloud: um serviço compatível com S3 para guardar arquivos — uploads de usuários, imagens e vídeos, backups de banco, arquivos de log, ou os assets gerados de um site estático. Use-o sempre que arquivos não devam ficar no disco local do seu servidor de app, o que é quase sempre: o armazenamento de objetos escala sem limite, sobrevive a reconstruções do servidor e serve arquivos rapidamente sem sobrecarregar o seu app.

Como fala a API S3, toda ferramenta e SDK S3 existente funciona sem alterações — basta apontá-los para o endpoint do Nest Storage e suas chaves.

Como crio um bucket e obtenho chaves de API?

Na seção Storage do seu painel, crie um bucket (seu contêiner de arquivos) e gere um par de chaves de acesso. Você recebe uma chave de acesso, uma chave secreta e a URL do endpoint S3. Guarde a chave secreta com segurança — trate-a como uma senha e armazene-a no ambiente do seu app, nunca no controle de versão.

Como faço upload de arquivos do meu código?

Use qualquer SDK S3 — para JavaScript, o AWS SDK v3. Aponte-o para o endpoint do Nest Storage, passe suas chaves e chame PutObject. As mesmas três configurações (endpoint, chave de acesso, chave secreta) funcionam em Python (boto3), Go, PHP ou na CLI aws.

import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";

const s3 = new S3Client({
  endpoint: process.env.STORAGE_ENDPOINT, // endpoint do Nest Storage
  region: "us-east-1",
  credentials: {
    accessKeyId: process.env.STORAGE_KEY,
    secretAccessKey: process.env.STORAGE_SECRET,
  },
  forcePathStyle: true,
});

await s3.send(new PutObjectCommand({
  Bucket: "my-bucket", Key: "uploads/logo.png", Body: fileBuffer,
}));

Como deixo os usuários fazerem upload direto sem passar pelo meu servidor?

Gere uma URL pré-assinada no seu backend e entregue-a ao navegador — o cliente então faz PUT do arquivo direto no Nest Storage, então uploads grandes nunca passam por (nem ocupam) o seu servidor de app. É o padrão para fotos de perfil, anexos e mídia, e mantém sua chave secreta no servidor, onde ela deve estar.

Como sirvo arquivos publicamente ou hospedo um site estático?

Marque objetos (ou um prefixo de bucket) como públicos e o Nest Storage os serve direto por HTTPS, sem servidor de app — perfeito para imagens, downloads ou um site totalmente estático gerado por Vite, Next export, Hugo ou um site builder. Mantenha os arquivos privados privados e acesse-os por URLs pré-assinadas de curta duração.

Como o armazenamento é cobrado?

Você paga pelo que armazena, medido no painel, com uma franquia gratuita para começar. Sem surpresas por requisição para apps típicos — o uso aparece ao vivo, então você o vê crescer com seus dados. É o lugar mais barato para guardar arquivos grandes ou pouco alterados, em comparação com aumentar o disco de um servidor de app.