Файловое хранилище: S3 (Pro)

Введение

На основе плагина управления файлами добавляется новый тип файлового хранилища, совместимый с протоколом S3. К нему можно легко подключить любую службу объектного хранения, поддерживающую протокол S3, например Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 и другие, что дополнительно повышает совместимость и гибкость службы хранения.

Особенности

Загрузка с клиента: в процессе загрузки файла не требуется проходить через сервер NocoBase — файл напрямую передаётся в службу хранения, обеспечивая более эффективную и быструю загрузку.
Приватный доступ: при обращении к файлам все URL являются временными адресами с подписью и авторизацией, что обеспечивает безопасность и ограниченный срок действия доступа к файлам.

Сценарии использования

Управление таблицей файлов: централизованное управление и хранение всех загруженных файлов с поддержкой различных типов файлов и способов хранения, что упрощает их категоризацию и поиск.
Хранение в поле вложений: используется для хранения вложений, загружаемых в формы или записи, с поддержкой связи с конкретными записями данных.

Настройка плагина

Включите плагин plugin-file-storage-s3-pro
Нажмите "Setting-> FileManager", чтобы открыть настройки управления файлами
Нажмите кнопку "Add new" и выберите "S3 Pro"

После появления всплывающей панели вы увидите форму с большим количеством полей. Обратитесь к дальнейшей документации, чтобы получить информацию о параметрах соответствующей файловой службы и правильно заполнить форму.

Настройка поставщиков услуг

Amazon S3

Создание Bucket

Откройте https://ap-southeast-1.console.aws.amazon.com/s3/home, чтобы перейти в консоль S3
Нажмите кнопку "Create bucket" справа

Укажите Bucket Name (имя хранилища), остальные поля можно оставить со значениями по умолчанию. Прокрутите страницу вниз и нажмите кнопку "Create", чтобы завершить создание.

Настройка CORS

Перейдите к списку buckets, найдите только что созданный Bucket и нажмите на него, чтобы открыть страницу сведений

Перейдите на вкладку "Permission", затем прокрутите страницу вниз до раздела настройки CORS

Введите следующую конфигурацию (при необходимости её можно детализировать) и сохраните

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

Получение AccessKey и SecretAccessKey

Нажмите кнопку "Security credentials" в правом верхнем углу страницы

Прокрутите страницу вниз, найдите раздел "Access Keys" и нажмите кнопку "Create Access Key".

Нажмите «Согласен» (здесь показан пример с основной учётной записью; в рабочей среде рекомендуется использовать IAM).

Сохраните отображаемые на странице Access key и Secret access key

Получение и настройка параметров

AccessKey ID и AccessKey Secret — это соответствующие значения, полученные на предыдущем шаге. Введите их без ошибок
Откройте панель properties на странице сведений о bucket. Там можно получить информацию о названии Bucket и Region (регионе).

Публичный доступ (необязательно)

Эта настройка не является обязательной и выполняется только при необходимости сделать загруженные файлы полностью общедоступными

Перейдите на панель Permissions, прокрутите страницу до Object Ownership, нажмите «Редактировать» и включите ACLs

Прокрутите страницу до Block public access, нажмите «Редактировать» и разрешите управление с помощью ACLs

В NocoBase установите флажок Public access

Настройка миниатюр (необязательно)

Эта настройка является необязательной и используется для оптимизации размера или качества предварительного просмотра изображений. Обратите внимание: этот вариант развертывания может повлечь дополнительные расходы. Точную стоимость см. в соответствующих условиях AWS.

Перейдите в раздел Dynamic Image Transformation for Amazon CloudFront.
Нажмите кнопку Launch in the AWS Console в нижней части страницы, чтобы начать развертывание решения.
Завершите настройку согласно инструкциям. Особое внимание обратите на следующие параметры:
1. При создании стека необходимо указать имя хранилища Amazon S3, содержащего исходные изображения. Укажите имя созданного ранее хранилища.
2. Если вы выбрали развертывание демонстрационного интерфейса, после завершения развертывания сможете протестировать обработку изображений через этот интерфейс. В консоли AWS CloudFormation выберите свой стек, перейдите на вкладку «Вывод», найдите значение, соответствующее ключу DemoUrl, и нажмите эту ссылку, чтобы открыть демонстрационный интерфейс.
3. В этом решении для эффективной обработки изображений используется библиотека sharp Node.js. Исходный код можно скачать из репозитория GitHub и при необходимости настроить.
После завершения настройки дождитесь, пока статус развертывания изменится на CREATE_COMPLETE.
При настройке NocoBase обратите внимание на следующие параметры:
1. Thumbnail rule: укажите параметры обработки изображений, например ?width=100. Подробнее см. в документации AWS.
2. Access endpoint: укажите значение Outputs -> ApiEndpoint после развертывания.
3. Full access URL style: установите флажок Ignore (поскольку имя хранилища уже указано при настройке и при обращении к нему больше не требуется).

Пример конфигурации