ONLYOFFICE如何与Moodle集成连接

ONLYOFFICE如何与Moodle集成连接

• Moodle网络教学系统
• 互联架构
• ONLYOFFICE文档服务器安装
• 互联网在线版
• 本地私有云版
• 在Moodle中配置ONLYOFFICE连接器插件

从公元纪年进入New冠历纪元之后，学校教育就变成了旧时代的老古董，现代时兴的是网络线上教学，即使是体育课，也是用摄像头照着小孩在家里屋子里面做。

Moodle网络教学系统

我们固然可以用各种社交聊天软件的视频联线模式来线上教学，但是在教学里面特有的课程功能、考试功能、评分功能……等等，还是需要专业的网络教学软件平台来实现的，该领域软件有不少，最大的还是软件巨头微软的MicroSoft School，当然最昂贵的也是微软的产品解决方案，微软出什么商业软件，开源世界就会对标微软所出的商业软件开发开源姓Gnu的自由免费软件，对应MS School的就是Moodle这个软件平台，比如下图：

就是学习法国古代文学，伏尔泰的小说《老实人》（康迪德）的界面。

Glitter and be Gay

Moodle不是个消费者个人软件，而是面向学校的服务器软件产品，最典型的场景，就是一个学校计划搭建学校自己的网课系统，自然是要学校自己的各科老师来提供各门课程的具体教学内容，但是这个网课网站以及网课功能，是不能麻烦各科老师来做的，就好像你不能让体育老师来教语文一样。

一般的情况都是学校有一个专门的信息办公室，招聘几名专业的计算机程序员工程师，购买云主机、域名，去有关部门报备网站后，从底层的Linux操作系统开始安装，然后安装网站服务包括数据库、php等，然后再安装网课服务，比如这里介绍的Moodle，配置好提供给各科老师在上面建造教学内容。

因此，一个Moodle搭建的学校，除了学生账号、老师账号之外，还有上图中的管理员账号，就是信息办的这些网络工程师，当然，如图中还有家长的账号，可以查看自家孩子的学习成绩，所谓的特别被校方强调的家校协同。

这种学习系统是B/S架构，就是客户端使用各种标准的Browser浏览器即可访问使用服务器Server端提供的服务。

而对于服务器端有两种方式，一种是购买SaaS即Software-as-a-Service（软件即服务），不管是Moodle官方还是Moodle的认证服务供应商，很多都是在那座Wall之外的，从国内访问使用不是卡慢就是无法连接，因此服务器端的另外一种方式就是买国内的云主机、域名、网站备案，下载开源的Moodle服务器程序安装包，学校自己安装搭建网课系统，这才是国内学校使用Moodle这类开源网课系统的正确方式，当然这需要学校的信息办公室的程序员们非常给力，以及学校领导足够大方给予充足的经费购买主机域名以及人员工资开支。

那为什么要把ONLYOFFICE和Moodle集成互联呢？还是以上文所截取的法国文学伏尔泰作品为例，在我们打开这个页面点击这个文件的时候，网页浏览器就会打开一个对话框要你选择一个本地文件夹用来下载这个.docx文件，然后你再在你自己的电脑里面打开一个office软件来打开查看这个文件来学习

现代浏览器只能在线打开pdf文件，而对于各种网页里的docx、pptx、xlsx格式文件只会下载到本地来再使用office办公类软件打开，而如果我们在服务器端把ONLYOFFICE文档服务器集成之后，客户端网页浏览时就可以不用下载到本地了，直接在浏览器里面在线打开文档了，就像下面这样的效果

浏览器里面就直接打开一个非常类似于M$ Word的窗口，按照系统管理员、老师分配给你的权限，只读、或者可以修改、或者可以评论批注等各种操作，还可以有各种ONLYOFFICE的插件，比如图中的语音朗读功能，就可以直接在浏览器里面自动念给你听，类似现在特别火的网络听书功能。

ONLYOFFICE文档提供了一系列协作工具，包括2种协同编辑模式、跟踪更改、版本历史记录、评论以及内置聊天功能等等，网络文档可以配置赋予不同的访问权限控制。此套件能够与多种DMS网络文件管理系统服务以及文件共享平台（如：Moodle、Nextcloud、ownCloud、Confluence、Alfresco、SharePoint、Liferay、Nuxeo 等）进行集成。

那么究竟如何把ONLYOFFICE和Moodle集成互联互通互操作呢？

互联架构

ONLYOFFICE的文档服务器实例必须能够访问Moodle的服务器地址，或者是内网直接ip地址访问，或者是公网通过域名访问，并且是以POST方式连接至Moodle服务器，这需要在服务器上的防火墙开放80和443号网络端口号的进站连接，反过来，Moodle服务器也必须能够访问ONLYOFFICE的文档服务器地址，或者是内网直接ip地址访问，或者是公网通过域名访问，客户端正常访问Moodle服务器使用Moodle的功能，在打开办公文档的时候，自动访问使用ONLYOFFICE的文档服务器提供的文档打开、编辑、协同的功能。

ONLYOFFICE文档服务器安装

