OnlyOffice版本更新与升级教程

OnlyOffice版本更新是保障系统安全、功能完整与兼容性的关键操作，但不同部署环境（Linux包安装、Docker、Windows企业版、Workspace社区版升企业版、Web控制面板）需严格遵循对应升级路径——从执行关机准备脚本、精准卸载旧组件、复用数据卷启动新镜像，到备份数据、运行专用升级脚本及激活License，每一步都直接影响升级成败与业务连续性；无论您使用哪种部署方式，及时、规范地完成更新，不仅能规避已知安全漏洞和功能缺失风险，还能无缝解锁OnlyOffice最新协作能力与性能优化。

如果您正在运行 OnlyOffice 文档服务器或 Workspace 平台，但当前版本已过时，可能面临功能缺失、安全漏洞或兼容性问题。以下是针对不同部署环境的更新操作步骤：

一、更新 Linux 上的 ONLYOFFICE 文档服务器（DEB/RPM 包安装）

该方法适用于通过 apt 或 yum 安装的 standalone 文档服务器（非 Docker 版），且当前版本为 4.1 或更高。由于 4.1 起数据库后端已切换至 PostgreSQL，此流程不兼容 MySQL 旧版集成版。

1、执行强制用户断开脚本以确保数据完整：
运行 documentserver-prepare4shutdown.sh，等待脚本执行完成（最长需 5 分钟）。

2、卸载旧版集成版（仅限使用 onlyoffice-documentserver-ie 的用户）：
Ubuntu 系统执行 sudo apt-get remove onlyoffice-documentserver-ie；
CentOS 系统执行 sudo yum remove onlyoffice-documentserver-ie。

3、下载并运行安装脚本：
执行 curl -O http://download.onlyoffice.com/docs/docs-install.sh；
随后运行 bash docs-install.sh -u true；
当提示输入 Y/N 时，输入 N 并按 Enter，选择从现有 DEB/RPM 包升级而非全新安装。

二、更新 Docker 部署的 ONLYOFFICE 文档服务器

该方法适用于以容器方式运行的文档服务器，包括标准版、企业版（documentserver-ee）及开发者版（documentserver-de），核心是镜像替换与卷挂载一致性保障。

1、检查外部数据卷挂载路径：
执行 sudo docker inspect --format='{{range $p,$conf:=.HostConfig.Binds}}{{$conf}};{{end}}' {{DOCUMENT_SERVER_ID}}，记录所有 /host_folder:/volume 类似映射路径。

2、停止当前容器：
执行 sudo docker stop {{DOCUMENT_SERVER_ID}}。

3、拉取对应新版镜像：
标准版：执行 docker pull onlyoffice/documentserver:latest；
企业版：执行 docker pull onlyoffice/documentserver-ee:latest；
开发者版：执行 docker pull onlyoffice/documentserver-de:latest。

4、启动新容器并严格复用原挂载路径：
例如标准版启动命令为：
sudo docker run -i -t -d -p 80:80 --restart=always -v /your/host/data:/volume -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver:latest；
必须将 /your/host/data 替换为步骤 1 中确认的实际路径，否则数据不可见。

三、更新 Windows 上的 ONLYOFFICE 文档服务器企业版

该方法专用于原生 Windows 安装的企业版，依赖批处理脚本终止服务与控制面板卸载机制，避免进程占用导致更新失败。

1、运行关机准备脚本：
以管理员身份执行 "C:\Program Files\ONLYOFFICE\DocumentServer\bin\documentserver-prepare4shutdown.bat"，全程等待至命令行退出（最长 5 分钟）。

2、卸载旧版本：
打开“控制面板 → 程序和功能”，在程序列表中找到 ONLYOFFICE Document Server Enterprise Edition，右键选择“卸载”。

3、安装新版：
下载 onlyoffice-documentserver-ee.exe 安装包；
双击运行，按向导提示完成安装，保留原有配置路径选项。

四、更新 ONLYOFFICE Workspace（Linux 社区版升级企业版）

该方法实现从社区版到企业版的平滑迁移，利用共享数据目录 /var/www/onlyoffice/Data 实现用户与文档数据继承，无需重新导入。

1、备份门户数据（可选但强烈建议）：
执行 sudo cp -r /var/www/onlyoffice/Data /var/www/onlyoffice/Data.backup。

2、执行升级脚本：
Debian/Ubuntu 系统执行：
wget https://download.onlyoffice.com/install/install-Debian.sh && bash install-Debian.sh -it workspace_enterprise -u true；
RedHat/CentOS 系统执行：
wget https://download.onlyoffice.com/install/install-RedHat.sh && bash install-RedHat.sh -it workspace_enterprise -u true。

3、激活许可证：
启动服务后，访问 https://your-domain/controlpanel/activate，上传购买的企业版 license.key 文件并点击“激活”。

五、更新 ONLYOFFICE Workspace（Web 控制面板内升级）

该方法适用于已启用控制面板更新功能的 Workspace 部署，支持组件级增量更新，要求控制面板本身为最新版优先更新。

1、登录控制面板：
进入左侧边栏“常用设置 → 更新”页面，查看各组件状态与可用版本号。

2、优先更新控制面板：
若控制面板显示有更新，点击其右侧“下载”按钮；
下载完成后点击“更新”按钮，等待重启完成。

3、逐个更新其余组件：
控制面板更新成功后，依次对“Community Server”、“Mail Server”等模块执行“下载 → 更新”操作；
每个组件更新后，页面将显示“当前版本”与“最新版本”一致。

以上就是《OnlyOffice版本更新与升级教程》的详细内容，更多关于OnlyOffice的资料请关注golang学习网公众号！