OnlyOffice 接入

从 1.3.1 版本开始，WLN.WIKI 专业版支持接入 OnlyOffice 以实现在站点内查看、上传、新建、修改 Office 文件。

如果要使用基于 OnlyOffice 的 Office 在线编辑和预览功能，你必须先部署一个 OnlyOffice 服务。

一、部署 OnlyOffice

本小节内容参考自 OnlyOffice 部署文档。

你可以根据 OnlyOffice 官方提供的部署指南进行 OnlyOffice 的部署，我们推荐你使用 OnlyOffice 官方提供的Docker 镜像进行部署。

Docker 部署 OnlyOffice

OnlyOffice 官方 Docker 镜像使用说明文档：https://hub.docker.com/r/onlyoffice/documentserver

docker run -d --restart=always --name oo \
-p 8123:80 \
-v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
-v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
-v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
onlyoffice/documentserver:latest

上面的命令将会运行一个名为oo的 OnlyOffice 容器在8123端口上，并将 OnlyOffice 的数据挂载在/app/onlyoffice/DocumentServer/目录下。

查看 JWT 令牌

在终端输入如下命令可以获取 OnlyOffice 默认的 JWT 令牌值，请复制下来以备配置使用。

docker exec oo /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

额外配置：反向代理 - WebSocket 支持

如果你使用 Nginx 或其他诸如宝塔 Nginx 的工具对部署的 OnlyOffice 进行了反向代理，则需要额外添加 Nginx 配置来支持 WebSocket:

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

以宝塔为例，可在反向代理中添加如下配置：

反向代理配置截图

额外配置：反向代理 - HTTPS 额外配置

如果你部署的 OnlyOffice 使用了 HTTPS，则还需要增加以下配置：

proxy_set_header X-Forwarded-Proto https;

二、配置 WLN.WIKI

OnlyOffice 服务部署好之后，需要在 WLN.WIKI 中填写 OnlyOffice 相关的配置信息。配置完成就可以直接在 WLN.WIKI 中使用基于 OnlyOffice 的 Office 文档了。

进入「后台管理」--「站点设置」页面，选择「文集、文档、素材设置」，在「OnlyOffice配置」下填入 OnlyOffice 的服务地址和JWT令牌，最后开启 OnlyOffice 功能开关，保存配置即可。

OnlyOffice配置截图

HTTPS 额外配置

如果你的 WLN.WIKI 使用了 HTTPS，那么请务必在 WLN.WIKI 的 Nginx 反向代理配置中添加如下配置：

proxy_set_header X-Forwarded-Proto $scheme;

否则，可能会出现「这份文件无法保存，请检查连接设置或联系管理员……」的错误提示。

三、使用

在 OnlyOffice 功能开关开启的状态下，首页、文集、文档页面顶部的新建菜单栏会有一个「OnlyOffice」选项，点击它，就可以进入 OnlyOffice 文档的新建页面。

新建OnlyOffice菜单截图

在这里，你可以直接选择新建Word、Excel、PPT、表单文件等，或者从本地上传一个 Office 文件：

OnlyOffice文件类型选择截图

选择之后，就会渲染 OnlyOffice 的编辑界面，编辑完成后按照正常的文档发布流程操作即可。

OnlyOffice编辑界面截图

四、其他问题

1、当 WLN.WIKI 服务器与OnlyOffice服务器时间不一致时，可能会弹出：提示「这份文档无法保存。请检查连接设置或联系你的管理员。当你点击"OK"按钮，系统将提示您下载文档。」的提示框。