Движок хранения: S3 (Pro)

File storage: S3(Pro)Professional Edition+

Введение

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

Возможности

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

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

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

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

Включите плагин Движок хранения: S3 (Pro) (plugin-file-storage-s3-pro).
Нажмите "Настройки -> Менеджер файлов", чтобы перейти в настройки менеджера файлов.
Нажмите кнопку "Добавить новый" и выберите "S3 Pro".

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

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

Amazon S3

Создание бакета

Откройте консоль Amazon S3.
Нажмите кнопку "Create bucket" справа.

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

Настройка CORS

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

Перейдите на вкладку 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, полученные на предыдущем шаге.
Перейдите на панель свойств страницы сведений о бакете, чтобы получить Bucket name и Region.

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

Это дополнительная настройка. Используйте её, когда нужно сделать загруженные файлы полностью публичными.

Перейдите на вкладку Permissions (Permissions), прокрутите до блока Object Ownership (Object Ownership), нажмите Edit (Edit) и включите ACLs.

Прокрутите до раздела Block public access, нажмите Edit и разрешите управление доступом через ACL.

Включите опцию Публичный доступ в настройках NocoBase.

Настройка превью миниатюр (опционально)

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

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

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