Dhorde 庚乾

安装适用于 Docker 的 ONLYOFFICE 文档企业版

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

本页目录

介绍

企业版允许您在本地服务器上安装 ONLYOFFICE 文档,并将在线编辑器与 ONLYOFFICE 协作平台或其他流行系统集成。

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

功能

查看详细功能列表,适用于 ONLYOFFICE 文档 企业版。

在 ONLYOFFICE Workspace 中使用它,您可以:

本指南将向您展示如何在您的机器上安装 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-ee
重要

从版本 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-ee

其中 <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-ee
备注

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

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

使用 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-ee

可以使用 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-ee

其中:

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-ee

之后,您的企业版版本将被注册并具有完整功能。

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

返回Docker 版本目录