将 ONLYOFFICE 文档 Docker 版本更新到最新版本

介绍

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

在更新之前，请确保您的 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

更新 ONLYOFFICE 文档 Docker 版本

使用脚本更新

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

bash docs-install.sh -u true

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

手动更新

步骤 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: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
        

确保您运行新镜像时，文件夹路径的映射完全与之前版本的挂载方式一致，否则这些文件夹中存储的数据将不会被自动识别。为此，请通过替换 /host_folder:/volume 值为它们在步骤 1中显示的实际路径来指定 -v 选项参数。

如果您使用不同的端口或 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}}