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

介绍

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

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

功能

• 文档编辑器
• 电子表格编辑器
• 演示文稿编辑器
• 移动网页查看器
• 移动网页编辑器
• 协作编辑
• 象形文字支持
• 支持所有流行格式：DOC、DOCX、TXT、ODT、RTF、ODP、EPUB、ODS、XLS、XLSX、CSV、PPTX、HTML

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

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

安装 ONLYOFFICE 文档

docker_OPTS="--dns 8.8.8.8"

安装 Docker 后，运行它并执行以下命令：

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

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

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

在容器外存储数据

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

• /var/log/onlyoffice 用于 ONLYOFFICE 文档 日志
• /var/www/onlyoffice/Data 用于证书
• /var/lib/onlyoffice 用于文件缓存
• /var/lib/postgresql 用于数据库

要访问位于容器外的数据，您需要挂载数据卷。这可以通过在 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

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

• 轻松访问容器数据，如日志；
• 移除容器内数据大小的限制；
• 使用在容器外启动的服务，如 PostgreSQL、Redis、RabbitMQ。

使用 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 保护应用程序，基本上需要两件事：

• 私钥 (.key)
• SSL 证书 (.crt)

因此，您需要创建并安装以下文件：

/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

其中：

• LETS_ENCRYPT_DOMAIN - 用于证书的域名。
• LETS_ENCRYPT_MAIL - 用于注册和恢复联系的电子邮件。

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

openssl genrsa -out onlyoffice.key 2048

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

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

openssl dhparam -out dhparam.pem 2048

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

sudo docker restart {{DOCUMENT_SERVER_ID}}

ONLYOFFICE 文档 IPv6 设置

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

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

• 创建 /etc/docker/daemon.json 文件，内容如下：

  {"ipv6": true,"fixed-cidr-v6": "2001:db8:abc1::/64"}

• 使用以下命令重启 Docker：systemctl restart 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

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