原文链接https://www.ittel.cn/archives/70853.html 。原创作品转载请保留出处。完整版 30 容器与轻量版单容器双方案 · AI 智能体与表单房间新能力全解析 · 含端口最小化加固与数据盘外挂配置DocSpace 3.7.2.1编辑器 Docs 9.4.0.130 微服务容器x86_64AGPLv3ONLYOFFICE 协作空间DocSpace是一个以「房间」为中心的文档协作平台把用户和文档按项目、部门、场景集中到一个个房间里再用角色和权限控制谁能看、谁能改、谁能填表。它自带完整的在线文档编辑器文档 / 表格 / 幻灯片 / PDF 表单支持多人实时协同编辑、评论与审阅既可以装在自己的服务器上也能用官方云。本文以3.7.2 离线部署完整版为主线先梳理 3.7 系列带来的新功能再讲清「轻量版单容器」和「完整版多容器」该怎么选然后给出部署步骤最后是端口最小化暴露加固、数据盘外挂、排查、升级、备份、卸载的完整清单。一、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 开始自托管有两个官方形态。它们不是互相替代的关系而是对应两种不同用途对比项轻量版单容器完整版多容器容器数量4 个30 个构成docspace所有服务合并 document-server mysql opensearch按微服务拆分api、studio、files、socket、identity、mcp、ai、router、proxy 等 独立中间件适用场景试用、演示、功能评估生产环境、团队使用典型内存较低 5 GB 就跑起来的迷你版12 GB 起步16 GB 更稳缩略图生成不支持支持横向扩容仅单机组件可分散到多台服务器可维护性单容器打包排查粒度较粗组件可独立升级、独立重启三、Docker 文件编排结构yml 文件启动内容所属层次opensearch.ymlonlyoffice-opensearch全文搜索基础设施db.ymlonlyoffice-mysql-server数据库基础设施rabbitmq.ymlonlyoffice-rabbitmq消息队列基础设施redis.ymlonlyoffice-redis缓存基础设施fluent.ymlfluent-bit日志采集基础设施dashboards.ymlopensearch-dashboards日志可视化基础设施migration-runner.ymlmigration-runner建表 / 改表跑完即退数据迁移ds.ymlonlyoffice-document-server在线编辑器业务服务docspace.ymlapi、studio、files、socket、identity、ai、mcp、router 等全部业务微服务业务服务identity.ymlidentity-authorization、identity-api认证授权业务服务notify.ymlonlyoffice-notify通知业务服务healthchecks.ymlonlyoffice-health-checks-ui健康检查业务服务proxy.ymlonlyoffice-proxy对外 Nginx 入口接入层四、离线完整版部署实战二选一如果无法拉取镜像或者拉取镜像一直断开可以选择离线部署。硬件与系统要求CPU8 核起步12 核更佳内存16 GB 起步24 GB 更佳OpenSearch 单节点默认就吃 4 GB 堆内存磁盘50 GB 起步操作系统干净的 Linux 发行版Ubuntu 20.04/22.04、CentOS / Alma / Rocky 等内核 4.10 以上也可部署在群晖等 NAS 的容器环境DockerDocker 20 与 Compose 插件用docker compose新语法端口占用对外只有 1 个本项目8091默认 80。其余端口均为容器内部通信不占宿主机调试需要额外放开端口如数据库、OpenSearch 等详见「附录常见问题排查」提示如果只是本机验证可以先确认 Docker 是否已安装——docker -v能输出版本号即可。没装的话Ubuntu / Debian 系可直接用curl -fsSL https://get.docker.com | shCentOS 系用yum install -y docker-ce docker-compose-plugin配置好国内镜像加速后再继续。第一步导入 Docker上传所有docker镜像包这里以上传到/opt/docspace为例# 离线镜像先上传这里上传到/opt/docspace/dockercd/opt/docspace/dockercurl -L https://yun.ittel.cn:1443/f/60bcd573a684438aae2a/?dl1|bash脚本会依次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/?dl1|bash配置其他数据目录可以在.env文件中修改可能需要修改的配置项配置项作用本包状态VOLUMES_DIR数据卷存放位置默认为 /opt/docspace/data部署前建出该目录想换路径须修改EXTERNAL_PORT对外访问端口默认设为8091改端口修改这里第三步启动下载配置文件# 切换到配置目录并启动cd /opt/docspace/config/# 启动全部容器sudo bash docker-compose-up.sh脚本会按「基础设施 → 数据迁移 → 业务服务 → 接入层」的顺序依次拉起容器。启动过程中可以另开一个终端观察# 查看容器状态docker ps | grep onlyoffice第四步初始化协作空间浏览器打开http://服务器IP:8091默认对外端口。首次访问确实比较慢页面可能要等较久才出来。这不是卡死是后台在建库、建索引、生成配置。配置越高等待越短——这也是官方把「最低8C、16 GB 内存」的原因无欢不爱测试20分钟8C 16G笔记本。# 查看是否启动等待都为healthy docker ps | grep onlyoffice初始化完成后填写管理员的Email 与 Password密码长度一般要求 8–30 位选择语言与时区接受许可协议然后点继续。初始化完成后用刚才的邮箱密码登录就可以开始建房间、拉人协作了。如果发现打开偏慢说明配置太低支持多人协作在线编辑也支持部署自定义插件第五步停止与彻底清理# 正常停止sudo bash /opt/docspace/config/docker-compose-down.sh# 删除数据rm -rvf /opt/docspace # 全部删除rm -rvf /opt/docspace/data # 只删除数据重新安装五、官方在线一键脚本部署二选一如果服务器能联外网用官方脚本会更省事——支持在线拉镜像、自动配 HTTPS、参数化安装升级也方便。5.1 并运行# 下载安装脚本所有操作需 root 权限curl -O https://download.onlyoffice.com/docspace/docspace-enterprise-install.sh# 用 Docker 方式安装推荐bash docspace-enterprise-install.sh docker# 或用 DEB/RPM 软件包方式安装bash docspace-enterprise-install.sh package脚本会先拉取配置到/app/onlyoffice然后按层级启动整套容器。中途如果没指定安装方式它会交互式询问按Y走 Docker按N走 DEB/RPM。安装完成后访问http://服务器IP同样填写邮箱、密码、许可协议即可。用 DEB/RPM 方式安装时端口可以通过 debconf 预设echo “docspace docspace/port string 80” | debconf-set-selections。5.2 常用参数速查查看全部参数bash docspace-enterprise-install.sh docker -h。下面挑最常用的整理成表按需组合即可。用途参数示例 / 说明安装类型-itcommunity | developer | enterprise默认 enterprise。装社区版-it community外部端口-ep默认 80。-ep 8080改成 8080跳过硬件检查-skiphc-skiphc true配置偏低时强行安装不建议生产用组件更新-u-u true升级已有组件数据自动迁移指定版本-dsv/-docsv协作空间版本 / 文档服务版本。装文档服务 7.2.1.34-docsv 7.2.1.34安装或跳过组件-ids -idocs -irbt -irds -imysql分别对应协作空间 / 文档服务 / RabbitMQ / Redis / MySQLfalse表示跳过。只装文档服务-ids false -idocs true -imysql false -irbt false -irds false指定主机-dsh/-esh协作空间主机 / Elasticsearch(OpenSearch) 主机用于多机分布式。连独立搜索机-esh 192.168.3.202machinekey-mk自定义 core.machinekey写入/app/onlyoffice/config/appsettings.jsonJWT-jh/-jsJWT 头信息 / 密钥。自定义密钥-js yoursecretMySQL root 密码-mysqlrp-mysqlrp new-secret-pw数据库名/用户/密码-mysqld -mysqlu -mysqlp-mysqld docspacedatabase -mysqlu username -mysqlp password数据卷外挂目录-vd把数据卷挂到指定数据盘需绝对路径且目录预先存在。详见第六章「数据目录详解」-vd /opt/docspace/data镜像仓库凭证-reg -un -p拉私有/测试仓库镜像时使用5.3 开启 HTTPS两种方式二选一。Let’s Encrypt 自动签发bash docspace-enterprise-install.sh docker \–letsencryptmail userexample.com \–letsencryptdomain yourdomain.com或者用自有证书–certfile证书路径 –certkeyfile私钥路径bash docspace-enterprise-install.sh docker \–certfile /path/tls.crt –certkeyfile /path/tls.key离线包对应的就是proxy-ssl.yml它把 proxy 的 80 与 443含 UDP 443 的 HTTP/3一起暴露Nginx 侧启用 TLS 1.2/1.3、HSTS并把 HTTP 请求 301 跳转到 HTTPS。使用时需要先在.env里填好三个路径CERTIFICATE_PATH”/path/tls.crt”CERTIFICATE_KEY_PATH”/path/tls.key”DHPARAM_PATH”/path/dhparam.pem”然后把启动脚本里的proxy.yml换成proxy-ssl.yml重启一次即可# 编辑启动脚本把这一行docker compose -f /opt/docspace/config/proxy.yml up -d# 改为docker compose -f /opt/docspace/config/proxy-ssl.yml up -d# 重启生效cd /opt/docspace/configsudo bash docker-compose-down.shsudo bash docker-compose-up.sh六、备份与数据目录详解推荐备份直接整个/opt/docspace里面包含如下数据数据库。导出 MySQL 中的docspace库这是元数据用户、房间、权限、文档索引的核心。文件与卷。备份app_data文件实体与配置、mysql_data、os_data索引非必选但建议。配置文件。.env——里面是随机生成的密钥丢了会导致旧数据无法解密。懒人做法协作空间内置了备份与恢复功能也可以在管理界面配置自动备份。数据目录详解包里一共有 5 个卷受 VOLUMES_DIR 影响分别来自不同 yml目录容器内路径存的是什么定义文件app_data/app/onlyoffice/data文档实体与程序配置最核心docspace.yml、notify.yml、healthchecks.ymlmysql_data/var/lib/mysql数据库全部数据用户、房间、权限等元数据db.ymlos_data/usr/share/opensearch/dataOpenSearch 搜索索引opensearch.ymllog_data/var/log/onlyoffice、/var/log/nginx各服务日志、Nginx 访问日志docspace.yml、identity.yml、fluent.yml、proxy.yml 等ds_fonts/usr/share/fonts编辑器字体库挂出来后加中文字体很方便ds.yml⚠️ 温馨提示协作空间完整版对资源要求不低建议最少 8 核 16 GB配置不足时初始化会明显变慢OpenSearch 也容易被系统 OOM 杀掉。日常备份只需打包/opt/docspace一个目录换机器时挂上同一块盘、路径保持一致即可直接接续使用。
