运行环境
linux:ubuntu14、16、18都试过,都能运行,docker现在使用的是docker19.03.13,其他版本也试过,可以运行,没纠结具体版本
window:本机是win10的所以安装的是DockerToolbox-18.09.1.exe,安装后部署也能运行,具体操作步骤自己百度
添加、运行镜像
1.docker中导入镜像,两种方式:
1. docker load --input onlyoffice5.3.4.tar
2. cat ./onlyoffice5.3.4.tar | sudo docker import - [新镜像名]:[tag标识]
2.查看镜像、删除镜像、镜像重命名
1.docker images
2.docker rmi [REPOSITORY]:[TAG]
3.docker tag [IMAGE ID] [新镜像名]:[tag标识]
3.运行镜像
1.docker run -itdp 9000:80 --name=documentserver -v /home/docker/:/home/ onlyoffice:v1
--name=documentserver ===>自定义启动的镜像名称【可选】
-v /home/docker/:/home/ ===>挂载:将ubuntu系统中/home/docker文件夹与镜像中/home/文件夹建立连接
onlyoffice:v1 ===>自己定义的onlyoffice镜像的[REPOSITORY]:[TAG]
4.验证是否启动成功
浏览器运行【ip:9000】看到Document Server is running就成功了,显示waiting就等几秒再刷新几次。如果出现失败,使用 【 docker logs -f -t -tail 200 documentserver 】查看日志中具体错误信息
文档集成
1.去onlyoffice官网api目录下载,我用的是java的
2.导入开发工具、修改配置
项目结构如上图,那个ONLYOFFICE.html是后面我自己改的不用管。
部分参数需要修改
1.setting.properties中的ip为自己部署的onlyoffice服务的ip
2.editor.jsp中callbackUrl里面那个ip要换成自己的
其他的应该暂时不需要改了
3.修改完配置后部署项目启动,我使用的是tomcat部署的,浏览器访问的时候
**不要使用127.0.0.1或localhost!!!**
**不要使用127.0.0.1或localhost!!!**
**不要使用127.0.0.1或localhost!!!**
一定要使用本机ip+端口访问
4.成功后的页面
二次开发
1.修改连接数限制
切换到docker,进入镜像
cp var/www/onlyoffice/documentserver/server/Common/sources/constants.js /home/
修改 exports.LICENSE_CONNECTIONS的值
修改完后重新上传到镜像,替换原来的文件,然后打开浏览器,多开些窗口测试,不行的话就重启镜像
ps:这里用了docker的挂载,因为onlyoffice镜像里没有vi命令,所以我将文件拷贝出来修改后再传进去替换的
2.方法拓展
因为项目原因不需要文档编辑器那么多的操作栏,只需要某几个功能,所以需要将功能提取出来,因此我对onlyoffice做了一些拓展,比如:在外部调用文档编辑器中一些方法等;涉及功能有限,只针对本次开发提供一些思路