技术文章

当前位置:首页>帮助手册>技术文章

在本地服务器上ONLYOFFICE Docs Developer Edition并集成到O2OA服务器 For CentOS

时间:2022-11-13   
内容导读

本篇梳理在 CentOS 服务器上部署 ONLYOFFICE 文档服务并接入 O2OA 平台的完整链路,从系统依赖与容器环境准备讲起,依次覆盖文档服务安装、服务启动与页面验证。随后说明在应用市场部署协作应用、编译数据表并重启服务,再把平台地址与文档服务地址配置为相同域名。流程侧还需分别制作用于编辑和阅读的表单,按环节分配控件,并提醒开启评论以便在正文上作批注。

本文内容如下:

1.介绍

2.安装前系统准备
3.在 CentOS 上安装 Docker
4.安装 onlyoffice document

5.验证是否成功

6.启动 o2oa 服务器

7.应用市场安装 onlyOffice 协作应用以及控件

8.连接并配置

9.流程中嵌入 onlyOffice

介绍

Developer Edition 允许您在本地服务器上安装 ONLYOFFICE Docs,并将在线编辑器与您的 Web 应用程序集成。

ONLYOFFICE Docs 是一个在线办公套件,包含文本、电子表格和演示文稿的查看器与编辑器,完全兼容 Office Open XML 格式:.docx、.xlsx、.pptx,并支持实时协作编辑。

功能性

  • 文档编辑器

  • 协作编辑

本指南介绍如何将 ONLYOFFICE Docs Developer Edition Linux 版本安装到您的机器上。

系统要求

  • 其他要求

    • Redis

在 CentOS 上安装 Docker 引擎

地址:https://docs.docker.com/engine/install/centos/

安装方法

使用存储库安装

在新主机上首次安装 Docker Engine 之前,需先设置 Docker 存储库,之后即可从该存储库安装和更新 Docker。

设置存储库

安装 yum-utils 包(提供 yum-config-manager 实用程序),并设置稳定的存储库。

$ sudo yum install -y yum-utils

执行命令时,如果使用 root 登录,可以去掉 sudo 命令。

image.png

$ sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

image.png

这些存储库包含在 docker.repo 上的文件中,但默认情况下是禁用的。

可以在稳定存储库旁边启用它们。以下命令即可启用存储库:

$ sudo yum-config-manager --enable docker-ce-nightly

如需启用测试通道,请运行以下命令:

$ sudo yum-config-manager --enable docker-ce-test

可以通过运行带有标志的命令来禁用 nightly 或 test 存储库。

要重新启用它,请使用该标志。

以下命令可禁用夜间存储库。

$ sudo yum-config-manager --disable docker-ce-nightly

image.png

安装 Docker 引擎

1. 安装最新版本的 Docker Engine 和 containerd,或进入下一步安装特定版本:

$ sudo yum install docker-ce docker-ce-cli containerd.io

image.png

如果提示接受 GPG 密钥,请验证指纹是否匹配 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35,匹配则接受。

image.png

2. 要安装特定版本的 Docker Engine,请先在 repo 中列出可用版本,然后选择并安装:

一个。列出并排序存储库中可用的版本。此示例按版本号从最高到最低对结果进行排序,并被截断:

[root@localhost ~]# yum list docker-ce --showduplicates | sort -r已加载插件:fastestmirror, langpacks已安装的软件包可安装的软件包 * updates: mirrors.aliyun.comLoading mirror speeds from cached hostfile * extras: mirrors.aliyun.comdocker-ce.x86_64                     3:20.10.9-3.el7                                                        docker-ce-testdocker-ce.x86_64                     3:20.10.9-3.el7                                                        docker-ce-stabledocker-ce.x86_64                     3:20.10.8-3.el7                                                        docker-ce-testdocker-ce.x86_64                     3:20.10.8-3.el7                                                        docker-ce-stabledocker-ce.x86_64                     3:20.10.7-3.el7                                                        docker-ce-testdocker-ce.x86_64                     3:20.10.7-3.el7                                                        docker-ce-stabledocker-ce.x86_64                     3:20.10.6-3.el7                                                        docker-ce-testdocker-ce.x86_64                     3:20.10.6-3.el7                                                        docker-ce-stabledocker-ce.x86_64                     3:20.10.5-3.el7                                                        docker-ce-testdocker-ce.x86_64                     3:20.10.5-3.el7                                                        docker-ce-stabledocker-ce.x86_64                     3:20.10.4-3.el7                                                        docker-ce-testdocker-ce.x86_64                     3:20.10.4-3.el7                                                        docker-ce-stabledocker-ce.x86_64                     3:20.10.3-3.el7                                                        docker-ce-testdocker-ce.x86_64                     3:20.10.3-3.el7                                                        docker-ce-stabledocker-ce.x86_64                     3:20.10.2-3.el7                                                        docker-ce-test

