跳到主要内容

将 ONLYOFFICE Workspace 社区版切换到 HTTPS 协议

介绍​

在大多数情况下，通过 HTTPS 协议访问门户比默认使用的 HTTP 安全得多。但是，要更改门户访问方式，必须执行某些操作。请按照以下步骤了解如何将您的 ONLYOFFICE Workspace 切换到 HTTPS。

创建安全证书和私钥​

在开始将您的 ONLYOFFICE Workspace 社区版 切换到 HTTPS 之前，您需要创建安全证书和证书私钥。

要使用 letsencrypt 服务 自动生成 SSL 证书，请参阅 本文。

获得证书后，请继续执行以下步骤。

使用脚本将 ONLYOFFICE Workspace 社区版切换到 HTTPS​

将 ONLYOFFICE Workspace 社区版 切换到 HTTPS 的更快方法是使用脚本。它位于此处：

/var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

将创建的证书放入 /var/www/onlyoffice/Data/certs/ 目录。该目录中必须有两个文件：

  • /var/www/onlyoffice/Data/certs/onlyoffice.crt
  • /var/www/onlyoffice/Data/certs/onlyoffice.key

然后运行脚本：

sudo bash /var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

它将执行将您的 ONLYOFFICE Workspace 社区版 安装切换到 HTTPS 所需的一切操作。

手动将 ONLYOFFICE Workspace 社区版切换到 HTTPS​

您可以手动执行脚本的所有操作。为此，请按照以下步骤操作：

  1. 停止 NGINX 服务：

    sudo service nginx stop

  2. 将 /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template 文件复制到基于 Debian 系统的 /etc/nginx/sites-available/onlyoffice 文件，或基于 RPM 系统的 /etc/nginx/conf.d/onlyoffice.conf 文件。

    基于 Debian 的系统请使用以下命令：

    sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/sites-available/onlyoffice

    基于 RPM 的系统请使用以下命令：

    sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/conf.d/onlyoffice.conf

  3. 编辑基于 Debian 系统的 /etc/nginx/sites-available/onlyoffice 文件，或基于 RPM 系统的 /etc/nginx/conf.d/onlyoffice.conf 文件。将所有双大括号 {{...}} 中的参数更改为实际使用的值：

    • {{SSL_CERTIFICATE_PATH}}：您拥有的 SSL 证书的路径；
    • {{SSL_KEY_PATH}}：SSL 证书私钥的路径；
    • {{SSL_VERIFY_CLIENT}}：是否启用客户端证书验证（可用值为 on、off、optional 和 optional_no_ca）；
    • {{CA_CERTIFICATES_PATH}}：客户端证书的路径，如果通过上一个参数启用，则将对其进行验证；
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}}：用于在 ONLYOFFICE Workspace 社区版 NGINX vHost 配置中设置 HSTS max-age 的高级配置选项，仅在使用 SSL 时适用（通常默认值为 31536000，被认为足够安全）；
    • {{SSL_DHPARAM_PATH}}：Diffie-Hellman 参数的路径；
    • {{ONLYOFFICE_NGINX_KEEPLIVE}}：保留在每个工作进程缓存中的到上游服务器的空闲 keep-alive 连接的最大数量（有关此参数的更多信息，请参阅 NGINX 文档）；
    • {{DOCKER_ONLYOFFICE_SUBNET}}：Docker 内部子网的值（如果 ONLYOFFICE Workspace 社区版 是使用 Docker 安装的）；
    • {{SSL_OCSP_CERTIFICATE_PATH}}：包含 PEM 格式受信任 CA 证书的文件的路径，在启用 ssl_stapling 时用于验证客户端证书和 OCSP（在线证书状态协议）响应。

    有关配置文件中使用的 SSL 参数的更多信息，请参阅 NGINX 文档。

  4. 打开 /var/www/onlyoffice/Services/MailAggregator/ASC.Mail.Aggregator.CollectionService.exe.config 配置文件，并将 mail.default-api-scheme 参数值设置为 https。然后重启邮件聚合器服务：

    onlyofficeMailAggregator restart

  5. 将 Talk 切换到 TLS 协议。

  6. 完成所有更改后，您可以再次启动 NGINX 服务：

    sudo service nginx start
    备注

    必须开放 443 端口，门户才能正常运行。