本文由AI翻译

在麒麟操作系统上安装 ONLYOFFICE 文档的 Docker 版本

简介

开发者版允许您在本地服务器上安装ONLYOFFICE 文档，并将在线编辑器与您的 Web 应用程序、ONLYOFFICE 协作平台或其他流行系统集成。

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

功能

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

查看ONLYOFFICE 文档开发者版的详细功能列表。

在ONLYOFFICE 协作空间中使用时，您可以：

共享文件；
管理文档的访问权限；
将文档嵌入到网站中；
查看和编辑存储在连接到 ONLYOFFICE 的 Drive、Box、Dropbox、OneDrive、OwnCloud 中的文件。

从 v7.2 开始，ONLYOFFICE 文档的 Docker 镜像已重新设计以在麒麟 Linux 高级服务器操作系统 V10 上运行。本指南将向您展示如何在麒麟操作系统上安装ONLYOFFICE 文档开发者版的 Docker 版本。

系统要求

CPU

双核 2 GHz 或更高
内存

4 GB 或更多
硬盘

至少 40 GB 的可用空间
交换分区

至少 4 GB，但取决于主机操作系统。更多更好
操作系统

amd64 Linux 发行版，内核版本 3.10 或更高
Docker：任何麒麟操作系统支持的版本

安装 ONLYOFFICE 文档

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

docker_OPTS="--dns 8.8.8.8"

对于基于 RPM 的操作系统，如 CentOS：

创建 /etc/docker/daemon.json 配置文件，内容如下：
```
{ "dns" : [ "8.8.8.8" ] }
```
重启 Docker 服务：
```
sudo systemctl restart docker.service
```

禁用 SELinux

您需要在 /etc/selinux/config 配置文件中禁用 SELinux。

使用任何文本编辑器打开 /etc/selinux/config 文件，将 SELINUX=enforcing 或 SELINUX=permissive 字符串替换为 SELINUX=disabled，并保存更改。

重启服务器以使更改生效。确保 SELinux 已禁用：

[root@test ~]# sestatusSELinux status:                 disabled

安装 ONLYOFFICE 文档

执行以下命令安装 ONLYOFFICE 文档：

sudo docker run -i -t -d -p 80:80 --security-opt seccomp=unconfined --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。

--security-opt seccomp=unconfined 键用于禁用容器的安全配置文件。更多详情请见这里。

您也可以使用我们的自定义安全配置文件：kylin-seccomp7.json。

默认情况下，ONLYOFFICE 文档使用端口 80 监听传入连接。从版本 4.3 开始，您可以更改 ONLYOFFICE 文档 的端口，如果您计划使用非默认端口，可以在安装过程中更改映射端口：

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

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

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

添加防火墙例外

您还需要为 firewalld.service 服务添加一个例外：

sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload

配置完成后，您可以在浏览器地址栏中输入http://localhost以打开 ONLYOFFICE 文档欢迎页面，您将在其中找到有关如何启用文档示例或使用提供的 API将在线编辑器集成到您的 Web 应用程序中的进一步说明。

在容器外存储数据

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

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

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

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

sudo docker run -i -t -d -p 80:80 --security-opt seccomp=unconfined --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 --security-opt seccomp=unconfined --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 --security-opt seccomp=unconfined --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 地址访问。

生成自签名证书

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

步骤 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 应用程序默认配置的 SSL 证书路径为 /var/www/onlyoffice/Data/certs，不过可以通过 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_HTTPS_HSTS_ENABLED：用于关闭 HSTS 配置的高级配置选项。仅在使用 SSL 时适用。默认为 true。
ONLYOFFICE_HTTPS_HSTS_MAXAGE：用于设置 onlyoffice NGINX vHost 配置中的 HSTS 最大年龄的高级配置选项。仅在使用 SSL 时适用。默认为 31536000。
SSL_CERTIFICATE_PATH：要使用的 SSL 证书的路径。默认为 /var/www/onlyoffice/Data/certs/tls.crt。
SSL_KEY_PATH：SSL 证书私钥的路径。默认为 /var/www/onlyoffice/Data/certs/tls.key。
SSL_DHPARAM_PATH：Diffie-Hellman 参数的路径。默认为 /var/www/onlyoffice/Data/certs/dhparam.pem。
SSL_VERIFY_CLIENT：启用使用 CA_CERTIFICATES_PATH file 验证客户端证书。默认为 false。
DB_TYPE：数据库类型。支持的值有 postgres、mariadb 或 mysql。默认为 postgres。
DB_HOST：运行数据库服务器的主机的 IP 地址或名称。
DB_PORT：数据库服务器端口号。
DB_NAME：在镜像启动时要创建的数据库名称。
DB_USER：数据库帐户的新用户名，具有超级用户权限。
DB_PWD：为数据库帐户设置的密码。
AMQP_URI：连接到消息代理服务器的 AMQP URI。
AMQP_TYPE：消息代理类型。支持的值有 rabbitmq 或 activemq。默认为 rabbitmq。
REDIS_SERVER_HOST：运行 Redis 服务器的主机的 IP 地址或名称。
REDIS_SERVER_PORT：Redis 服务器端口号。
NGINX_WORKER_PROCESSES：定义 NGINX 工作进程的数量。
NGINX_WORKER_CONNECTIONS：设置 NGINX 工作进程可以打开的最大同时连接数。
SECURE_LINK_SECRET：为 nginx 配置指令 secure_link_md5 定义密钥。默认为 random string。
JWT_ENABLED：指定启用 ONLYOFFICE 文档 的 JSON Web 令牌验证。默认为 true。
JWT_SECRET：定义用于验证请求中 JSON Web 令牌的密钥 ONLYOFFICE 文档。默认为随机值。
JWT_HEADER：定义将用于发送 JSON Web 令牌的 HTTP 头。默认为 Authorization。
JWT_IN_BODY：指定启用 ONLYOFFICE 文档 请求体中的令牌验证。默认为 false。
WOPI_ENABLED：指定启用 wopi 处理程序。默认为 false。
USE_UNAUTHORIZED_STORAGE：如果为存储服务器（例如 Nextcloud）使用自签名证书，则设置为 true。默认为 false。
GENERATE_FONTS：当 true 时，在每次启动时重新生成字体列表和字体缩略图等。默认为 true。
METRICS_ENABLED：指定为 ONLYOFFICE 文档 启用 StatsD。默认为 false。
METRICS_HOST：定义 StatsD 监听主机。默认为 localhost。
METRICS_PORT：定义 StatsD 监听端口。默认为 8125。
METRICS_PREFIX：定义后端服务的 StatsD 指标前缀。默认为 ds.。
LETS_ENCRYPT_DOMAIN：定义 Let's Encrypt 证书的域。
LETS_ENCRYPT_MAIL：定义 Let's Encrypt 证书的域管理员邮件地址。

注册您的开发者版

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

当您使用 docker 容器时，license.lic 文件可以放置在任何文件夹中（例如 /app/onlyoffice/DocumentServer/data/license.lic），但您需要在容器启动时挂载此文件夹：

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

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

在您自己的服务器上托管 ONLYOFFICE 文档，或在云端使用

在本地部署注册文档云