一、DocSpace 3.7新功能：支持文件生成&AI 智能体、更智能的表单、房间分组

AI 智能体：从「对话助手」升级为「内容生产引擎」

3.7 里改动最明显的就是 AI 这一层。它不再只是一个回答问题的聊天框，而是真正接进了文档工作流：

• 在 AI 聊天中直接生成文件。可以让智能体产出 DOCX 文档、PDF 表单、PPTX 演示文稿，生成后自动在新标签页打开继续编辑。少掉了「聊天 → 复制 → 粘贴到新文档 → 调格式」这一整段手工动作。

  

• 默认 AI 提供商同步到编辑器。在协作空间的 AI 设置里选好提供商和模型后，编辑器的 AI 插件会自动套用同一套配置，不用再为「协作空间」和「编辑器」各配一遍。
• 新增三家提供商。除原有的 Anthropic、OpenAI、OpenRouter、Together AI 和自定义端点外，新增 DeepSeek、Google AI、xAI，共七家可选。国内环境下 DeepSeek 这类国产模型在可用性和成本上更有优势。

  

• 设置默认提供商与模型。创建智能体时自动带出默认值，不必每次手选。
• 聊天里可以上传图片。把协作空间中的图片直接喂给智能体，用来分析设计稿、读图表数据、识别手写内容。
• 扩展思考（Extended Thinking）。遇到复杂请求时，聊天会展示一段推理过程，方便判断结论是怎么来的。是否出现取决于问题复杂度，不是每次都显示。
• AI 服务总开关。位置在「设置 → 自定义 → 常规 → AI 服务管理」，可一次性开关协作空间与编辑器中的 AI 能力。关闭后 AI 设置和智能体入口隐藏，但历史聊天记录会保留，重新打开即恢复。这个开关对分阶段上线、合规审查场景很实用。

表单填写房间：从数据收集到系统对接

表单填写房间是这次更新幅度最大的模块之一，核心思路是把它从「收集数据的表格」升级成「能对接业务系统的数据管道」：

• 表单结果可导出到外部数据库。回复默认仍会汇总到电子表格；现在还能直接推到外部库。配置路径「设置 → 集成 → 第三方服务」，配置完成后在房间设置里勾选「导出结果到数据库」。这意味着表单数据能直接落到自家 CRM、ERP 或其他业务库里，而不是停在一个 xlsx 文件上。

  

• 在房间内直接创建和编辑 PDF 表单。以前只能从设备上传现成表单，或从模板库挑一个；现在可在房间内新建。「表单填写房间 → 操作 → PDF 表单 → 空白 / 从文本文件」。

  

• 新增「开始填写」流程。表单要先通过 开始填写 切到填写模式（入口在文件右键菜单或编辑器顶部工具栏），切好之后房间内所有人都能填。设计意图是把「编辑表单」和「填写表单」两个阶段的权限彻底分开：编辑模式下除「表单填写者」外所有成员都能改表单；填写模式下再选编辑会弹出警告，因为表单会退出填写模式并对该角色隐藏。
• 「将回复同步到 XLSX」。一键刷新那张汇总回复的表格，让导出的快照保持最新。

编辑器升级：内置 ONLYOFFICE 文档 9.4

协作空间 3.7 打包的是文档 9.4，编辑器层面同步获得了这些能力：

推荐阅读：ONLYOFFICE 9.4新功能：社区版优化，取消连接数限制，新幻灯片主题与切换

文件与房间管理改进

• 替换默认文档模板。在「设置 → 自定义 → 默认模板」里换掉新建文档时使用的底版，适合放公司统一格式的公文、合同、汇报模板。

  

• 房间分组。把房间归类到自定义分组里，组标签会显示在搜索框下方；同时支持一次删除多个房间。

  

• 房间标签更好管。标签的添加、删除、修改更快，筛选时还能按所有者单独搜索。

  

• 细节优化。历史信息面板会显示所有者变更详情；可选择协作空间默认打开的板块；支持快捷键呼出右键菜单；文档模板库重新设计；备份过程可以中途停止；被阻止的用户不再出现在选择器里；手机端滚动时标题保持固定；支持通过 Nextcloud 登录协作空间。

安全增强

禁止外部链接：管理员可整体禁止创建外部链接，防止敏感内容被生成公开地址后外流。路径：设置 → 安全性 → 协作空间访问

