Ubuntu搭建团队文档协作在线平台

背景

最近需要在服务器搭建个多人在线写作平台，要求是可以使用office/word/excel功能，遂Google一番，找到了开源项目毕升office。

平台介绍

毕升Office云平台包括drive和在线文件服务功能。其中drive实现文件的在线管理，组织结构权限，分享，团队协作等，文件的全文检索等功能；在线文件服务能够处理word,ppt,excel格式文件的带水印预览以及多人协同编辑，另外还能处理pdf，视频，音频文件的预览以及实现了100多种文本文件带语法高亮的预览 。

安装前必读

安装过程在centos7以及ubuntu 18.04LTS系统下，硬件配置2核8G以及4核8G服务器均进行过测试。

建议使用新安装的系统来安装毕升Office。需要注意的是所有的安装都是root用户执行的。如果您的安装环境不能使用root用户，理论上是不会有问题的，如果碰到权限相关问题请自行搜索资料解决。

硬件要求

毕升Office是企业应用系统，主要是考虑在服务器上运行，对硬件资源有一定的要求。在实际测试安装中，cpu不应该低于2核，内存4G；实际线上生产运行，根据使用人数，增加硬件配置，比较推荐的配置为：毕升Office完整系统推荐4核8G；如果使用频率不高，2核内存4G/8G也可以。

另外：毕升Office安装采用的是docker安装,一般用户的docker 镜像是存储在系统目录中，建议系统硬盘有15G剩余空间，另外还应该有20G的数据空间（这个根据用户实际使用量来决定。）。在实际过程中，用户在升级时会重新下载新的镜像，在新的安装脚本中，无用的镜像会被删除，如果是以前安装的用户，你可以自行删除无用镜像，或者更新脚本，执行升级（bash upgrade.sh）后会删除镜像

关于vmware虚拟机

在实际的安装过程中，vmware虚拟机文件较多的情况是在虚拟机外面无法通过 IP来访问毕升Office。此时首先检查毕升office是否安装正确，检查方法是登录到虚拟机，使用命令 curl http://localhost 查看是否有如下输出

如果输出正常，则说明毕升Office安装没有问题。此时，需要检查是否是vmware网络问题。

用户协议

在开始安装使用前请阅读毕升Office免费使用用户协议：协议链接

系统要求

毕升Office安装完成自带nginx，并且配置好全部全部的路径。请确保你的系统中的80，443端口没有被占用

安装步骤

从github上clone相关的部署脚本到服务器上

git clone https://github.com/ibisheng/onlyoffice-deploy.git
cd deploy

或者你也可以从国内代码托管网站码云 上clone毕升Office部署脚本到服务器上

git clone https://gitee.com/ibisheng/deploy.git
cd deploy

安装docker以及docker-compose

这一步是准备毕升Office运行的系统条件，并不是安装毕升Office。

毕升Office云平台所有的服务均是基于docker-compose安装的，在进行下一步安装之前，

请确保你的服务器上已经安装了docker和docker-compose。

你可以使用我们准备的脚本安装,也可以自行参考资料进行安装。自行安装Docker 参考链接 ：https://docs.docker.com/install/；而docker-compose安装则可以执行如下命令：

curl -L https://get.daocloud.io/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` \
   -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
systemctl start docker
systemctl enable docker

你也可以选择使用我们提供的脚本安装docker：如果是你的系统是centos

bash preinstall.sh

如果你的系统是ubuntu，则可以执行：

bash preinstall-ubuntu.sh

一键安装毕升Office

由于一些环境下脚本创建网络会失败，建议在一键安装前建议手动创建docker 网络 bisheng。

docker network create bisheng

如果你的安装脚本是以前下载的，在安装前，请确保是使用的最新脚本，执行git pull 更新最新脚本

git pull

在完成以上步骤之后，可以通过install.sh脚本来安装毕升Office

bash install.sh /bisheng_data # 请确保/bisheng_data目录没有其他数据

注意：安装目录的结尾不要 斜杠 “/”，否则安装目录最好拼接会出错。即上面脚本 "/bisheng_data"不要写成“/bisheng_data/”

另外需要强调的是，不要使用有数据的目录作为安装目录，因为初次安装过程中会清空该目录

该安装命令需要一个参数来指定安装目录，该目录是毕升Office的工作目录，所以的数据都会保存在该目录，需要保证该目录所有在的存储设备上有较大的空间。例如在上面的脚本是我们是使用 /bisheng_data目录作为安装目录

测试

