docker搭建部署 onlyoffice 实现前端集成在线解析文档解决方案
最近有一个需求 需要实现 在线编辑预览 word excel ppt pdf 文档。对于文档操作 我们一般用的最多 是wps 和office 。但是这类软件都是客户端软件。对于我们软件开发 是满足不了需求的,我们要满足在线编辑预览文档,就需要做一种类似 云文档 在线编辑预览的功能,就发现了 onlyoffice 软件。这个软件 他也有 客户端 exe 。如果你对文档没有什么要求,只是简单的预览 或者编辑 也可以给电脑上装这个onlyoffice软件,他是无广告的,满足平时的使用还是可以的。
官网地址:
https://www.onlyoffice.com/
但是对于我们要做云文档管理,肯定装客户端不行,我们需要利用它搭建一个服务端,为我们提供云文档解析的功能。
今天这个文章就是主要给大家分享 我们怎么使用docker 来部署 onlyoffice 服务。
onlyoffice官方docker安装文档:
https://helpcenter.onlyoffice.com/docs/installation/docs-developer-install-docker.aspx?from=api
- docker 安装 这就不说了 自行百度。
- docker 下载 onlyoffice 镜像
docker pull onlyoffice/documentserver
然后就是 启动 即可,对于启动 我们就不采用 文档里的 直接使用docker run 命令启动。而是 创建 一个 yml文件 进行启动。
这些都是docker的相关知识,这里就不一一细说了。我直接就来分享 yml文件里的内容
docker yml文件启动方式:
docker compose -f docker-compose-onlyoffice.yml up -d
如果我们修改了yml配置信息,重新生效 停止并删除由 docker-compose.yml 文件中定义的所有容器、网络和卷。执行下面命令后然后再重新启动即可:
docker compose -f docker-compose-onlyoffice.yml down
yml文件内容:
对于前端怎么调用这个服务 和怎么配合后端使用,这篇文章就不介绍了。
而且这个onlyoffice服务 也支持java等编程语言 调用 可以自由生成各种类型的文档,具体实现方式,大家可以去看官方文档即可。
官方文档地址:https://api.onlyoffice.com/zh-CN/docs/docs-api/usage-api/advanced-parameters/
only是可以开启 token验证的,如果开启了 token验证,在传参调用的时候 就需要加密 参数验证。
以java为例:
<dependency><groupId>com.inversoft</groupId><artifactId>prime-jwt</artifactId><version>1.3.1</version>
</dependency>
public static String getToken( String config ){// config 需要发给only的参数JSONObject jsonObject = JSON.parseObject(config);//这个key 就是 JWT_SECRET 参数 可在docker - yml文件里配置String tokenSecret = "如果开启了 jwt 需要这个key ";Map<String, Object> payloadClaims = BeanUtil.beanToMap(jsonObject);String token = "";try {Signer signer = HMACSigner.newSHA256Signer(tokenSecret);JWT jwt = new JWT();for (String key : payloadClaims.keySet()) {jwt.addClaim(key, payloadClaims.get(key));}token = JWT.getEncoder().encode(jwt, signer);} catch (Exception e) {token = "";}return token;}
请求only office 参数例 多一个 token key即可。 {“token”:“211dsda”}
对于 docker-compose-onlyoffice.yml 里的配置参数 文档是都是有说明的,如果上面分享的yml文档的参数不够用,大家可以去官方文档自行添加即可。
写的非常清楚,下面是我再官方文档上 部分参数截图。
最后 上面分享 的关于docker的yml启动文件,有需要的小伙伴可以自行去下载使用!
https://wwwoop.com/home/Index/projectInfo?goodsId=103&typeParam=3&subKey=2