mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
---
|
|
id: system-setting.file.howto
|
|
title: 文件设置（打包下载权限）
|
|
type: howto
|
|
feature: system-setting
|
|
scope: admin
|
|
locale: zh
|
|
aliases:
|
|
- 文件设置
|
|
- 打包下载
|
|
- 文件夹打包
|
|
- 打包权限
|
|
- 谁能下载文件夹
|
|
- 文件批量下载
|
|
- 限制打包下载
|
|
related_tools: []
|
|
related_pages: []
|
|
prerequisites:
|
|
- 需要系统管理员权限
|
|
negative:
|
|
- 这页只控制「文件夹打包下载」的访问名单，不控制单文件下载
|
|
- 单文件下载没有黑白名单，权限全部由文件本身的可见范围决定
|
|
- SYSTEM_SETTING=disabled 时不能修改
|
|
last_verified: v1.7.90
|
|
---
|
|
|
|
# 文件设置（打包下载权限）
|
|
|
|
## 入口
|
|
桌面端：左上角头像 →「系统设置」→「文件」。
|
|
对应后端：`POST api/system/setting/file`，参数 `type=save`。
|
|
|
|
## 是什么
|
|
仅控制「文件夹批量打包下载」入口的可见范围。原因是大文件夹打包会占大量磁盘和带宽，需要按需限制。
|
|
|
|
普通的单文件预览、下载、分享逻辑由文件本身的可见用户/权限决定，不在本页设置。
|
|
|
|
## 字段说明
|
|
|
|
- **permission_pack_type** — 打包下载授权策略：
|
|
- `all` — 所有用户都能用打包下载（默认）
|
|
- `admin` — 仅系统管理员
|
|
- `user` — 仅 `permission_pack_userids` 名单内的用户
|
|
- `close` — 全员禁用打包下载
|
|
- **permission_pack_userids** — 数组，`type=user` 时生效的白名单（用户 ID 列表）
|
|
|
|
服务端只接受这 2 个字段，其他键被自动剔除。
|
|
|
|
## 操作步骤
|
|
1. 进入「文件」设置页
|
|
2. 选择策略：默认开放 / 仅管理员 / 指定人员 / 关闭
|
|
3. 「指定人员」模式下从用户选择器勾选成员
|
|
4. 点击「保存」即生效
|
|
|
|
## 影响范围
|
|
- 文件中心 / 项目附件 / 群聊文件等所有「文件夹批量下载」入口都遵守此设置
|
|
- 即使有打包权限，被打包的文件仍需用户对单个文件有可见权限，无权部分会自动跳过
|
|
|
|
## 不支持
|
|
- 不区分按项目 / 部门设置（全局一刀切）
|
|
- 不支持按文件大小阈值决定是否允许打包
|
|
- 不影响单文件下载（单文件下载由文件可见性独立决定）
|