dootask/resources/ai-kb/zh/howto/system-setting/file-upload-limit.md

id, title, type, feature, scope, locale, aliases, prerequisites, related_tools, related_pages, negative, last_verified

id	title	type	feature	scope	locale	aliases	prerequisites	related_tools	related_pages	negative	last_verified
system-setting.file-upload-limit.howto	单文件上传大小限制	howto	system-setting	admin	zh	上传文件大小限制 文件上传限制怎么改 file_upload_limit 文件最大多大 改上传上限 默认不限制	需要系统管理员权限 部署环境变量 SYSTEM_SETTING 不为 disabled			该限制只控制单个文件大小，不是磁盘配额或总量上限 留空 = 不限制；后端仍受 PHP / Nginx 层 client_max_body_size 等服务级限制 不能按用户 / 部门设差异化阈值，全局生效	v1.7.90

单文件上传大小限制

入口

桌面端：左上角头像 →「系统设置」→「系统设置」标签 →「其他设置」→「文件上传限制」。

字段名：file_upload_limit，整数，单位 MB，默认留空（= 不限制）。

生效范围

后端 Base::uploadFile 在每次接收上传时都会读取该值，作用于：

• 聊天消息中发送的文件 / 图片附件
• 任务详情里的附件上传
• 「文件」应用中的文档上传
• 各种自定义上传入口（凡是走 Base::uploadFile 的接口）

逻辑：调用方未显式传 size 参数时，取 file_upload_limit * 1024 KB 作为单文件上限。超过则报错 文件大小超限，最大限制：N KB。

字段默认值

字段	默认	单位
file_upload_limit	空（不限制）	MB

操作步骤

1. 进入「系统设置」→「系统设置」→「其他设置」
2. 在「文件上传限制」输入框填正整数（如 100 = 100MB）或留空
3. 「提交」保存，立即生效

不支持

• 不区分图片 / 视频 / 文档：所有类型走同一阈值
• 不能按文件后缀黑白名单（黑白名单走「文件设置」标签，不在这里）
• 留空只是"应用层不限制"，仍受 Nginx / PHP 等 web 服务器层面的上传上限制约