java整合onlyoffice的各种坑
项目场景：
引入在线预览文件的服务(onlyoffice)，集成在自己项目之中，实现多种文件格式的在线预览。
问题描述
前提：
根据官方建议，实现onlyoffice服务的安装。
由于其服务依赖很多组件，官方建议docker安装，安装好后，启动，先看能不能访问到。成功后能够访问到如下页面，说明服务启动成功。
选择版本，7.2以下的版本默认不开启jwt访问，但7.2以上默认开启jwt。
官方给了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。
二种方式，推荐第二种
修改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-*
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的链接问题，如果在集成的时候遇到问题，可参考。
其他小伙伴如有问题讨论可发私信。
免责声明：
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的，并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据，供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
