Stocker des fichiers avec Nest Storage

Qu'est-ce que Nest Storage et quand l'utiliser ?

Nest Storage est le stockage objet d'Anested Cloud : un service compatible S3 pour stocker des fichiers — uploads utilisateurs, images et vidéos, sauvegardes de bases, archives de logs, ou les fichiers générés d'un site statique. Utilisez-le dès que des fichiers ne devraient pas résider sur le disque local de votre serveur d'app, c'est-à-dire presque toujours : le stockage objet évolue sans limite, survit aux reconstructions de serveur et sert les fichiers rapidement sans solliciter votre app.

Comme il parle l'API S3, tout outil et SDK S3 existant fonctionne tel quel — vous les pointez vers l'endpoint Nest Storage et vos clés.

Comment créer un bucket et obtenir des clés API ?

Dans la section Storage de votre tableau de bord, créez un bucket (votre conteneur de fichiers) et générez une paire de clés d'accès. Vous obtenez une clé d'accès, une clé secrète et l'URL de l'endpoint S3. Gardez la clé secrète en sécurité — traitez-la comme un mot de passe et stockez-la dans l'environnement de votre app, jamais dans le contrôle de version.

Comment uploader des fichiers depuis mon code ?

Utilisez n'importe quel SDK S3 — pour JavaScript, l'AWS SDK v3. Pointez-le vers l'endpoint Nest Storage, passez vos clés et appelez PutObject. Les mêmes trois réglages (endpoint, clé d'accès, clé secrète) fonctionnent depuis Python (boto3), Go, PHP ou la CLI aws.

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

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

Comment laisser les utilisateurs uploader directement sans passer par mon serveur ?

Générez une URL présignée sur votre backend et donnez-la au navigateur — le client fait alors un PUT du fichier directement vers Nest Storage, si bien que les gros uploads ne transitent jamais par (ni ne saturent) votre serveur d'app. C'est le schéma standard pour les photos de profil, pièces jointes et médias, et il garde votre clé secrète sur le serveur, à sa place.

Comment servir des fichiers publiquement ou héberger un site statique ?

Marquez des objets (ou un préfixe de bucket) comme publics et Nest Storage les sert directement en HTTPS, sans serveur d'app — parfait pour des images, des téléchargements ou un site entièrement statique généré par Vite, Next export, Hugo ou un site builder. Gardez les fichiers privés privés et accédez-y via des URLs présignées à durée de vie courte.

Comment le stockage est-il facturé ?

Vous payez ce que vous stockez, mesuré depuis le tableau de bord, avec une allocation gratuite pour démarrer. Pas de surprises par requête à anticiper pour les apps typiques — l'usage s'affiche en direct, vous le voyez croître avec vos données. C'est l'endroit le moins cher pour conserver des fichiers volumineux ou peu modifiés, comparé à l'agrandissement du disque d'un serveur d'app.