《onlyoffice的安装和使用》

1、onlyoffice简介

ONLYOFFICE是一套开源的在线办公协作平台，主要提供在线文档编辑（Word/Excel/PPT）+ 协同办公能力。它常被用于替代传统 Office，在企业内部系统（如 OA、文档管理系统、网盘等）中实现浏览器在线编辑文档。

2、启动onlyoffice

2.1 docker run的方式启动

前提：Linux服务器上已经安装好docker服务。

启动命令：

docker run -d -p 8088:80 \ --name onlyoffice \ -e JWT_ENABLED=false \ -e WOPI_ENABLED=false \ --restart=always \ -v /opt/docker_mount/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \ -v /opt/docker_mount/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \ -v /opt/docker_mount/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \ -v onlyoffice_config:/etc/onlyoffice/documentserver \ onlyoffice/documentserver:7.5

命令说明：

-e JWT_ENABLED=false 作用是关闭 JWT token 校验，在ONLYOFFICE Document Server 中， JWT用于校验调用来源，防止非法访问,开发阶段通常关闭，生成环境建议开启。

-e WOPI_ENABLED=false 关闭 WOPI协议，WOPI 是微软的在线编辑协议。OnlyOffice支持两种集成方式： （1）API模式 （2）WOPI模式

几个挂载说明：

-v /opt/docker_mount/onlyoffice/DocumentServer/logs:/var/log/onlyoffice 把容器中的日志挂载出来，便于排查问题 -v /opt/docker_mount/onlyoffice/DocumentServer/data:/var/www/onlyoffice/DataDocumentServer 公共数据目录，例如自定义字体，安装插件等 -v /opt/docker_mount/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice 这个是最重要的目录之一，在 ONLYOFFICE Document Server 中 /var/lib/onlyoffice存储: 编辑缓存 转换文件 协同编辑状态 临时文件 -v onlyoffice_config:/etc/onlyoffice/documentserver （这个是卷挂载）把容器中的相关配置挂载出来便于修改

启动之后访问onlyoffice提供的页面，如下：

如果此时点击 GO TO TEST EXAMPLE 会报如下错误

这是因为测试服务没有启动，上图中给我们提供了启动命令，分别在服务器上执行如下两条命令（注意：容器id修改成自己的启动的服务id）：

启动测试服务： sudo docker exec bc1d4412821d sudo supervisorctl start ds:example 设置测试服务自动启动 sudo docker exec bc1d4412821d sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

此时就可以进入测试页面了，如下：

点击Document，此时还是会报错如下：

此时还需要修改如下配置文件并重启onlyoffice服务： /var/lib/docker/volumes/onlyoffice_config/_data/default.json

现在可以创建一个在线编辑文档，如下图：

2.2 docker-compose的方式启动

生产环境通常使用docker-compose的方式进行启动服务，把上述的docker run方式的命令转换成如下的docker-compose命令(docker-compose-onlyoffice.yaml)：

注意：上面启动的onlyoffice服务已经占用了宿主机的8088端口，现在通过docker-compose方式启动时使用8089端口，容器名称也换成onlyoffice_v2

name: onlyoffice services: onlyoffice: image: onlyoffice/documentserver:7.5 container_name: onlyoffice ports: - "8089:80" environment: - JWT_ENABLED=false - WOPI_ENABLED=false volumes: - /opt/docker_mount/onlyoffice/DocumentServer/logs:/var/log/onlyoffice - /opt/docker_mount/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data - /opt/docker_mount/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice - onlyoffice_config:/etc/onlyoffice/documentserver restart: always volumes: onlyoffice_config: external: true

进入到docker-compose-onlyoffice.yaml 文件所在目录下，执行如下命令启动onlyoffice服务：

此时同样需要启动example服务，如下：

3. SpringBoot项目集成onlyoffice请参考链接

https://gitee.com/sun_hongguang/exame_system_server_before/

请看 <_07_onlyoffice_part> 这个Module下的代码

注意：resources/static/test.html 这个文件里面的两个ip地址要修改成你自己的，然后浏览器访问

http://你的本地ip:端口/test.html

本地测试截图：

(1) 启动项目

（2）浏览器访问 test.html