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

系统要求

• CPU：双核2 GHz或更高
• RAM：4 GB或更多
• HDD：至少40 GB的可用空间
• SWAP：至少4 GB，但取决于主机操作系统。更多更好
• OS：内核版本为3.10或更高的 amd64 Linux 发行版
• 附加要求
  • Docker：任何由 Docker 团队支持的版本

使用 certbot 将 ONLYOFFICE 文档切换到 HTTPS

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

运行 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

其中：

• 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 应用程序默认配置为在/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}}

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

可用的配置参数

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

• 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定义秘密。默认值为随机字符串。
• JWT_ENABLED：指定启用ONLYOFFICE 文档的 JSON Web 令牌验证。默认值为true。
• JWT_SECRET：定义在请求ONLYOFFICE 文档时验证 JSON Web 令牌的密钥。默认值为随机值。
• 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 证书的域管理员邮箱地址。