项目场景:
引入在线预览文件的服务(onlyoffice),集成在自己项目之中,实现多种文件格式的在线预览。
问题描述
前提:
1、根据官方建议,实现onlyoffice服务的安装。
2、由于其服务依赖很多组件,官方建议docker安装,安装好后,启动,先看能不能访问到。成功后能够访问到如下页面,说明服务启动成功。
3、选择版本,7.2以下的版本默认不开启jwt访问,但7.2以上默认开启jwt。
4、官方给了java2个demo版本去适配onlyoffice的服务。
1)java spring demo 用了jdk17,功能强大。后台是springboot+前端html
2)java demo 用了jdk8,功能比上面版本少很多,看似不强大,后台是spring+前端jsp。
而且好像适配7.2版本的话是有bug的,已在官网问了很多问题。注意:这个demo里面的version是1.5.1,不知道以后官网还会更新不。下面的内容会详细说。
如果各位的项目需要集成的话,首选java spring demo,目前没测过什么bug。
问题1:docker无法访问主机Ip
前提:如果自身服务和onlyoffice在同一台机器。
若主机开了防火墙,则需要对dokcer里面的ip放行,可进去docker容器查看、需要对这个ip放行
问题2:docker运行时,onlyoffice无法启动组件服务
docker 日志为:Waiting for connection to the localhost host on port 5432
前提:适配各种操作系统,启动的时候,doker run 最好加权限参数,不然导致onlyoffice里面的服务无法启动,这个真的恶心,当时适配国产操作系统一直不行,同样的命令centos和其他liunx系统都行。如果启动不成功,可以试下 docker run –privileged=true
问题3:7.2版本以上java demo版本无法使用秘钥访问。
打开文档页面错误: The document security token is not correctly formed. Please contact your document server administrator
没有通过代码解决,java demo貌似有bug(version:1.5.1),此处只能修改服务器配置,禁用jwt。
二种方式,推荐第二种
1、修改docker里面onlyoffice的文件,路径为 /etc/onlyoffice/documentserver/local.json
将local.json里面 的token下的inbox、outbox、browser值改为false。
“token”: { “enable”: { “request”: { “inbox”: false, “outbox”: false }, “browser”: false },
然后重启下服务。命令:systemctl restart ds-*
2、docker 启动时候,加参数 -e JWT_ENABLED=false
问题4:使用https方式启动onlyoffice,打开文件报错
这里给出完整步骤解决打不开的问题,主要是因为证书不可靠(自己生成的证书)
1、启动命令:sudo docker run -i -t -d -p 80:443 –restart=always onlyoffice/documentserver:7.2
2、进入容器:docker exec -it 容器id /bin/bash
3、进入目录: cd /var/www/onlyoffice/Data
4、创建文件夹: mkdir certs
5、进入certs:cd certs
6、依次执行如下命令:
1)、openssl genrsa -out onlyoffice.key 2048
2)、openssl req -new -key onlyoffice.key -out onlyoffice.csr
3)、openssl x509 -req -days 365 -in onlyoffice.csr -signkey onlyoffice.key -out onlyoffice.crt
4)、openssl dhparam -out dhparam.pem 2048
7、编辑文件 /etc/onlyoffice/documentserver/default.json 修改参数 rejectUnauthorized为false后保存,执行命令supervisorctl restart all
8、退出容器,重启。
总结:
提示:提供1个官网提issue的链接问题,如果在集成的时候遇到问题,可参考。
其他小伙伴如有问题讨论可发私信。
版权声明:本文为博主作者:Ntotl_原创文章,版权归属原作者,如果侵权,请联系我们删除!