文件存储与客户端下载

本教程迁自此前整理的飞书全功能教程，原整理日期为 2026 年 10 月 17 日，迁入日期为 2026 年 10 月 28 日。功能入口、模型、权限及费用以当前站点实际配置为准；历史模式和未开放功能会在正文说明。截图中的示例账号与参数仅用于说明。

四、文件存储与客户端下载

（一）、选择并配置存储服务

1.进入“系统设置 → 系统设置 → 存储设置”；

可选择腾讯云 COS、阿里云 OSS、七牛云对象存储或本地存储。打开某个标签只是查看该服务表单，不等于启用它。

2.准备所选服务的凭据、空间和地域信息；

COS 的 SecretId、SecretKey、存储桶及地域必须属于同一套服务；其他云存储同样要按对应表单填写。全球加速等选项应结合实际网络和服务费用决定，不能把别人的示例域名直接用于本站。

3.启用目标服务并保存，只保留一套生效存储；

显式启用一套云存储会关闭其他云存储；同一次请求不能同时开启多套。历史数据若同时开启多套，读取优先级为腾讯、阿里、七牛，否则回落本地。不要依赖历史冲突状态运行。

4.编辑凭据前确认本页的空值规则；

七牛页面的空字符串会作为实际值提交，不能认为“留空就是保留原密钥”。更换前先妥善留存现有配置，避免因误清空导致上传中断。

5.上传一个非敏感小文件，核对预览、下载和公网访问；

上传成功但预览失败时，检查返回地址、公开域名和外部可访问性。本地存储的公开地址还受部署侧 FILE_PUBLIC_HOST / GOMAXAI_HOST 配置影响，需交给部署维护人员核对。切换存储也不代表旧文件已自动迁移。

图解：腾讯云COS

选择腾讯云 COS 标签，按控制台提供的信息填写；保存参数和启用当前存储是两个动作，完成后用允许上传的普通图片检查访问结果。

本图编号定位：1. SecretId；2. SecretKey；3. 存储桶名称；4. 所属地域；5. 全球加速域名；6. 保存设置。

图解：阿里云OSS

选择阿里云 OSS 标签，确认地域、Bucket 和访问域名属于同一存储空间；填写凭据后保存，再按本节说明启用。

本图编号定位：1. accessKeyId；2. keySecret；3. 存储桶名称；4. 所属地域；5. 保存设置。

图解：本地存储

本地存储依赖服务器目录权限和对外访问路径。确认域名与部署设置对应，再保存并检查新上传文件；已有文件地址需要单独核对。

本图编号定位：1. 配置教程；2. 启用状态；3. 文件访问地址（选填）；4. 保存设置。

图解：七牛云对象存储

七牛配置保存时会实际提交空字段，修改前先确认完整参数。切换标签本身不会启用七牛；保存后核对当前启用的存储类型。

本图编号定位：1. 配置教程；2. 启用状态；3. 公开存储空间名称；4. 文件访问域名；5. 访问密钥（AccessKey）；6. 秘密密钥（SecretKey）；7. 保存设置。

（二）、配置客户端下载入口

1.打开“客户端下载”，填写入口标题与说明；

启用时必须有标题，并至少提供一种下载链接或二维码。标题最长120字符，其余相关字段最长2000字符。

2.按系统填写 Windows、macOS、Linux 安装包等链接；

使用有效 HTTP 或 HTTPS 地址，地址中不能嵌入用户名密码。移动端二维码应指向本项目实际提供的应用或页面。

3.保存后从前台实际打开并核对文件版本；

下载入口只负责展示和分发，不会自动开启远程控制，也不会把网页端能力自动变成桌面端能力。

图解：客户端下载

本图编号定位：1. 显示下载入口；2. 弹窗标题；3. 小程序二维码地址；4. 小程序说明；5. App 二维码地址。

本图编号定位：1. App 说明；2. Windows 下载地址；3. macOS 下载地址；4. Linux 下载地址；5. 桌面端下载说明；6. 保存下载配置。

下载与移动端逐项图解

图解：分别配置桌面与手机的下载入口

打开客户端下载，先确认是否显示下载入口，再填写弹窗标题、小程序二维码与说明、App二维码与说明，以及Windows、macOS、Linux下载地址和桌面端说明。

图中编号：1 显示下载入口；2 弹窗标题；3 小程序二维码地址；4 小程序说明；5 App 二维码地址。

图中编号：1 App 说明；2 Windows 下载地址；3 macOS 下载地址；4 Linux 下载地址；5 桌面端下载说明；6 保存下载配置。

二维码支持PNG、JPG、WebP，需小于5MB；上传后自动回填地址，也可填写已托管地址。标题最多120字符；开启入口时需有标题且至少提供一种链接或二维码，链接使用http或https。保存下载配置后，在普通用户端打开入口逐项检查。二维码、下载链接与安装包需分别对应正确端；填好链接不代表该端已部署或全部功能已开放。