返回的列表取决于已启用的存储库,并特定于您的 CentOS 版本(本例中由后缀 .el7 表示)。

通过完全限定的包名称安装特定版本,即包名称 ( docker-ce) 加上版本字符串(第 2 列),从第一个冒号 ( :) 开始到第一个连字符为止,两者用连字符 ( -) 分隔。例如,docker-ce-20.10.9。

$ sudo yum install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io
$ sudo yum install docker-ce-20.10.9 docker-ce-cli-20.10.9 containerd.io

image.png

3. 启动 Docker。

$ sudo systemctl start docker

为 CentOS 和衍生产品安装 ONLYOFFICE Docs 社区版

https://helpcenter.onlyoffice.com/installation/docs-community-install-centos.aspx

安装依赖项

安装最新的 NGINX 包版本

要为 RHEL/CentOS 设置 yum 存储库,请创建文件 /etc/yum.repos.d/nginx.repo,内容如下:

vi /etc/yum.repos.d/nginx.repo

在文件中添加如下内容:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key

[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

image.png

保存文件。

官方说明

安装 NGINX:

sudo yum install nginx

image.png

安装完成后编辑 NGINX 配置文件 /etc/nginx/nginx.conf,

vi /etc/nginx/nginx.conf

修改后内容如下所示:

user                                                                        nginx;worker_processes                        1;error_log                                                    /var/log/nginx/error.log    warn;pid                                                                            /var/run/nginx.pid;events    {        worker_connections        1024;}http    {        include                                                    /etc/nginx/mime.types;        default_type                                application/octet-stream;        log_format                                        main        '$remote_addr    -    $remote_user    [$time_local]    "$request"    '                                                                                                                '$status    $body_bytes_sent    "$http_referer"    '                                                                                                                '"$http_user_agent"    "$http_x_forwarded_for"';        access_log                                        /var/log/nginx/access.log        main;        sendfile                                                on;        #tcp_nopush                                    on;        keepalive_timeout            65;        #gzip                                                            on;        include                                                    /etc/nginx/conf.d/*.conf;}
安装 EPEL 存储库

sudo yum install epel-release

image.png
安装和配置 PostgreSQL

安装与您的 CentOS 版本对应的 PostgreSQL 版本:

sudo yum install postgresql postgresql-server

image.png

如果您想从 PostgreSQL 存储库安装其他 PostgreSQL 版本,请参阅官方 PostgreSQL 文档以获取更多详细信息。

初始化 PostgreSQL 数据库

sudo service postgresql initdb sudo chkconfig postgresql on

image.png

启用 IPv4 和 IPv6 localhost 的“信任”身份验证方法

在文本编辑器中打开文件 /var/lib/pgsql/data/pg_hba.conf,

vi /var/lib/pgsql/data/pg_hba.conf

image.png

找到 host all all 127.0.0.1/32 ident 字符串,并替换为以下字符串:

host    all             all             127.0.0.1/32            trust

然后找到 host all all ::1/128 ident 字符串,并替换为以下字符串:

host    all             all             ::1/128                 trust

image.png

保存更改。

重启 PostgreSQL 服务:

sudo service postgresql restart

创建 PostgreSQL 数据库和用户:

您可以指定任意用户名和密码。首先运行命令:

cd /tmp

以避免从 root 运行时出现 could not change directory to "/root" 警告。随后创建数据库和用户:

sudo -u postgres psql -c "CREATE DATABASE onlyoffice;"
sudo -u postgres psql -c "CREATE USER onlyoffice WITH password 'onlyoffice';"
sudo -u postgres psql -c "GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;"

image.png
安装 Redis

sudo yum install redis

image.png

启动 redis 服务并设置开机自启:

sudo service redis start 
sudo systemctl enable redis

image.png
安装 RabbitMQ

sudo yum install rabbitmq-server

image.png

在 CentOS 8 上安装 RabbitMQ,请参考官方说明。

启动 rabbitmq 服务并设置开机自启:

sudo service rabbitmq-server start 
sudo systemctl enable rabbitmq-server

image.png
安装 mscorefonts

安装 cabextract 和 xorg-x11-font-utils 包:

sudo yum install cabextract xorg-x11-font-utils

image.png

对于 CentOS 7.8(2003),还需要安装 fontconfig:

sudo yum install fontconfig

image.png

安装 msttcore 字体包:

sudo rpm -i https://deac-ams.dl.sourceforge.net/project/mscorefonts2/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

image.png

安装 msttcore 字体包需要一定时间,请耐心等待。

image.png

安装 ONLYOFFICE 文档

添加 ONLYOFFICE 文档存储库

使用以下命令添加 yum ONLYOFFICE Docs 存储库:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

image.png
安装 ONLYOFFICE 文档

onlyoffice-documentserver-de   是指 ONLYOFFICE Docs Developer Edition,也可查看相应版本以安装企业版或社区版

执行以下命令:

sudo yum install onlyoffice-documentserver-de

image.png

下载安装文件可能需要一段时间:

image.png

启动相关服务并设置为开机自动启动:

sudo service supervisord start 
sudo systemctl enable supervisord 
sudo service nginx start 
sudo systemctl enable nginx

image.png

之后,ONLYOFFICE Docs 将作为一个进程运行。

该软件包将与其他 rpm 软件包一样进行更新。

更改 ONLYOFFICE 文档默认端口(80端口无需修改)

默认情况下,ONLYOFFICE Docs 使用端口 80 侦听传入连接。从版本 4.3 开始,如果您打算使用 ONLYOFFICE Docs 的非默认端口,则可以更改。

如果要更改默认端口,请确保它对传入/传出连接打开。请参阅ONLYOFFICE Docs使用的端口的完整列表。

为此,您需要编辑运行命令中的 DS_PORT 环境变量:

export DS_PORT = 80

请填写端口号,而不是上述命令中的 <PORT_NUMBER>,我们这里一般默认使用 80 端口

配置 ONLYOFFICE 文档

运行配置脚本

运行 documentserver-configure.sh 脚本:

bash documentserver-configure.sh

系统将要求您指定 PostgreSQL、Redis 和 RabbitMQ 的连接参数。请使用以下数据:

对于 PostgreSQL:

对于 Redis:

对于 RabbitMQ:

image.png
添加防火墙例外(或者停止防火墙)

sudo firewall-cmd --zone=public --add-port=80/tcp --permanent 
sudo firewall-cmd --reload

在浏览器中启动 ONLYOFFICE Docs

配置完成后,您可以在浏览器地址栏中输入:

http://localhost

以打开ONLYOFFICE Docs欢迎页面,您将在其中找到有关如何使用提供的 API启用文档示例或将在线编辑器集成到 Web 应用程序中的进一步说明.

image.png

欢迎页末尾提供启动示例程序和设置自动启动的命令:

sudo supervisorctl start ds:example
sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisord.d/ds-example.ini

image.png

设置服务器域名:

通知网络管理员,在 nginx 配置 hosts 时对应 ip 地址和域名,这里我们设置为:ip  -->only.o2oa.net

安装成功后输入地址进行验证:

打开地址:http://only.o2oa.net/welcome/

启动 O2OA 服务器

特别注意点:要设置 host 并配置域名,需要同域。例如当前:

onlyoffice.o2oa.net 是 onlyoffice 服务器域名,yangli.o2oa.net 是 o2oa 服务器域名

连接 O2云

此前我们已使用管理员账号登录系统,此时点击左上角主菜单——打开系统设置——进入云服务配置,可看到如下界面:

第一个绿色对勾表示服务器在网络上可以连接到 O2OA 的云服务器;第二个红色叉号表示我们尚未登录到 O2OA 云服务器。

如果您以前创建过 O2云账号,可在此处选择“登录到 O2云”;当前为新建服务器,因此点击“注册 O2云账号”创建新账号。

填写所有信息后,点击“注册 O2云账号”,若信息填写无误,系统将自动使用该账号登录 O2云服务。

  这里说明一下 O2云服务:它提供应用市场,登录 O2云服务后,服务器会自动更新云服务器上应用市场的目录列表,本地服务器才能及时获取应用及其更新。

  如果您的服务器部署在内网,且出于安全性要求不允许连接外部网络,则可以在允许访问外网的机器上运行一台临时的 O2OA 服务器,连接到 O2云后访问应用市场,安装所需应用并导出为 .xapp 文件。然后访问内网服务器,通过应用中心的导入应用功能,将本地的 .xapp 文件导入服务器即可。(这部分内容将在系统部署课程中详细介绍)

  O2云登录成功后,系统会自动同步应用市场,这可能需要几分钟;同步完成后即可访问应用市场。

在 O2OA 平台中接入 onlyoffice 在线协作

接下来,我们开始使用 onlyOffice 在线协作应用。如果 onlyoffice 在线协作应用还没有安装,需要先到应用市场中安装它。打开应用市场:

从应用市场中安装应用

  点击需要安装的应用后,需查看安装说明,并进入数据中心平台编译所有数据表(数据中心平台--office在线协作数据--数据表--document表--编译所有数据表),然后重启。

  安装好以后,就可以打开指定的链接使用了:http://{youip}/x_desktop/document.html?app=CloudDocument

Onlyoffice 在线协作功能介绍

创建一个 word 文档

把文档分享给其他人员


查看只读用户

用户权限查看

流程中嵌入 onlyOffice 控件

本节介绍如何使用 onlyoffice 控件作为正文编辑器。

创建一个公文应用

通过公文模版创建表单,输入表单名称:公文-编辑

在正文部分拖入一个 onlyOffice 控件,现在可以直接使用。

在应用市场下载 onlyOffice 控件

打开系统菜单,找到应用市场:

注意点:重启服务器并正常启动

配置 only Office 控件与服务器的连接

配置 onlyOffice 的服务器地址:浏览器中打开该地址,把红框中的 office.o2oa.net 改为对应的 onlyOffice 服务器名称。

http://yangli.o2oa.net/o2_lib/onlyoffice/config.html

截图部分对应修改为已安装的 onlyoffice 服务器地址,我们这边就配置成已经搭建好的 onlyoffice 服务器: only.o2oa.net(以自己的服务器域名为主,域名需要与 O2OA 服务器同域)。

补充说明后,我们再回到表单编辑器。

保存编辑表单,接下来创建阅读表单。编辑表单与阅读表单分别用于不同的处理环节。

在阅读表单中,将正文部分替换为 onlyOffice 的控件。

表单名称保存为:公文-阅读

表单设计完成后去设计流程:先确定环节名称和流程名称,并关联已设计好的表单。拟稿、核稿、套红环节使用编辑表单,可以编辑正文;确认环节使用阅读表单,对正文只能查看不能修改。配置处理人员,核稿和套红分别选择对应的处理人,然后保存流程设计。

如需对文字内容进行批注,再回到编辑表单配置,开启评论功能。

至此,已完成在 CentOS 上安装 ONLYOFFICE Docs Developer Edition 以及在 O2OA 平台上接入 OnlyOffice 的工作。

相关问题讨论

如何修改 OnlyOffice 配置连接本地部署的 OnlyOffice Docs 服务器?

Developer Edition 允许您在本地服务器上安装 ONLYOFFICE Docs 并将在线编辑器与您的 Web 应用程序集成。

查看原帖讨论 · 15,161 次浏览

传递到 onlyoffice 服务的 o2oa 的 ip 是127.0.0.1.onlyoffice 因此报错

去配置的 onlyOffice 的服务器地址:浏览器打开地址: 把红框中的 office.o2oa.net 改成对应的 onlyOffice 服务器名字。

查看原帖讨论 · 14,946 次浏览

o2oa 在线协作,onlyoffice 打开历史版本,一直在加载状态

接下来,我们开始使用这个 onlyOffice 在线协作的应用。

查看原帖讨论 · 52,920 次浏览

相关内容

O2OA 翱途 企业应用开发平台

兰德网络O2OA平台软件

开源、自主可控的协同办公底座

研发与运营

纵横翱途(杭州)科技有限公司

企业级协同应用 · 工作流引擎 · AI 智能体

www.o2oa.net | 400-888-0545

上一篇:系统配置-流程催办提醒配置

下一篇:cpu64核以上服务器启动报错的问题解决办法