Обзор

Введение

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

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

Типы движков хранения

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

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

Общие параметры

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

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

Название

Имя движка хранения для удобства различения людьми.

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

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

Публичный префикс URL

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

Путь

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

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

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

Типы файлов

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

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

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

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

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

Подсказка

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

<Публичный префикс URL>/<Путь>/<Имя файла><Расширение>

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