Votre stockage

Tout stockage qui parle S3.

Vos colis vivent dans votre propre bucket. Indiquez un endpoint et colis ajuste les deux réglages qu’attendent les fournisseurs compatibles S3 ; les deux restent modifiables. La CLI écrit un fichier de départ pour chaque fournisseur, et verifier vous dit si ça marche vraiment.

Les fournisseurs dans la doc

const store = createBucket({
  bucket: 'livraisons',
  endpoint: 'https://…',   // set this, and two defaults follow:
  // region: 'auto'        // for providers that ignore the region
  // forcePathStyle: true  // https://endpoint/bucket/key
})

Fournisseurs

Choisissez le vôtre.

colis init --provider r2

Cloudflare R2

Compatible S3, la région est toujours "auto", et le tableau de bord accepte la règle CORS en JSON.

colis init --provider aws

AWS S3

Les identifiants viennent de la chaîne de fournisseurs : une Lambda ou une tâche ECS n’a besoin d’aucune clé.

colis init --provider minio

MinIO

Une commande Docker, et tout le parcours de livraison tourne sur votre laptop.

colis init --provider scaleway

Scaleway Object Storage

Des régions européennes, compatible S3, et la région veut vraiment dire quelque chose.

colis init --provider wasabi

Wasabi

Compatible S3, sur un endpoint régional.

Pas dans la liste ? Tout autre stockage compatible S3 fonctionne de la même façon : un endpoint, une paire de clés, et colis verifier pour confirmer que les écritures conditionnelles sont respectées. La CLI donne les détails.

Gros fichiers

Une règle CORS, pour les envois qui contournent la fonction.

Les gros fichiers vont du navigateur directement au bucket. Le bucket doit autoriser `PUT` depuis votre page de livraison et la laisser lire l’`ETag` de chaque réponse. Sans cette règle, les petits fichiers fonctionnent toujours.

CORS

[
  {
    "AllowedOrigins": ["https://drop.example.com"],
    "AllowedMethods": ["PUT"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Sur AWS S3, collez-la sous Permissions → Cross-origin resource sharing ; le tableau de bord Cloudflare R2 prend le même JSON dans les réglages du bucket. Ajoutez http://localhost:3400 pour essayer en développement.

Vous envoyez. Ils valident. Vous le savez.

Votre stockage, une page de livraison à votre nom, un webhook à chaque étape. Rien d’hébergé chez un tiers.

Essayer la démo Déployer la page de livraison GitHub