NocoBase 文件上传大小限制如何调整默认 20MB 上限、存储规则与分块上传完整指南【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase用 NocoBase 搭建业务系统时文件上传大小限制是最常被问到的配置之一默认上限为 20MB超过就会在上传时报错。NocoBase 是一款开源的 AI 无代码平台它的文件管理器插件file-manager统一管着本地存储、阿里云 OSS、AWS S3、腾讯云 COS 这几种存储方式的文件上传行为搞清楚它的默认值和工作机制才能把大文件问题一次调对。 NocoBase 文件上传大小限制的默认值与内部机制调整之前先看机制避免改完不生效。NocoBase 把上传限制放在文件管理器插件的常量文件里共 3 个关键参数参数默认值适用范围最小文件大小1 字节所有存储类型local / ali-oss / s3 / tx-cos默认文件大小上限20MB1024 × 1024 × 20存储规则中未单独设置 size 时生效最大可配置值无上限POSITIVE_INFINITY客户端配置界面允许填到 GB 级单次上传文件数1 个附件字段attachments上传常量定义在插件的 src/constants.ts服务端在接收请求时会执行Math.max(最小值, 存储规则中的 size ?? 20MB)也就是说每条存储规则都可以单独覆盖默认的 20MB不填就走默认值下限永远至少是 1 字节。除了大小上传时还有一道类型校验服务端读取文件流的前 4100 字节用 file-type 库做 MIME 识别再和存储规则里配置的 mimetype 过滤条件比对。识别结果会覆盖前端声明的类型用于后续的安全判断。这套逻辑位于 attachments.ts。 四种存储方式在上传限制上的行为差异NocoBase 支持 4 种存储引擎上传大小限制的填写方式相同都在存储规则里差异在行为和运维成本存储方式上传行为适用场景配置难度本地存储 local文件写入服务器磁盘的 storage 目录受磁盘容量约束内部工具、演示环境、中小规模低开箱即用阿里云 OSS走 multer-aliyun-oss 通道直传对象存储不受本机磁盘限制国内业务、需高带宽分发中需填 AK/SK 与 BucketAWS S3走 multer-s3 通道海外业务或已有 S3 体系中需填 endpoint 与密钥腾讯云 COS走 multer-cos 通道国内腾讯云用户中需填 SecretId/SecretKey默认推荐本地存储零外部依赖先把大小限制调对、把业务跑通文件量上来之后再迁移到对象存储。官方对每种存储的配置说明见文档 docs/docs/cn/file-manager/其中存储章节在 storage 目录。 如何修改 NocoBase 文件大小上限分步操作以下步骤把默认 20MB 调整为 200MB其他数值同理。登录 NocoBase 管理后台在左侧菜单找到「文件管理器」File manager并进入。结果看到当前已配置的存储规则列表。点击要修改的存储规则或新建一条进入编辑页。结果看到「文件大小」输入项单位为 MB 或 GB默认带出 20 的数值对应 20MB。把大小改为目标值例如 200如需放行大文件可暂时选 GB 单位。结果输入项接受 1 字节以上、上不封顶的数值。顺手检查「文件类型」过滤条件确认允许的 MIME 范围覆盖你要上传的文件如image/*、video/mp4。结果类型过滤与大小限制在同一页面一次配齐。保存规则。结果新的 size 值写入该存储规则后续上传按新上限校验。如果走分块上传场景客户端按分片把大文件切成多个小块分别传输每块独立受上述校验约束最后由服务端按存储规则落盘或直传对象存储。分块的意义在于单请求体积可控网络中断时只需重传失败的分片而不是整个文件。✅ 如何确认 NocoBase 上传限制已生效以及 3 个高频坑点验证方法只有一个最可靠上传一个刚超过旧上限的文件比如 21MB 的视频应被拒绝再上传一个低于新上限的文件应成功入库并在文件列表可见。两步都符合预期说明存储规则的 size 已生效。高频坑点改了限制却不生效多数情况是改错了存储规则——同一条规则下不同 mimetype 分组可能指向不同存储。先确认实际生效的是哪条规则再改它的 size。大文件上传超时其实是分片单块超限分块上传下限制卡的是每个分片而不是总大小。把总大小调大后仍报错时检查前端分片大小设置是否大于规则上限。文件类型被过滤拦截类型校验读取文件头 4100 字节做识别若存储规则里的 MIME 过滤条件没包含该类型如image/svgxml、text/xml等活跃内容类型默认会被单独管控上传会被拒报错信息指向的是类型而非大小。️ 权限、配额与监控的进阶要点权限管控文件上传、查看、删除均受 NocoBase 的角色与 ACL 权限体系控制给「文件管理器」相关动作单独授权避免普通用户越权上传。配额限制本地存储受服务器磁盘约束上线前确认 storage 目录所在分区的剩余空间对象存储则需在云厂商侧配置 Bucket 容量与生命周期策略。监控定期查看存储目录用量与访问日志关注异常大文件与高频上传来源。备份本地存储的文件目录应纳入日常备份迁移到 OSS/S3/COS 后启用版本控制作为等效手段。安全边界服务端会对可执行内容PDF、HTML、XML、SVG 等做 MIME 识别与放行名单比对不要为了省事把过滤条件放开为无条件通配。 总结操作路径就一条左侧菜单「文件管理器」→ 编辑对应存储规则 → 修改「文件大小」→ 保存然后用一个超旧限的文件实测验证。记住三个关键默认值最小 1 字节、默认上限 20MB、可配置上限无理论限制建议值按业务定常规业务资料 20MB~100MB 即可媒体素材类业务再调高并同步评估磁盘或 Bucket 容量。【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考