待上一步骤脚本执行完成之后，先检查所有的docker容易是否全部正常启动。

docker ps -a

其中tools这个容器正常状态是Exit的。

如何使用

以上安装完成之后，输入http://IP 即可进入到毕升Office主页面。其中IP是安装毕升Office的服务器的IP

配置

完成前面5步操作之后，需要申请免费激活系统即可进行正常使用。

没有完成系统激活前对毕升Office的访问都会被重定向到控制台以激活系统。激活系统主要是完成对毕升Office的免费授权。该授权包括系统中可注册的用户数，同时编辑最大的文档数，版本有效性验证，该账号付费升级详情等信息。每一个激活的毕升Office都会有一个唯一的许可序列号。

毕升Office目前支持联网激活和手动离线激活两种验证方式。

使用系统内置管理员账号登录，登录成功后，会自动转到系统控制台，即可以看到激活入口。内置管理员用户名是:admin；内置默认密码是:bisheng

联网激活

如图上图所示，点击进入许可配置，即可开始联网激活，按照页面中提示，就可以激活系统

手动离线激活

点击离线激活之后，进入到离线激活的页面，点击蓝色字"点击激活"

当点击这个链接之后，会打开一个毕升的文档的激活页面，在页面中填写相关信息之后，点击激活。在激活成功之后会得到一个毕升系统生成的激活码。

激活成功之后，在页面的下方会生成激活码，拷贝这些激活码

回到你部署的毕升Office控制台激活页面，点击离线激活页面中的激活按钮

点击激活之后，在输入框填入上一步拷贝字符串，然后点击确定，完成计划

完成激活系统之后可以在许可信息页面看到

删除激活

如果你想删除许可重新激活，点击删除许可就可以。删除许可会将许可信息彻底清空。请谨慎使用

激活生效方式

激活完成之后需要重启毕升Office，运行restart.sh即可

sh restart.sh

完成以上步骤之后，即可开始使用毕升Office

接下来你可以通过地址：http://IP 就正常使用

许可的再次验证

当用户完成激活之后，部署在用户服务器上的毕升Office将获取一个许可。

为了保证一个许可只有一台服务器运行，服务器上获取的许可将在90天后重新进行重新验证。

在用户部署的毕升Office服务器可以连接到毕升官方许可服务器的情况下，重新验证是自动进行的，不需要任何干预。

如果用户部署的毕升Office服务器在内网环境中无法连接到毕升官网许可服务器，则需要管理员进行人工干预，过程和离线激活过程一致。

当一个许可在多台服务器上同时运行时，再下一次的重新验证时，只有第一台服务器的的验证能够通过，如果第二台服务进行验证将会失败，并且导致该许可被封禁。

如果一个许可只有一台服务器在运行，则不会发生这种情况。

商业许可的获取

目前毕升Office的商业付费版和免费版的安装过程是一致的。两者的区别是在获取不同的许可之后商业版将会自动开通商业版的功能。

当用户需要商业付费版许可时：

• 首先在服务器上安装毕升Office，然后按照激活的过程进行激活。此时毕升Office将以免费版进行运行
• 联系毕升Office官方，并告诉需要升级为商业版的服务器许可序列号
• 收到毕升官方升级商业许可完成的通知之后，使用离线激活重新激活该服务器或者在许可配置页面刷新许可
• 使用脚本重启毕升Office服务
  
  激活完成之后需要重启毕升Office，运行restart.sh即可

sh upNodes.sh

毕升Office安装默认是自带ngix配置的，其中nginx的配置文件在安装目录下。如果安装安装目录是 /bisheng_data 具体路径则是： /bisheng_data/service/nginx/config/conf.d/bisheng.conf 。

如果你需要配置nginx 的https，则可以将https证书放在/bisheng_data/service/nginx/keys目录下，该目录在docker中的路径是/keys，配置时路径应该填写docker的路径

集成毕升Office文件服务，实现Office在线预览和编辑

上面的步骤完成之后，你就可以免费使用毕升Office包含drive功能以及在线文件服务功能。另外如果你的文件是存储在邮件附件，ERP，以及其他的各种在线系统，你也可以使用已经部署完成的毕升Office云平台的在线文件服务来来实现Office在线预览和编辑。你所需要做的是实现相关API就可以免费使用毕升在线文件服务。相关API请参考毕升Office文件在线服务集成API

相关问题

安装使用过程中如果有疑问可参考毕升Office使用指南

参考文献

• 毕升Office云平台安装步骤
• 毕升Office 激活