#pkg: "@nocobase/plugin-file-storage-s3-pro"

#Almacenamiento de Archivos: S3 (Pro)

#Introducción

Basándose en el plugin de gestión de archivos, esta versión añade soporte para tipos de almacenamiento de archivos compatibles con el protocolo S3. Cualquier servicio de almacenamiento de objetos que soporte el protocolo S3 puede integrarse fácilmente, como Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2, etc., mejorando aún más la compatibilidad y flexibilidad de los servicios de almacenamiento.

#Características

1. Carga desde el Cliente: Los archivos se cargan directamente al servicio de almacenamiento sin pasar por el servidor de NocoBase, lo que permite una experiencia de carga más eficiente y rápida.

2. Acceso Privado: Todas las URL de los archivos son direcciones de autorización temporal firmadas, lo que garantiza un acceso seguro y con límite de tiempo a los archivos.

#Casos de Uso

1. Gestión de colecciones de archivos: Gestione y almacene de forma centralizada todos los archivos cargados, admitiendo varios tipos de archivos y métodos de almacenamiento para facilitar su clasificación y recuperación.

2. Almacenamiento de campos de adjuntos: Utilizado para almacenar adjuntos cargados a través de formularios o registros, con soporte para la asociación con entradas de datos específicas.

#Configuración del plugin

1. Habilite el plugin plugin-file-storage-s3-pro.

2. Vaya a "Setting -> FileManager" para acceder a la configuración de gestión de archivos.

3. Haga clic en el botón "Add new" y seleccione "S3 Pro".

4. En la ventana emergente, verá un formulario detallado para completar. Consulte la siguiente documentación para obtener los parámetros relevantes de su servicio de archivos e introdúzcalos correctamente en el formulario.

#Configuración del Proveedor de Servicios

#Amazon S3

#Creación de Bucket

1. Visite la Consola de Amazon S3.

2. Haga clic en el botón "Create bucket" en el lado derecho.

3. Rellene el Bucket Name (Nombre del bucket), deje los demás campos por defecto, desplácese hasta la parte inferior y haga clic en el botón "Create" para completar el proceso.

#Configuración de CORS

1. En la lista de buckets, encuentre y haga clic en el bucket recién creado para acceder a sus detalles.

2. Vaya a la pestaña "Permission" y desplácese hacia abajo hasta la sección de configuración de CORS.

3. Introduzca la siguiente configuración (personalícela según sea necesario) y guárdela.

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

#Recuperación de AccessKey y SecretAccessKey

1. Haga clic en el botón "Security credentials" en la esquina superior derecha.

2. Desplácese hasta la sección "Access Keys" y haga clic en "Create Access Key".

3. Acepte los términos (se recomienda el uso de IAM para entornos de producción).

4. Guarde el Access Key y el Secret Access Key mostrados.

#Recuperación y Configuración de Parámetros

1. Utilice el AccessKey ID y el AccessKey Secret recuperados.

2. Visite el panel de propiedades del bucket para encontrar el Bucket Name y la Region.

#Acceso Público (Opcional)

Esta es una configuración opcional. Configúrela cuando necesite que los archivos cargados sean completamente públicos.

1. En el panel de Permisos, desplácese hasta "Object Ownership", haga clic en "Editar" y habilite las ACL.

2. Desplácese hasta "Block public access", haga clic en "Editar" y configúrelo para permitir el control de ACL.

3. Marque "Public access" en NocoBase.

#Configuración de Miniaturas (Opcional)

Esta configuración es opcional y debe utilizarse cuando necesite optimizar el tamaño o el efecto de la vista previa de la imagen. Tenga en cuenta que esta implementación puede generar costos adicionales. Para más detalles, consulte los términos y precios de AWS.

1. Visite Transformación Dinámica de Imágenes para Amazon CloudFront.

2. Haga clic en el botón Launch in the AWS Console en la parte inferior de la página para iniciar la implementación.

3. Siga las indicaciones para completar la configuración. Las siguientes opciones requieren especial atención:
   1. Al crear la pila, debe especificar el nombre del bucket de Amazon S3 que contiene las imágenes de origen. Por favor, introduzca el nombre del bucket que creó anteriormente.
   2. Si eligió implementar la interfaz de usuario de demostración, después de la implementación, podrá usarla para probar la funcionalidad de procesamiento de imágenes. En la consola de AWS CloudFormation, seleccione su pila, vaya a la pestaña "Outputs", busque el valor correspondiente a la clave DemoUrl y haga clic en el enlace para abrir la interfaz de demostración.
   3. Esta solución utiliza la biblioteca sharp de Node.js para un procesamiento eficiente de imágenes. Puede descargar el código fuente del repositorio de GitHub y personalizarlo según sea necesario.

