Dhorde 庚乾

在本地服务器上安装 ONLYOFFICE 文档的 Docker 版本

ONLYOFFICE 帮助中心中文文档 · 庚乾获授权转载 · 同步于 2026 年 11 月 6 日

本页目录

介绍

开发者版允许您在本地服务器上安装 ONLYOFFICE 文档,并将在线编辑器与您的 Web 应用程序集成。

ONLYOFFICE 文档是一套在线办公套件,包括文本、电子表格和演示文稿的查看器和编辑器,完全兼容 Office Open XML 格式:.docx、.xlsx、.pptx,并支持实时协作编辑。

功能

查看详细功能列表,适用于 ONLYOFFICE 文档 开发者版。

本指南将向您展示如何在您的机器上安装 ONLYOFFICE 文档 开发者版的 Docker 版本。

系统要求

安装 ONLYOFFICE 文档

备注

您需要安装最新版本的 Docker。如果尚未安装,请参阅 Docker 网站上的安装部分以了解如何获取。

备注

Docker 默认指定 Google DNS 服务器。如果您的 ONLYOFFICE 文档无法访问互联网,我们建议您将默认的 Docker DNS 地址更改为本地 DNS 服务器的地址。为此,请转到 /etc/default/docker 文件并将以下行中的 IP 地址更改为本地网络中 DNS 服务器的 IP 地址:

docker_OPTS="--dns 8.8.8.8"

对于基于 RPM 的操作系统,如 CentOS:

  1. 创建 /etc/docker/daemon.json 配置文件,内容如下:

    { "dns" : [ "8.8.8.8" ] }
  2. 重启 Docker 服务:

    sudo systemctl restart docker.service

安装 Docker 后,运行它并执行以下命令:

sudo docker run -i -t -d -p 80:80 --restart=always -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-de
重要

从版本 7.2 开始,我们添加了 JWT 密钥的随机生成。如果未通过环境变量指定 JWT 密钥,则每次虚拟机或物理服务器重启时都会重新生成,从而可能导致集成问题。为避免此问题,请在 -e JWT_SECRET=my_jwt_secret 中指定您自己的值。

如果您不打算在安装中使用 JWT,请使用 -e JWT_ENABLED=false。

备注

默认情况下,ONLYOFFICE 文档使用端口 80 监听传入连接。从版本 4.3 开始,如果您计划使用其他端口而不是默认端口,可以在安装过程中更改映射端口来轻松实现:

sudo docker run -i -t -d -p <PORT_NUMBER>:80 --restart=always -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-de

其中 <PORT_NUMBER> 是您希望 ONLYOFFICE 文档 使用的端口号。

这将安装 ONLYOFFICE 文档及其所需的所有依赖项(脚本执行的操作列表可以在这里找到)。

重要

该镜像与 Kubernetes 安装不兼容。有关在 Kubernetes 上获取 ONLYOFFICE 文档的更多信息,请参阅以下指南。

在容器外存储数据

所有数据都存储在专门指定的目录中,称为数据卷,位置如下:

我们建议

我们强烈建议您将数据存储在 Docker 容器外的主机机器上,这样可以在新版本发布时轻松更新 ONLYOFFICE 文档 而不会丢失数据。

要访问位于容器外的数据,您需要挂载数据卷。这可以通过在 docker run 命令中指定 -v 选项来完成。

sudo docker run -i -t -d -p 80:80 --restart=always \
    -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  \
    -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
    -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-de
备注

请注意,如果您尝试挂载尚未创建的文件夹,这些文件夹将被创建,但访问权限将受到限制。您需要手动更改其访问权限。

通常,您不需要存储容器数据,因为容器操作不依赖于其状态。保存数据将有助于:

使用 HTTPS 运行 ONLYOFFICE 文档

sudo docker run -i -t -d -p 443:443 --restart=always \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-de

可以使用 SSL 保护对 onlyoffice 应用程序的访问,以防止未经授权的访问。虽然 CA 认证的 SSL 证书允许通过 CA 验证信任,但只要每个客户端采取一些额外步骤来验证您网站的身份,自签名证书也可以提供相同级别的信任验证。以下提供了实现此目标的说明。

要通过 SSL 保护应用程序,基本上需要两件事:

因此,您需要创建并安装以下文件:

/app/onlyoffice/DocumentServer/data/certs/onlyoffice.key
/app/onlyoffice/DocumentServer/data/certs/onlyoffice.crt

