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

Хранилище файлов: S3 (Pro)Professional Edition+

Введение

Расширяя возможности плагина «Управление файлами», мы добавили поддержку типов файлового хранилища, совместимых с протоколом S3. Теперь вы можете легко интегрировать любой сервис объектного хранения, поддерживающий протокол S3, такой как Amazon S3, Aliyun OSS, Tencent COS, MinIO, Cloudflare R2 и другие. Это значительно повышает совместимость и гибкость ваших сервисов хранения.

Особенности

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

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

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

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

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

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

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

Amazon S3

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

Откройте https://ap-southeast-1.console.aws.amazon.com/s3/home, чтобы войти в консоль 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), прокрутите вниз до "Владение объектами" (Object Ownership), нажмите "Редактировать" и включите ACL.

Прокрутите до "Блокировать публичный доступ" (Block public access), нажмите "Редактировать" и установите разрешение на управление ACL.

В NocoBase установите флажок "Публичный доступ" (Public access).

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

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

Посетите страницу Dynamic Image Transformation for Amazon CloudFront.
Нажмите кнопку Launch in the AWS Console в нижней части страницы, чтобы начать развертывание решения.
Следуйте подсказкам для завершения настройки. Обратите особое внимание на следующие параметры:
1. При создании стека вам потребуется указать имя бакета Amazon S3, содержащего исходные изображения. Пожалуйста, введите имя бакета, который вы создали ранее.
2. Если вы выбрали развертывание демонстрационного пользовательского интерфейса, вы сможете протестировать функции обработки изображений через этот интерфейс после развертывания. В консоли AWS CloudFormation выберите свой стек, перейдите на вкладку "Выводы" (Outputs), найдите значение, соответствующее ключу 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 (Игнорировать), так как имя бакета уже было указано при настройке и больше не требуется для доступа.

Пример настройки