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

File storage: S3(Pro)Professional Edition+

Введение

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

Возможности

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

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

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

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

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

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

Конфигурация провайдера сервиса

Amazon S3

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

Откройте консоль Amazon S3 (Amazon S3 Console).
Нажмите кнопку "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, нажмите 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 для доступа: Выберите Игнорировать (так как имя бакета уже указано в конфигурации, оно не требуется для доступа).

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