邀请链接限额：可限制通过邀请链接加入的人数，以及链接的有效时长。路径：联系人 → 通过链接邀请 → 链接设置

3.7 还调整了许可条款：代码本身仍是 AGPLv3，附加条款主要强调三点——保留归属与版权声明、明确标注修改过的版本、许可以外不授予 ONLYOFFICE 商标使用权。

二、部署方式怎么选：轻量版 vs 完整版

从 3.7 开始，自托管有两个官方形态。它们不是互相替代的关系，而是对应两种不同用途：

三、Docker 文件编排结构

四、离线完整版部署实战（二选一）

如果无法拉取镜像，或者拉取镜像一直断开，可以选择离线部署。

硬件与系统要求

第一步：导入 Docker 镜像

上传所有docker镜像包，这里以上传到/opt/docspace为例

脚本会依次 docker load 全部镜像，镜像数量较多，耗时取决于磁盘速度，耐心等到跑完。

第二步：创建数据存储目录（永久储存）

数据存储目录为 /opt/docspace/data

# 把配置目录放到约定的位置（示例）
cd /opt/docspace
mkdir -p data/app_data data/ds_fonts data/log_data data/mysql_data data/os_data
chmod -R 777 /opt/docspace/data/
# 创建配置文件并下载配置文件
sudo mkdir -p /opt/docspace/config && cd /opt/docspace/config
# 下载yml配置文件
curl -L https://yun.ittel.cn:1443/f/c583980ca45a4f41aa57/?dl=1|bash

配置其他数据目录可以在.env文件中修改

可能需要修改的配置项

第三步：启动

脚本会按「基础设施 → 数据迁移 → 业务服务 → 接入层」的顺序依次拉起容器。启动过程中可以另开一个终端观察：

第四步：初始化协作空间

浏览器打开 http://服务器IP:8091（默认对外端口）。

首次访问确实比较慢，页面可能要等较久才出来。这不是卡死，是后台在建库、建索引、生成配置。配置越高，等待越短——这也是官方把「最低8C、16 GB 内存」的原因（无欢不爱测试20分钟，8C 16G笔记本）。

# 查看是否启动，等待都为healthy
docker ps | grep onlyoffice

初始化完成后：填写管理员的 Email 与 Password（密码长度一般要求 8–30 位），选择语言与时区，接受许可协议，然后点继续。

初始化完成后用刚才的邮箱密码登录，就可以开始建房间、拉人协作了。如果发现打开偏慢（说明配置太低）

支持多人协作在线编辑

也支持部署自定义插件

第五步：停止与彻底清理

五、官方在线一键脚本部署（二选一）

如果服务器能联外网，用官方脚本会更省事——支持在线拉镜像、自动配 HTTPS、参数化安装，升级也方便。

5.1 下载并运行

脚本会先拉取配置到 /app/onlyoffice，然后按层级启动整套容器。中途如果没指定安装方式，它会交互式询问：按 Y 走 Docker，按 N 走 DEB/RPM。安装完成后访问 http://服务器IP，同样填写邮箱、密码、许可协议即可。

5.2 常用参数速查

查看全部参数：bash docspace-enterprise-install.sh docker -h。下面挑最常用的整理成表，按需组合即可。

5.3 开启 HTTPS

两种方式，二选一。Let’s Encrypt 自动签发：

或者用自有证书（–certfile 证书路径 + –certkeyfile 私钥路径）：

离线包对应的就是 proxy-ssl.yml：它把 proxy 的 80 与 443（含 UDP 443 的 HTTP/3）一起暴露，Nginx 侧启用 TLS 1.2/1.3、HSTS，并把 HTTP 请求 301 跳转到 HTTPS。使用时需要先在 .env 里填好三个路径：

然后把启动脚本里的 proxy.yml 换成 proxy-ssl.yml，重启一次即可：

六、备份与数据目录详解

推荐备份直接整个/opt/docspace，里面包含如下数据：

• 数据库。导出 MySQL 中的 docspace 库；这是元数据（用户、房间、权限、文档索引）的核心。
• 文件与卷。备份 app_data（文件实体与配置）、mysql_data、os_data（索引，非必选但建议）。
• 配置文件。 .env——里面是随机生成的密钥，丢了会导致旧数据无法解密。

数据目录详解

包里一共有 5 个卷受 VOLUMES_DIR 影响，分别来自不同 yml：