使用 CA 认证的证书(例如,Let's Encrypt)时,这些文件由 CA 提供。如果您使用自签名证书,则需要自行生成这些文件。

使用 certbot 将 ONLYOFFICE 文档切换到 HTTPS

将 ONLYOFFICE 文档 切换到 HTTPS 的最简单方法是使用 certbot 自动获取 Let's Encrypt SSL 证书。

运行 ONLYOFFICE 文档 Docker 容器,指定端口 80 和 443,并为变量设置您自己的值:

sudo docker run -i -t -d -p 80:80 -p 443:443 --restart=always \
    -e LETS_ENCRYPT_DOMAIN=yourdomain.com -e LETS_ENCRYPT_MAIL=email@example.com -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-de

其中:

letsencrypt.org CA 签名的证书将自动生成并安装到您的服务器。现在,您的 ONLYOFFICE 文档 应该可以在 https://yourdomain.com 地址访问。

生成自签名证书

生成自签名 SSL 证书涉及简单的三步程序:

步骤 1:创建服务器私钥

openssl genrsa -out onlyoffice.key 2048

步骤 2:创建证书签名请求 (CSR)

openssl req -new -key onlyoffice.key -out onlyoffice.csr

步骤 3:使用私钥和 CSR 签署证书

openssl x509 -req -days 365 -in onlyoffice.csr -signkey onlyoffice.key -out onlyoffice.crt

您现在已生成一个有效期为 365 天的 SSL 证书。

加强服务器安全性

本节为您提供加强服务器安全性的说明。

为此,您需要生成更强的 DHE 参数。

openssl dhparam -out dhparam.pem 2048

安装 SSL 证书

在上面生成的四个文件中,您需要在 onlyoffice 服务器上安装 onlyoffice.key、onlyoffice.crt 和 dhparam.pem 文件。CSR 文件不需要,但请确保安全备份该文件(以防您以后需要再次使用)。

onlyoffice 应用程序默认配置为在 /var/www/onlyoffice/Data/certs 路径查找 SSL 证书,不过可以使用 SSL_KEY_PATH、SSL_CERTIFICATE_PATH 和 SSL_DHPARAM_PATH 配置选项更改此路径。

/var/www/onlyoffice/Data/ 路径是数据存储路径,这意味着您必须在 /app/onlyoffice/DocumentServer/data/ 内创建一个名为 certs 的文件夹,并将文件复制到其中,作为安全措施,您将更新 onlyoffice.key 文件的权限,使其仅对所有者可读。

mkdir -p /app/onlyoffice/DocumentServer/data/certs
cp onlyoffice.key /app/onlyoffice/DocumentServer/data/certs/
cp onlyoffice.crt /app/onlyoffice/DocumentServer/data/certs/
cp dhparam.pem /app/onlyoffice/DocumentServer/data/certs/
chmod 400 /app/onlyoffice/DocumentServer/data/certs/onlyoffice.key

然后重启 Docker 容器:

sudo docker restart {{DOCUMENT_SERVER_ID}}

您现在只需一步即可确保我们的应用程序安全。

可用的配置参数

备注

请参阅 docker run 命令选项中的 --env-file 标志,您可以在单个文件中指定所有必需的环境变量。这将使您免于编写可能很长的 docker run 命令。

以下是可以使用环境变量设置的参数的完整列表。

ONLYOFFICE 文档 IPv6 设置

备注

仅适用于 Linux 主机并受支持

Docker 目前默认不为容器提供 IPv6 地址。此功能现在是实验性的。

要设置通过 IPv6 的交互,您需要在 Docker 中启用对此功能的支持。为此,您需要:

之后,所有运行中的容器都会收到一个 IPv6 地址并拥有一个 inet6 接口。

您可以检查默认桥接网络,并在其中看到 EnableIPv6=true 字段。还将添加一个新的 IPv6 子网。

有关更多信息,请访问官方 Docker 手册网站。

注册您的开发者版版本

如果您购买了 开发者版 并收到了 license.lic 文件,您可以将其放置到您的安装中以获得软件的完整版本。

当您使用 Docker 容器时,可以将 license.lic 文件放置到任何文件夹(例如,/app/onlyoffice/DocumentServer/data/license.lic),但您需要在容器启动时挂载此文件夹:

sudo docker run -i -t -d -p 80:80 --restart=always \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
-e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-de

之后,您的开发者版将注册并具有完整功能。

原文与配图来自 ONLYOFFICE 帮助中心,著作权归原权利人。本站调整了页面排版和章节链接。查看官方原文

返回Docker 版本目录