mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 10:55:59 +00:00
59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
---
|
||
id: system-setting.file-upload-limit.howto
|
||
title: 单文件上传大小限制
|
||
type: howto
|
||
feature: system-setting
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 上传文件大小限制
|
||
- 文件上传限制怎么改
|
||
- file_upload_limit
|
||
- 文件最大多大
|
||
- 改上传上限
|
||
- 默认不限制
|
||
prerequisites:
|
||
- 需要系统管理员权限
|
||
- 部署环境变量 SYSTEM_SETTING 不为 disabled
|
||
related_tools: []
|
||
related_pages: []
|
||
negative:
|
||
- 该限制只控制单个文件大小，不是磁盘配额或总量上限
|
||
- 留空 = 不限制；后端仍受 PHP / Nginx 层 client_max_body_size 等服务级限制
|
||
- 不能按用户 / 部门设差异化阈值，全局生效
|
||
last_verified: 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 服务器层面的上传上限制约
|