将 ONLYOFFICE 文档 Windows 版切换为 HTTPS 协议

介绍

在大多数情况下，通过 HTTPS 协议访问编辑器比默认使用的 HTTP 更加安全。但要更改编辑器的访问方式，需要执行某些操作。请按照以下步骤了解如何将您的 ONLYOFFICE 文档 切换为 HTTPS 协议。

将 ONLYOFFICE 文档 v5.3 及更高版本切换为 HTTPS

在您开始将 ONLYOFFICE 文档 切换为 HTTPS 协议之前，您需要创建一个安全证书和证书私钥。将它们放入安装 ONLYOFFICE 文档 的计算机上的一个文件夹中。

获得证书后，请按照以下步骤进行操作：

1. 停止 ONLYOFFICE 文档服务器代理 服务：

   net stop DsProxySvc

2. 使用以下命令将 %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl 文件复制到 %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf 文件：

   COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf"

3. 编辑 %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf 文件，将所有双花括号 {{...}} 中的参数替换为实际使用的值：
   请注意，反斜杠字符 ( \ ) 必须以以下方式之一进行转义：С:\yourfolder\certificates\onlyoffice.key 或 С:/yourfolder/certificates/onlyoffice.key。如果路径中有空格，您需要将其全部用引号括起来，例如："С:/yourfolder/my certificates/onlyoffice.key"。
   • {{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 文档 NGINX vHost 配置中设置 HSTS max-age 的高级配置选项，仅在使用 SSL 时适用（通常默认为 31536000，被认为足够安全）；
   • {{SSL_DHPARAM_PATH}} - Diffie-Hellman 参数的路径；
   请参阅 NGINX 文档 以获取有关配置文件中使用的 SSL 参数的更多信息。
4. 完成所有更改后，您可以再次启动 ONLYOFFICE 文档服务器代理 服务：

   net start DsProxySvc

   端口 443 必须打开以确保门户正常运行。
5. 执行 %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

将 ONLYOFFICE 文档 v4.3–v5.2 切换为 HTTPS

要将 ONLYOFFICE 文档 v4.3/v5.2 切换为 HTTPS，您需要执行上述所有步骤，注意 第二 和 第三 步将有所不同，必须如下所示：

1. ...
2. 使用以下命令将 %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template 文件复制到 %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf 文件：

   COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf"

3. 编辑 %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf 文件，将所有双花括号 {{...}} 中的参数替换为实际使用的值...
4. ...