@studiocms/s3-storage

El complemento de gestión de almacenamiento S3 de StudioCMS proporciona soporte para almacenamiento S3 de AWS para StudioCMS. Este complemento permite usar Amazon S3 o cualquier servicio de almacenamiento compatible con S3 como backend para almacenar archivos en tu aplicación StudioCMS.

Uso

1. Instala el paquete usando el siguiente comando:

   npm

   npm i @studiocms/s3-storage

   pnpm

   pnpm add @studiocms/s3-storage

   yarn

   yarn add @studiocms/s3-storage

2. Añade este complemento en tu configuración de StudioCMS. (studiocms.config.mjs)

   studiocms.config.mjs

   import { defineStudioCMSConfig } from 'studiocms/config';
   import s3Storage from '@studiocms/s3-storage';
   
   export default defineStudioCMSConfig({
      storageManager: s3Storage()
   });

3. Configura las variables de entorno requeridas en tu archivo .env:

   .env

   CMS_S3_PROVIDER=AWS
   CMS_S3_REGION=us-east-1
   CMS_S3_ENDPOINT=  # Dejar vacío para AWS
   CMS_S3_ACCESS_KEY_ID=your_access_key
   CMS_S3_SECRET_ACCESS_KEY=your_secret_key
   CMS_S3_BUCKET_NAME=your_bucket_name
   CMS_S3_FORCE_PATH_STYLE=false
   # CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos

Ejemplos de variables de entorno

AWS

.env

CMS_S3_PROVIDER=AWS
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=  # Dejar vacío para AWS
CMS_S3_ACCESS_KEY_ID=your_access_key
CMS_S3_SECRET_ACCESS_KEY=your_secret_key
CMS_S3_BUCKET_NAME=your_bucket_name
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos

Cloudflare R2

.env

CMS_S3_PROVIDER=Cloudflare R2
CMS_S3_REGION=auto
CMS_S3_ENDPOINT=https://your-account-id.r2.cloudflarestorage.com
CMS_S3_ACCESS_KEY_ID=your_r2_access_key
CMS_S3_SECRET_ACCESS_KEY=your_r2_secret_key
CMS_S3_BUCKET_NAME=your_bucket_name
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos

DigitalOcean Spaces

.env

CMS_S3_PROVIDER=DigitalOcean Spaces
CMS_S3_REGION=nyc3
CMS_S3_ENDPOINT=https://nyc3.digitaloceanspaces.com
CMS_S3_ACCESS_KEY_ID=your_spaces_key
CMS_S3_SECRET_ACCESS_KEY=your_spaces_secret
CMS_S3_BUCKET_NAME=your_space_name
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos

Backblaze B2

.env

CMS_S3_PROVIDER=Backblaze B2
CMS_S3_REGION=us-west-004
CMS_S3_ENDPOINT=https://s3.us-west-004.backblazeb2.com
CMS_S3_ACCESS_KEY_ID=your_b2_key_id
CMS_S3_SECRET_ACCESS_KEY=your_b2_application_key
CMS_S3_BUCKET_NAME=your_bucket_name
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos

MinIO

.env

CMS_S3_PROVIDER=MinIO
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=http://localhost:9000
CMS_S3_ACCESS_KEY_ID=minioadmin
CMS_S3_SECRET_ACCESS_KEY=minioadmin
CMS_S3_BUCKET_NAME=your_bucket_name
CMS_S3_FORCE_PATH_STYLE=true  # Requerido para MinIO
CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos

Wasabi

.env

CMS_S3_PROVIDER=Wasabi
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=https://s3.us-east-1.wasabisys.com
CMS_S3_ACCESS_KEY_ID=your_wasabi_key
CMS_S3_SECRET_ACCESS_KEY=your_wasabi_secret
CMS_S3_BUCKET_NAME=your_bucket_name
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos

Linode Object Storage

.env

CMS_S3_PROVIDER=Linode
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=https://us-east-1.linodeobjects.com
CMS_S3_ACCESS_KEY_ID=your_linode_key
CMS_S3_SECRET_ACCESS_KEY=your_linode_secret
CMS_S3_BUCKET_NAME=your_bucket_name
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Opcional: Endpoint público personalizado para acceder a los archivos