如果你是购买的SAAS软件既服务的Moodle服务器，那么你是否能在其基础上集成连接ONLYOFFICE的文档服务，那就依赖于你的软件服务商是否提供集成扩展功能了，需要认真咨询你的软件服务商了。如前所述，本文推荐的是学校抛弃SAAS而直接自己买云主机或真实服务器在内网搭私有云服务的方式。

对于该服务器实例，硬件要求如下：

• CPU：双核，至少 2 GHz。

• RAM：2 GB 及以上

• HDD：最少 40 GB。

• Swap：最少 4 GB。

• OS：Ubuntu 20.04 或更早版本

安装ONLYOFFICE文档服务器的最简单方式是通过Docker进行安装，这只需要一行命令即可：

sudo docker run -i -t -d -p 80:80 onlyoffice/documentserver

互联网在线版

学校买公网云主机，比如国内的阿里云、华为云等，再配以备案登记域名，那样这个学校就可以给因为疫情而返乡回家的学生上网课了。ONLYOFFICE的文档服务器推荐再买一台云主机单独安装配置，也可以尝试在Moodle服务云主机上安装，这样就需要把网络服务端口号区别设置开来，不要互相冲突又能互相访问，开源软件所谓的自由就是，只要你懂Linux懂网络技术，可以尝试把两者安装在同一台云服务主机上面，比如之前这篇图文所讲述的：

手把手教你如何搭建一个多人协同写文档的服务器

把ONLYOFFICE的文档服务器和NextCloud网络文件服务器安装到同一台服务器主机上面，这也是前文为什么说学校领导要舍得花钱招聘高水平的运维开发工程师的原因。

关键的是要在Moodle里安装一个插件，就是ONLYOFFICE的文档服务器的连接器插件，安装非常简单，用Manager系统管理员身份登陆Moodle，按照下图所示，分别点击网站管理、插件之后：

选择您当前的Moodle版本，搜索ONLYOFFICE文档插件，点击“安装”按钮，然后点击“继续”，确认安装请求，检查插件验证报告。非常重要的一点是，您需要正确选择Moodle版本。如果您为Moodle服务器下载并安装了错误的插件版本，这可能会导致一些严重的问题，甚至是导致Moodle站点无响应。这种安装方式，该服务器必须得连接互联网才能如此安装，仅适合于互联网在线版本。

本地私有云版

那么如果你的学校为了网络安全原因而内外网隔离又该如何建设呢？那种安全要求很严格的单位里面，就像下图这样：

可以在外网下载安装文件，然后通过保密手续把安装文件拷贝进入内网来安装，具体的下载地址在这里：

moodle的ONLYOFFICE连接器[1]

或者在GitHub上的该连接器页面[2]

导入内网后，以管理员身份登录Moodle实例，前往“站点管理”部分，切换至“插件”标签页然后点击“安装插件”链接，通过文件选择器或拖拽上传onlyoffice-moodle-master.zip文件至相应字段并点击“从 ZIP 文件安装插件”按钮。检查插件验证报告并点击“继续”，在“当前发布信息 -> 服务器检查页”中点击“继续”，在“插件检查页”中点击“立即升级 Moodle 数据库”，点击“升级至新版本”页面中的“继续”。即可使用离线安装文件安装到内网Moodle服务器上。

在Moodle中配置ONLYOFFICE连接器插件

安装插件后将打开插件配置页面。此外也可在插件概览页面中点击设置，在这里也能找到ONLYOFFICE文档。在设置页面中，需要对以下参数进行配置：

• 在文档编辑服务地址字段中输入用于从Moodle中访问文档编辑服务的地址。该字段为必填项。

• 在文档服务器Secret字段中提供写入数据时所需的Secret。此Secret Key将用于在文档服务器收到请求时对JSON Web Token进行校验。

其它配置选项根据需求灵活配置，保存变更后即可在Moodle网络课程学习管理系统中使用ONLYOFFICE在线文档协同功能了。作为管理员，应该对ONLYOFFICE编辑器中的打印和下载选项进行限制。在课程页面中点击活动名称/链接，则会在浏览器中打开相应的ONLYOFFICE编辑器，这样您就能创建并编辑课程附件文档了，此外还能查看PDF文件、与其他用户进行实时协作等等。

参考文献：

[1] moodle的ONLYOFFICE连接器: https://moodle.org/plugins/mod_onlyoffice

[2] GitHub上的该连接器页面: https://github.com/ONLYOFFICE/moodle-mod_onlyofficeeditor/releases

[3] MoodleDownloads: https://download.moodle.org/#

[4] Mount Orange School: https://school.moodledemo.net

[5] WiKi page Moodle: https://zh.wikipedia.org/zh-cn/Moodle

[6] Download official ONLYOFFICE connectors for popular web services: https://www.onlyoffice.com/download-connectors.aspx?from=connector_moodle

[7] Moodle: https://moodle.com/

[8] ONLYOFFICE/moodle-mod_onlyofficeeditor: https://github.com/ONLYOFFICE/moodle-mod_onlyofficeeditor

[9] 如何借助 ONLYOFFICE 和 Moodle 在 Linux 上搭建协作式线上学习环境: https://blog.csdn.net/m0_68274698/article/details/125207688