Almacenar archivos con Nest Storage

¿Qué es Nest Storage y cuándo debo usarlo?

Nest Storage es el almacenamiento de objetos de Anested Cloud: un servicio compatible con S3 para guardar archivos — subidas de usuarios, imágenes y vídeo, copias de bases de datos, archivos de logs, o los assets generados de un sitio estático. Úsalo siempre que los archivos no deban vivir en el disco local de tu servidor de app, que es casi siempre: el almacenamiento de objetos escala sin límite, sobrevive a las reconstrucciones del servidor y sirve archivos rápido sin cargar tu app.

Como habla la API de S3, toda herramienta y SDK de S3 existente funciona sin cambios — solo los apuntas al endpoint de Nest Storage y tus claves.

¿Cómo creo un bucket y obtengo claves de API?

En la sección Storage de tu panel, crea un bucket (tu contenedor de archivos) y genera un par de claves de acceso. Obtendrás una clave de acceso, una clave secreta y la URL del endpoint de S3. Guarda la clave secreta a salvo — trátala como una contraseña y almacénala en el entorno de tu app, nunca en el control de versiones.

¿Cómo subo archivos desde mi código?

Usa cualquier SDK de S3 — para JavaScript, el AWS SDK v3. Apúntalo al endpoint de Nest Storage, pasa tus claves y llama a PutObject. Los mismos tres ajustes (endpoint, clave de acceso, clave secreta) funcionan desde Python (boto3), Go, PHP o la CLI de aws.

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

const s3 = new S3Client({
  endpoint: process.env.STORAGE_ENDPOINT, // endpoint de 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,
}));

¿Cómo dejo que los usuarios suban directamente sin pasar por mi servidor?

Genera una URL prefirmada en tu backend y entrégala al navegador — el cliente entonces hace PUT del archivo directo a Nest Storage, así las subidas grandes nunca pasan por (ni ocupan) tu servidor de app. Es el patrón estándar para fotos de perfil, adjuntos y multimedia, y mantiene tu clave secreta en el servidor, donde debe estar.

¿Cómo sirvo archivos públicamente o alojo un sitio estático?

Marca objetos (o un prefijo de bucket) como públicos y Nest Storage los sirve directo por HTTPS, sin servidor de app — perfecto para imágenes, descargas o un sitio totalmente estático generado por Vite, Next export, Hugo o un site builder. Mantén privados los archivos privados y accede a ellos con URLs prefirmadas de corta duración.

¿Cómo se cobra el almacenamiento?

Pagas por lo que almacenas, medido desde el panel, con una franquicia gratuita para empezar. Sin sorpresas por solicitud para apps típicas — el uso se muestra en vivo, así que lo ves crecer con tus datos. Es el lugar más barato para guardar archivos grandes o que cambian poco, frente a ampliar el disco de un servidor de app.