接入 OnlyOffice

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

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

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

## 一、部署 OnlyOffice

>i 本小节内容参考自 OnlyOffice 部署文档。
>
> 你可以根据 OnlyOffice 官方提供的[部署指南](https://api.onlyoffice.com/zh/editors/getdocs)进行 OnlyOffice 的部署，我们推荐你使用 OnlyOffice 官方提供的[Docker 镜像](https://github.com/ONLYOFFICE/Docker-DocumentServer)进行部署。

### Docker 部署 OnlyOffice

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

```shell
docker run -d --restart=always --name oo \
-p 8123:80 8124:443 \
-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
```

上面的命令将会运行一个名为`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";
```

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

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

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

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

## 二、配置 MrDoc

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

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

>d 请注意 OnlyOffice 的服务地址URL必须以斜杠`/`结尾。

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

### 2.1、HTTPS 额外配置

如果你的 MrDoc 使用了 HTTPS，那么请务必在 MrDoc 的 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 的编辑界面，编辑完成后按照正常的文档发布流程操作即可。

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/01/03/8271beb2d80f438cb9457b205a9b96cd4850.png)