ONLYOFFICE Docs 9.4 刚发布,这次更新有两件事值得注意:一是许可证条款变得更严格、更明确,对分发和修改提出了更多要求;二是演示文稿模块终于补上了幻灯片主题和切换效果这块短板。如果你在自部署 ONLYOFFICE,许可证变化直接影响你的合规义务,需要认真对待。
许可证变了,不只是措辞调整
9.4 版本明确将许可定在 GNU Affero 通用公共许可证 v3.0(AGPLv3),并附加了额外条款。AGPLv3 本身就比 GPL 更"激进"——通过网络提供服务也必须开放源码,这意味着你把 ONLYOFFICE Docs 挂在内网给团队用,修改过的版本同样要对使用者提供源码。
附加条款的重点有三:
- 归属要求:分发时必须保留原始版权声明和归属信息,不能抹掉 ONLYOFFICE 的名字。
- 修改标记:对源码做了改动,必须在显著位置标明你改了什么、改了哪里,不能假装是原版。
- 分发合规:所有副本和分发中必须包含这些附加条款,不能只贴 AGPLv3 就完事。
如果你只是内部部署、不改源码,影响不大——照用就行。但如果你 fork 了 ONLYOFFICE 做二次开发、嵌入自家产品再分发,这些附加条款就是硬性约束,违反的后果和违反 AGPLv3 本身一样严重。
演示文稿模块补课:主题与切换效果
之前 ONLYOFFICE 的演示文稿功能一直被吐槽"太朴素"——没有内置主题模板,幻灯片切换也只有基础选项。9.4 终于在这两方面做了补强:
- 新幻灯片主题:内置了一批预设主题,涵盖配色、字体、背景样式,新建演示文稿时可以直接选取,不用从空白页一点点调。
- 切换效果:新增了淡入、推入、翻转等常见过渡动画,在"切换"面板里选择后可应用到单张或全部幻灯片,并支持设置切换时长和触发方式。
这些功能在 Google Slides 和 PowerPoint 里早就有了,ONLYOFFICE 补上之后,至少在做内部汇报、技术分享时不用再手动调样式了。
自部署 ONLYOFFICE Docs 的快速上手
如果你打算在自己的服务器上跑 ONLYOFFICE Docs 9.4,最省事的方式还是 Docker。下面是一个可以直接用的 Docker Compose 配置,把文档服务器和示例前端一起拉起来:
# docker-compose.yml — 仅用于测试/开发,生产环境需加 HTTPS 与持久化
version: "3.8"
services:
onlyoffice-documentserver:
image: onlyoffice/documentserver:9.4.0
container_name: onlyoffice-ds
restart: unless-stopped
ports:
- "8080:80"
environment:
# 关闭 JWT 以便快速测试;生产环境务必启用并设强密钥
- JWT_ENABLED=false
volumes:
# 持久化数据目录,升级时不丢文档缓存
- onlyoffice_data:/var/lib/onlyoffice
- onlyoffice_logs:/var/log/onlyoffice
# 自定义字体(可选):把字体文件放进宿主机目录即可生效
- ./custom-fonts:/usr/share/fonts/truetype/custom
onlyoffice-example:
image: onlyoffice/documentserver-integrationexample:latest
container_name: onlyoffice-example
restart: unless-stopped
ports:
- "8081:80"
environment:
- DOCUMENT_SERVER_URL=http://onlyoffice-ds
volumes:
onlyoffice_data:
onlyoffice_logs:
启动命令:
# 拉起服务
docker compose up -d
# 等约 60 秒让内部服务初始化完成,然后访问测试页面
curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/healthcheck
# 返回 200 即表示文档服务器就绪
# 打开浏览器访问 http://localhost:8081 可看到集成示例编辑器
# 在演示文稿模块中新建一个幻灯片,即可体验新主题和切换效果
生产部署注意点:
JWT_ENABLED=false只适合本地验证,上线前必须改为true并设置JWT_SECRET,否则任何人都能调用你的文档编辑 API。- 只暴露文档服务器端口而不暴露示例端口,示例容器仅用于验证集成逻辑。
- 如果需要 HTTPS,在前面加一层 Nginx 反代,或者直接在 ONLYOFFICE 容器内配置证书(官方文档有详细步骤)。
合规检查清单
许可证变化意味着自部署用户也需要做一次合规自查,尤其是有二次开发场景的团队:
| 检查项 | 说明 |
|---|---|
| 版权声明保留 | 部署页面、分发包中是否保留了 ONLYOFFICE 原始版权声明 |
| 修改标记 | 如果改过源码,是否在代码和界面上标注了修改内容 |
| 附加条款分发 | 是否在项目仓库或分发介质中包含了 AGPLv3 + 附加条款的完整文本 |
| 源码可获取 | 如果通过网络(含内网)提供修改版服务,使用者是否能获取对应源码 |
| JWT 与安全配置 | 生产环境是否启用了 JWT 并设置了足够强度的密钥 |
最后一项虽不是许可证要求,但和合规部署直接相关——一个裸奔的文档编辑服务,合规做得再好也是安全隐患。
写在最后
9.4 的许可证收紧对纯使用者影响有限,但对二次开发和再分发的团队提出了更明确的义务。演示文稿的新主题和切换效果则是一个实用补强,让 ONLYOFFICE 在日常办公场景里不再明显弱于主流竞品。如果你已经在自部署 ONLYOFFICE,升级到 9.4 本身没有技术障碍,但升级后务必做一次许可证合规自查——附加条款不是建议,是约束。