跳到主要内容

Go 示例

概述​

此示例将指导您如何将 ONLYOFFICE 文档集成到使用 Go 编写的网页应用中。

示例仅供测试和演示编辑器功能。请勿在未进行适当代码调整的情况下直接用于生产环境。如果启用了测试示例,请确保在上线前将其禁用。

重要安全信息​

使用测试示例时,请注意以下安全事项:

  • 因为无需授权,存储内容未受到未授权访问的保护。
  • 参数由代码按固定脚本生成,链接中不执行参数替换检查。
  • 测试示例仅用于响应 ONLYOFFICE 文档的请求,因此保存文件时未进行数据校验。
  • 由于测试示例设计为与跨域的 ONLYOFFICE 文档交互,因此未限制来自其他站点的访问。

步骤 1. 安装 ONLYOFFICE 文档

下载并安装 ONLYOFFICE 文档(文档服务器版本)。

获取 ONLYOFFICE 文档

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

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

从我们的网站下载 Go 示例

要将编辑器连接到您的网站,请在 configuration.env 文件中指定编辑器的安装路径、服务器协议、地址和端口:

SERVER_ADDRESS=http(s)://address (optional)
SERVER_PORT=port

DOC_SERVER_HOST=http://documentserver/

JWT_IS_ENABLED=flag
JWT_SECRET=secret
JWT_HEADER=Authorization

其中,documentserver 是安装了 ONLYOFFICE 文档的服务器的名称。 address 是服务器的地址,port 是服务器端口。

若要试验编辑器配置,请修改 templates/editor.html 文件中的参数

步骤 3. 安装必要软件​

要运行 Go 示例代码,请安装 Go 编译器:

步骤 4. 设置环境变量​

安装编译器后,更新 Golang 环境变量:

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
export PATH=$PATH:/usr/local/go/bin

步骤 5. 配置 JWT​

打开 config/configuration.json 文件并启用 JWT:

{
"JWT_IS_ENABLED" : true,
}

另外,指定与 ONLYOFFICE 文档中使用的相同的密钥

{
"JWT_SECRET" : "secret",
}

步骤 6. 启动应用程序​

  1. 前往项目根目录。

  2. 运行:

    go run main.go
  3. 在浏览器中转到 server.addressserver.port

步骤 7. 检查可访问性

如果示例与 ONLYOFFICE 文档分别部署在不同服务器上,请确保示例所在服务器能通过配置文件中指定的地址(而非默认的 documentserver)访问 ONLYOFFICE 文档。