logologo
开始
手册
开发
插件
API
English
简体中文
开始
手册
开发
插件
API
English
简体中文
logologo
文件管理器
概述

存储引擎

概述
本地存储
AWS S3
阿里云 OSS
腾讯云 COS
S3 Pro
文件表
附件字段
扩展开发
Previous Page概述
Next Page本地存储

#概述

#介绍

存储引擎用于将文件保存到特定的服务中,包括本地存储(保存到服务器硬盘)、云存储等。

使用任何上传文件之前,都需要先配置存储引擎。系统安装时会自动添加一个本地存储引擎,可直接使用。也可以添加新的或编辑已有的引擎参数。

#存储引擎类型

目前 NocoBase 内置支持的引擎类型如下:

  • 本地存储
  • Amazon S3
  • 阿里云 OSS
  • 腾讯云 COS
  • S3 Pro

系统安装时会自动添加一个本地存储引擎,可直接使用。也可以添加新的或编辑已有的引擎参数。

#通用参数

除了不同引擎类别的特有参数外,以下部分为通用参数(以本地存储为例):

文件存储引擎配置示例

#标题

存储引擎的名称,用于人工识别。

#系统名

存储引擎的系统名称,用于系统识别。必须是系统唯一的,不填会由系统自动随机生成。

#访问 URL 前缀

该文件对外可访问的 URL 地址前缀部分,可以是 CDN 的访问 URL 基础,如:“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。