跳到主要内容

更新适用于 Docker 的 ONLYOFFICE 文档 开发者版至最新版本

简介​

本指南将向您展示如何将您的 ONLYOFFICE 文档开发者版 Docker 版本更新到最新版本。

备注

我们的支持政策是仅支持最新的稳定版本。我们定期发布新的 ONLYOFFICE 文档版本，其中包含新功能和错误修复。如果您使用的是旧版本的 ONLYOFFICE 文档，我们建议您升级到最新版本。

在更新之前，请确保您的 Docker 版本符合系统要求（任何由 Docker 团队支持的版本）。

关闭 ONLYOFFICE 文档​

由于操作特性，ONLYOFFICE 文档 仅在所有编辑用户关闭文档后才会保存文档。为了避免数据丢失，当需要停止 ONLYOFFICE 文档 进行应用程序更新时，您必须强制断开 ONLYOFFICE 文档 用户。为此，请执行以下脚本：

sudo docker exec <DOCUMENT_SERVER_ID> documentserver-prepare4shutdown.sh

其中 <DOCUMENT_SERVER_ID> 代表 ONLYOFFICE 文档 容器的名称或 ID。

您可以使用 Docker 命令轻松找到当前 ONLYOFFICE 文档 容器的名称或 ID，该命令将列出所有现有容器：

sudo docker ps -a
备注

执行脚本将断开所有用户的连接，最多可能需要 5 分钟。

更新 ONLYOFFICE 文档 Docker 版本​

使用脚本更新​

如果您的 ONLYOFFICE 文档 版本是使用脚本安装的，请执行以下命令：

bash docs-developer-install.sh -u true

输入 Y 并按 Enter 键以使用 Docker 更新 ONLYOFFICE 文档。

备注

ONLYOFFICE 文档 开发者版 Docker 版本将仅在先前使用此脚本安装时通过脚本更新。

手动更新​

步骤 1：检查所有外部数据存储文件夹是否已挂载。

确保用于存储 ONLYOFFICE 文档 数据的所有容器卷已使用以下命令挂载：

sudo docker inspect --format='{{range $p,$conf:=.HostConfig.Binds}}{{$conf}};{{end}}' {{DOCUMENT_SERVER_ID}}

步骤 2： 停止当前的 ONLYOFFICE 文档 Docker 容器。

sudo docker stop {{DOCUMENT_SERVER_ID}}

步骤 3： 下载最新的 ONLYOFFICE 文档 镜像。

下载最新的 ONLYOFFICE 文档 镜像，并指定 latest 标签：

docker pull onlyoffice/documentserver-de:latest

步骤 4： 使用相同的映射路径运行新镜像。

sudo docker run -i -t -d -p 80:80 --restart=always \
    -v /host_folder:/volume \
    -v /host_folder:/volume -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-de

确保您以与之前版本完全相同的文件夹路径映射运行新镜像，否则存储在这些文件夹中的数据将不会被自动拾取。为此，请指定 -v 选项参数，将 /host_folder:/volume 值替换为在步骤 1 中显示的实际路径。

如果您使用不同的端口或 HTTPS 安装了以前的版本，并希望以相同方式安装新版本，请参考安装说明以找到必要的命令。

安装过程结束后，运行 ONLYOFFICE 文档 并检查其是否正常工作。

步骤 5（可选）： 删除旧的 ONLYOFFICE 文档 容器和镜像。

在确保一切正常并且您的更新版本 ONLYOFFICE 文档 正常工作后，您可以删除旧的 ONLYOFFICE 文档 容器：

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

其中 {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} 代表旧的 ONLYOFFICE 文档 容器名称或 ID。

如果您想释放空间，还可以删除旧的镜像。显示所有 docker 镜像：

sudo docker images -a

在镜像列表中找到不需要的镜像 ID 并删除该镜像：

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}
备注

在 v6.3 中，数据库架构已更改。当更新到 v6.3（如果您使用的是带有外部数据库的 ONLYOFFICE 文档 Docker 版本）时，您可能还需要升级数据库架构以确保能够使用密码保护功能。

  1. 在 ONLYOFFICE Docs 容器中找到用于升级数据库架构的脚本。

    • 对于 PostgreSQL：/var/www/onlyoffice/documentserver/server/schema/postgresql/upgrade/upgradev630.sql
    • 对于 MySQL：/var/www/onlyoffice/documentserver/server/schema/mysql/upgrade/upgradev630.sql

  2. 使用命令行执行脚本。

    • 对于 PostgreSQL： psql -U onlyoffice -W onlyoffice < {path-to-upgradev630.sql}
    • 对于 MySQL： mysql -u root -p onlyoffice < {path-to-upgradev630.sql}

    指定创建数据库时使用的密码（onlyoffice）。