---
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. 点击「保存」即生效

## 影响范围
- 文件中心 / 项目附件 / 群聊文件等所有「文件夹批量下载」入口都遵守此设置
- 即使有打包权限，被打包的文件仍需用户对单个文件有可见权限，无权部分会自动跳过

## 不支持
- 不区分按项目 / 部门设置（全局一刀切）
- 不支持按文件大小阈值决定是否允许打包
- 不影响单文件下载（单文件下载由文件可见性独立决定）