4. Una vez completada la configuración, espere a que el estado de la implementación cambie a CREATE_COMPLETE.

5. En la configuración de NocoBase, tenga en cuenta lo siguiente:

   1. Thumbnail rule: Rellene los parámetros de procesamiento de imágenes, como ?width=100. Para más detalles, consulte la documentación de AWS.
   2. Access endpoint: Introduzca el valor de Outputs -> ApiEndpoint después de la implementación.
   3. Full access URL style: Seleccione Ignore (ya que el nombre del bucket ya se ha rellenado en la configuración, no es necesario para el acceso).

#Ejemplo de Configuración

#Alibaba Cloud OSS

#Creación de Bucket

1. Abra la Consola de OSS.

2. Seleccione "Buckets" en el menú de la izquierda y haga clic en "Create Bucket".

3. Rellene los detalles del bucket y haga clic en "Create".
   • Bucket Name: Elija según sus necesidades comerciales.
   • Region: Seleccione la región más cercana para sus usuarios.
   • Otras configuraciones pueden permanecer por defecto o personalizarse según sea necesario.

#Configuración de CORS

1. Vaya a la página de detalles del bucket que acaba de crear.

2. Haga clic en "Content Security -> CORS" en el menú central.

3. Haga clic en el botón "Create Rule", complete los campos, desplácese hacia abajo y haga clic en "OK". Puede consultar la captura de pantalla a continuación o configurar ajustes más detallados.

#Recuperación de AccessKey y SecretAccessKey

1. Haga clic en "AccessKey" debajo del avatar de su cuenta en la esquina superior derecha.

2. Para fines de demostración, crearemos un AccessKey utilizando la cuenta principal. En un entorno de producción, se recomienda utilizar RAM para crear el AccessKey. Para obtener instrucciones, consulte la documentación de Alibaba Cloud.

3. Haga clic en el botón "Create AccessKey".

4. Complete la verificación de la cuenta.

5. Guarde el Access Key y el Secret Access Key mostrados.

#Recuperación y Configuración de Parámetros

1. Utilice el AccessKey ID y el AccessKey Secret obtenidos en el paso anterior.

2. Vaya a la página de detalles del bucket para obtener el nombre del Bucket.

3. Desplácese hacia abajo para obtener la Region (la parte ".aliyuncs.com" final no es necesaria).

4. Obtenga la dirección del endpoint y añada el prefijo https:// al introducirla en NocoBase.

#Configuración de Miniaturas (Opcional)

Esta configuración es opcional y solo debe utilizarse cuando se necesite optimizar el tamaño o el efecto de la vista previa de la imagen.

1. Rellene los parámetros relevantes para Thumbnail rule. Para la configuración específica de los parámetros, consulte la documentación de Alibaba Cloud sobre Procesamiento de Imágenes.

2. Mantenga la misma configuración para Full upload URL style y Full access URL style.

#Ejemplo de Configuración

#MinIO

#Creación de Bucket

1. Haga clic en el menú Buckets de la izquierda -> Haga clic en Create Bucket para abrir la página de creación.
2. Introduzca el nombre del Bucket y luego haga clic en el botón Guardar.

#Recuperación de AccessKey y SecretAccessKey

1. Vaya a Access Keys -> Haga clic en el botón Create access key para abrir la página de creación.

2. Haga clic en el botón Guardar.

3. Guarde el Access Key y el Secret Key de la ventana emergente para futuras configuraciones.

#Configuración de Parámetros

1. Vaya a la página File manager en NocoBase.

2. Haga clic en el botón Add new y seleccione S3 Pro.

3. Rellene el formulario:

   • AccessKey ID y AccessKey Secret: Utilice los valores guardados del paso anterior.
   • Region: MinIO implementado de forma privada no tiene el concepto de región; puede configurarlo como "auto".
   • Endpoint: Introduzca el nombre de dominio o la dirección IP de su servicio implementado.
   • Establezca Full access URL style en Path-Style.

#Ejemplo de Configuración

#Tencent COS

Consulte las configuraciones de los servicios de archivos anteriores. La lógica es similar.

#Ejemplo de Configuración

#Cloudflare R2

Consulte las configuraciones de los servicios de archivos anteriores. La lógica es similar.

#Ejemplo de Configuración

#Guía del Usuario

Consulte la documentación del plugin file-manager.