onlyoffice 一些使用心得

 一、基本介绍

    首先onlyoffice是一款开源强大的在线协同的系统,提供在线协同编辑、批注、历史版本、pdf转换、即时聊天等功能,系统也比较的成熟。目前协同软件很多国内大厂都在搞,腾讯文档、钉钉文档、飞书、wps、石墨等。开源软件上也有挺多的如onlyoffice、openoffice、国内二开onlyoffice的毕昇文档等等。这几个开源的系统,从还原度高保真效果来说openoffice效果是最好的,对原生支持度比较好。onlyoffice则在字体还原度上不是那么的友好,但是从开源角度来看onlyoffice遵循apache开源协议、够用、基本能满足使用场景,这也是博主当时选择onlyoffice的主要原因。

    onlyoffice最核心的在与document server。官方提供多种形式的document server,如docker、windows、Debian、Ubuntu、CentOS、RHEL、Snap包、Cloudron一键应用等多种方式,当然也可以选择对应的源码进行编译安装。题主当时选择用的是docker版本的也比较推荐,以为docker使用安装比较方便,可以避免很多安装麻烦。

    本文主要讲解onlyoffice docker版的document server的简单安装和使用,以及自己遇到的一些坑

二、document server安装

        硬件推荐基础配置

  • CPU/RAM   2c2g 以上
  • HDD  >= 40 GB 

  • Additional requirementsat least 4 GB of swap

  • 操作系统   Linux kernel 在 3.10或以上

  • Docker: 版本 1.10或以上

docker安装教程

Docker地址

document server安装

#1、获取onlyoffice镜像 命令 docker pull [OPTIONS] NAME[:TAG|@DIGEST]
docker pull onlyoffice/documentserver[:tags]  
可以通过tags来指定版本,如果不指定则获取的是最新的版本
可以通过 docker images来查看镜像是否pull成功

#2、启动
#直接启动
sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver
#onlyoffice依赖postgresql,rabbitmq,挂载启动,将数据文件和日志等目录信息挂载到宿主机,避免重启丢失,可以将文件缓存目录,db数据目录挂载出来。一般建议使用第二种
sudo docker run -i -t -d -p 80:80 --restart=always \
    -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  \
    -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
    -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql  onlyoffice/documentserver 

#小贴士:docker 
        -t 表示 分配一个伪终端,镜像命令行操作 
        -i 以交互式模式运行容器,通常和-t一起使用
        -d 表示后台运行并输出一个docker运行id
#启动后进入容器
查看docker 进程好 docker ps
docker exec  -i -t 进程号  /bin/bash。
docker exec -i -t ecce7a1d89c3 /bin/bash    ecce7a1d89c3 指的是进程号。

进入容器可以进行linux命令进行操作

cd 进入:/var/www/onlyoffice/documentserver目录,该目录结构如下

core-fonts里面存放了常用的字体,如果不能满足使用的话可以自己下载字体使用docker copy加入到容器去,在使用docker builder名利构建一个新的镜像

如果需要替换页面logo(官方有直接支持配置),或者某些页面样式要修改,可以进入到web-apps里面寻找对应的页面进行修改,当然这个是编译后的dist看起来会比较费劲,建议如果需要改动的地方较多的话还是去使用源码进行编码。当时博主使用知识替换一下logo,还有加载动画,加一些提示框说明等,修改比较简单就选择了直接修改镜像文件。

三、api使用

ONLYOFFICE Api Documentation - Config

给出一个代码集成的时序图(onlyoffice指的是onlyoffice服务,文档指的是自己的业务后端系统)

onlyoffice配置信息想见官方文档

如下是onlyoffice文件编辑保存时序图

  • 1
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值