跳到主要内容

将适用于 Windows 的 ONLYOFFICE 文档切换到 HTTPS 协议

介绍​

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

将 ONLYOFFICE 文档 5.3 版本及更高版本切换为 HTTPS​

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

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

备注

所有命令都应以管理员权限执行。要以管理员身份启动命令提示符，请右键单击桌面左下角的开始菜单按钮，然后单击命令提示符 (管理员) 选项。

  1. 停止 ONLYOFFICE DocumentServer Proxy 服务：

    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 文件，将所有双花括号 {{...}} 中的参数替换为实际值：

    备注

    请注意，反斜杠字符 ( \ ) 必须以以下方式之一进行转义：C:\\yourfolder\\certificates\\onlyoffice.key 或 C:/yourfolder/certificates/onlyoffice.key。如果路径中有空格，您需要将其用引号括起来，例如："C:/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 DocumentServer Proxy 服务：

    net start DsProxySvc
    备注

    必须打开端口 443，ONLYOFFICE 文档才能正常运行。

  5. 执行 %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

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

备注

这些说明适用于旧版本的 ONLYOFFICE 文档（v4.3–v5.2）。我们建议您升级到最新版本。如果无法升级，请结合上面的主要说明执行这些步骤，注意第 2 步和第 3 步有所不同，如下所述。

  1. 使用以下命令将 %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"

  2. 编辑 %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf 文件，按照上面第 3 步的说明，将所有双花括号 {{...}} 中的参数替换为实际值。