Обзор

Встроенные движки

В настоящее время NocoBase поддерживает следующие типы встроенных движков:

Локальный движок хранения автоматически добавляется при установке системы и может использоваться напрямую. Также вы можете добавлять новые движки или изменять параметры существующих.

Общие параметры движка

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

Пример конфигурации движка хранения файлов

Название

Название движка хранения, используемое для идентификации человеком.

Системное имя

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

Базовый URL для доступа

Префикс адреса URL для внешнего доступа к файлу. Это может быть базовый URL CDN, например: "https://cdn.nocobase.com/app" (без завершающего "/").

Путь

Относительный путь, используемый при хранении файлов. Эта часть будет также автоматически добавляться к финальному URL при обращении. Например: "user/avatar" (без начального или конечного "/").

Ограничение размера файла

Лимит на размер файлов, загружаемых в этот движок хранения. Файлы, превышающие этот размер, загрузить нельзя. Значение по умолчанию в системе — 20MB, а максимальный настраиваемый лимит — 1GB.

Тип файла

Ограничивает типы файлов, которые можно загружать, используя формат описания синтаксиса MIME. Например, image/* представляет файлы изображений. Несколько типов можно разделять запятыми, например image/*, application/pdf, чтобы разрешить и изображения, и PDF-файлы.

Движок хранения по умолчанию

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

Сохранять файлы при удалении записей

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

Совет

После загрузки файла итоговый путь доступа формируется путем объединения нескольких частей:

<Access base URL>/<Path>/<FileName><Extension>

Например: https://cdn.nocobase.com/app/user/avatar/20240529115151.png.