接入 OnlyOffice

> d Docker 部署方式需升级镜像至官方 Docker 镜像版本 v6及以上，其他部署方式自行处理系统依赖

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

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

## 一、部署 OnlyOffice

你可以根据 OnlyOffice 官方提供的[部署指南](https://api.onlyoffice.com/zh/editors/getdocs)进行 OnlyOffice 的部署，我们推荐你使用 OnlyOffice 官方提供的[Docker 镜像](https://github.com/ONLYOFFICE/Docker-DocumentServer)进行部署。

### 1.1、反向代理 - WebSocket 支持

如果使用 Nginx 或其他诸如宝塔使用了 Nginx 的工具进行了反向代理，则需要额外增加 Nginx 配置来支持 WebSocket:
```
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
```

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

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/15/2023-08-15_183621_8759720.0426048922232104.png)

### 1.2、反向代理 - HTTPS 额外配置

如果使用了 HTTPS，则还需要增加配置：
```
proxy_set_header X-Forwarded-Proto https;
```
图略，参考上图宝塔设置。

## 二、配置 MrDoc

在 OnlyOffice 服务部署好之后，在觅思文档中填写好相关的配置信息，就可以直接在觅思文档中使用基于 OnlyOffice 的 Office 文档了。

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

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/09/2023-08-09_210339_7052330.6912929240951615.png)

### 2.1、HTTPS 额外配置

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

```
proxy_set_header X-Forwarded-Proto $scheme;
```

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

## 三、使用

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

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/09/2023-08-09_210740_2176380.9085379089580656.png)

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

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/09/2023-08-09_210843_0630720.04988627209768215.png)

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