如何用Node.js将在线编辑器集成到您自己的网站中

概述

此示例将帮助您将 ONLYOFFICE 文档集成到用Node.js编写的 Web 应用程序中。

重要安全信息

在使用测试示例时，请记住以下几方面的安全事项：

• 由于不需要授权，因此无法保护存储免受未经授权的访问。
• 没有检查链接中的参数替换，因为参数是由代码根据预先安排的脚本生成的。
• 在编辑后保存文件的请求中没有数据检查，因为每个测试示例仅适用于来自 ONLYOFFICE 文档服务器的请求。
• 没有禁止使用来自其他网站的测试示例，因为它们用于与来自另一个域的 ONLYOFFICE 文档服务器进行交互。

对于 Windows

步骤 1.安装 ONLYOFFICE 文档

下载并安装 ONLYOFFICE 文档 （打包为文档服务器）。

请参阅详细指南以了解如何安装 Windows版文档服务器。

步骤 2.下载用于编辑器集成的 Node.js 代码

从我们的网站下载 Node.js 示例。

要将编辑器连接到您的网站，请在 config/default.json 文件中指定编辑器安装的路径和存储文件夹的路径：

"storageFolder": "./files"
"storagePath": "/files"
"siteUrl": "https://documentserver/"

其中 documentserver 是安装了 ONLYOFFICE 文档服务器的服务器的名称， storageFolder 和 storagePath 是创建和存储文件的路径。 您可以设置绝对路径。例如， D:\\folder。请注意，在 Windows 操作系统上，双反斜杠必须用作分隔符。

如果要试验编辑器配置，请修改 \views\editor.ejs 文件中的 参数。

步骤 3.安装 Node.js 环境

安装将用于运行 Node.js 项目的 node.js 环境。 请按照 官方网站 上的链接为您的 Windows 操作系统（32 位或 64 位）选择正确的版本。

步骤 4.运行 Node.js 代码

我们将在 Node.js runtime 环境中运行代码，并使用 命令行界面 (cmd)与之交互。

1. 启动 命令提示符 并切换到包含 Node.js 项目代码的文件夹，例如：
   cd /d "C:\Node.js Example"
2. Node.js 带有一个包管理器， node package manager (npm)，它与 Node.js 一起自动安装。 要运行 Node.js 代码，请使用以下 npm 命令安装项目模块：
   npm install

   将在项目文件夹中创建一个新的 node_modules 文件夹。

3. 使用 命令提示符运行项目：
   node bin/www
4. 使用下列地址在浏览器中查看结果：
   http://localhost:3000

步骤 5.检查可访问性

如果示例和文档服务器安装在不同的计算机上，请确保安装了示例的服务器可以访问您指定地址的文档服务器，而不是配置文件中的 documentserver。 确保文档服务器能够访问安装了示例的服务器，该示例使用您指定的地址而不是配置文件中的 example.com。

如果您成功集成了编辑器，结果应该类似于我们网站上的 演示预览。

对于 Linux

步骤 1.安装 ONLYOFFICE 文档

下载并安装 ONLYOFFICE 文档 （打包为文档服务器）。

请参阅详细指南以了解如何安装 Linux版文档服务器。

步骤 2.安装先决条件并使用编辑器运行网站

1. Install Node.js:
   curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
   sudo apt-get install -y nodejs
2. 下载包含 Node.js 示例的存档并解压缩存档：
   wget https://github.com/ONLYOFFICE/document-server-integration/releases/latest/download/Node.js.Example.zip
   unzip Node.js.Example.zip
3. 将当前目录更改为项目目录：
   cd Node.js\ Example/
4. 安装依赖项：
   npm install
5. 编辑 config/default.json 配置文件。 指定安装了 ONLYOFFICE 文档服务器的本地服务器的名称。
   nano config/default.json

   编辑以下行：

   "storageFolder": "./files"
   "storagePath": "/files"
   "siteUrl": "https://documentserver/"
   

   其中 documentserver 是安装了 ONLYOFFICE 文档服务器的服务器的名称， storageFolder 和 storagePath 是创建和存储文件的路径。 请注意，您必须具有对该文件夹的读取和写入权限。如果您没有它们，请使用下一个命令：

   sudo chmod -R ugo+rw /{path}
   

6. 使用 Node.js 运行项目：
   node bin/www
7. 使用下列地址在浏览器中查看结果：
   http://localhost:3000

步骤 3.检查可访问性

如果示例和文档服务器安装在不同的计算机上，请确保安装了示例的服务器可以访问您指定地址的文档服务器，而不是配置文件中的 documentserver。 确保文档服务器能够访问安装了示例的服务器，该示例使用您指定的地址而不是配置文件中的 example.com。

如果您成功集成了编辑器，结果应该类似于我们网站上的 演示预览。