OnlyOffice更新需按部署环境选择对应方案：Linux包安装版需运行关机脚本、卸载旧版、执行安装脚本并选升级；Docker版需检查挂载路径、停容器、拉新镜像、复用原卷启动；Windows企业版需运行bat脚本、控制面板卸载、重装新包；Workspace社区版升企业版需备份数据、运行升级脚本、激活license；Web控制面板内更新需先升控制面板，再逐个更新其他组件。
如果您正在运行 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”等模块执行“下载 → 更新”操作；
每个组件更新后，页面将显示“当前版本”与“最新版本”一致。
