安装 ONLYOFFICE 文档 企业版 Docker 版本用于 64 位 ARM 架构

系统要求

• CPU: 64 位 ARM 处理器
• RAM: 4 GB 或更多
• HDD: 至少 40 GB 的可用空间
• SWAP: 至少 4 GB，但取决于主机操作系统。更多更好
• OS: arm64 的 Linux 发行版
• 附加要求
  • Docker: 任何由 Docker 团队支持的 版本

使用 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:latest

其中：

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

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

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

可用的配置参数

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

• 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 文件 验证客户端证书。默认值为 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 服务器端口号。
• REDIS_SERVER_PASS: 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。
• ALLOW_META_IP_ADDRESS: 定义是否允许连接元 IP 地址。默认值为 false。
• ALLOW_PRIVATE_IP_ADDRESS: 定义是否允许连接私有 IP 地址。默认值为 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 证书的域管理员邮件地址。