在線協(xié)作文檔的全開(kāi)源部署方案

中圖分類(lèi)號(hào)：G434文獻(xiàn)標(biāo)識(shí)碼：A論文編號(hào)：1674—2117（2025）20—0085-04

前言

在數(shù)字化教育背景下，在線協(xié)作文檔（如騰訊文檔、金山文檔等）因其便捷的實(shí)時(shí)協(xié)作和云端存儲(chǔ)功能，已成為提升教學(xué)效率的重要工具。這些工具不僅契合《義務(wù)教育信息科技課程標(biāo)準(zhǔn)（2022年版）》中“網(wǎng)絡(luò)”和“信息處理”兩大邏輯主線的教學(xué)要求，還能有效支持項(xiàng)目式學(xué)習(xí)、小組合作學(xué)習(xí)等學(xué)習(xí)方式，幫助學(xué)生提升數(shù)字化學(xué)習(xí)與創(chuàng)新素養(yǎng)。

然而，當(dāng)前在線協(xié)作文檔的推廣應(yīng)用面臨三重挑戰(zhàn)：一是商用解決方案的高昂費(fèi)用使許多經(jīng)濟(jì)欠發(fā)達(dá)地區(qū)的學(xué)校難以承擔(dān)；二是云端服務(wù)對(duì)網(wǎng)絡(luò)環(huán)境的依賴性導(dǎo)致在基礎(chǔ)設(shè)施薄弱地區(qū)使用時(shí)穩(wěn)定性不足；三是教育數(shù)據(jù)上云帶來(lái)的隱私安全風(fēng)險(xiǎn)不容忽視。針對(duì)這些問(wèn)題，本文提出基于本地化部署的全開(kāi)源解決方案，旨在通過(guò)構(gòu)建自主可控的在線協(xié)作文檔平臺(tái)，在保障數(shù)據(jù)安全的同時(shí)，以更低成本實(shí)現(xiàn)穩(wěn)定可靠的教學(xué)協(xié)作支持。

兩種開(kāi)源在線協(xié)作文檔

1.ONLYOFFICE Docs

ONLYOFFICEDoCs（全稱為ONLYOFFICEDocumentServer）是一款功能強(qiáng)大的在線辦公套件，支持文檔、表格、演示文稿的在線編輯與協(xié)作。其主要特點(diǎn)包括：兼容Microsoft Office格式（docx、xlsx、pptx等）；提供與主流桌面辦公軟件相似的編輯體驗(yàn)；支持多人在線同時(shí)編輯；具備評(píng)論、修訂、版本歷史等功能。ONLYOFFICEDocs開(kāi)源版對(duì)單個(gè)文檔最多支持20人同時(shí)編輯，超出20以后的訪問(wèn)將進(jìn)人只讀模式。由于日常教學(xué)中每組一般在6人以內(nèi)，因此開(kāi)源版可以很好地滿足教學(xué)需要。

ONLYOFFICEDocs僅提供后臺(tái)服務(wù)，其本身不具備數(shù)據(jù)存儲(chǔ)和賬號(hào)管理功能，需要與第三方共享平臺(tái)搭配才能實(shí)現(xiàn)在線協(xié)作編輯。開(kāi)源的DzzOffice平臺(tái)支持豐富的權(quán)限管理、版本控制等功能。

2.Etherpad

Etherpad是一款輕量級(jí)的在線文本編輯器，具備簡(jiǎn)單高效的多人協(xié)同編輯功能。其主要特點(diǎn)包括：支持多用戶同時(shí)在線編輯，所有更改即時(shí)同步顯示，適用于課堂討論、小組寫(xiě)作等場(chǎng)景；界面簡(jiǎn)潔，無(wú)需復(fù)雜操作即可快速上手，適合各年齡段師生使用；支持通過(guò)插件增強(qiáng)功能（如表格、代碼高亮、導(dǎo)出PDF等），滿足多樣化教學(xué)需求等。

與ONLYOFFICE Docs支持豐富的辦公文檔格式相比，Etherpad專注于提供簡(jiǎn)單的文本編輯。相對(duì)而言，Etherpad更輕量化，學(xué)生無(wú)需注冊(cè)登錄即可使用（可設(shè)置編輯人姓名），且可以獨(dú)立運(yùn)行，部署起來(lái)也更簡(jiǎn)單。

全開(kāi)源部署方案架構(gòu)

下面，筆者依次介紹上述兩種在線協(xié)作文檔的部署方式，部署方案采用“客戶端一服務(wù)端”的CS架構(gòu)（如圖1）。

雖然ONLYOFFICEDocs和Etherpad均有Windows系統(tǒng)的部署方案，Docker也有適合Windows系統(tǒng)的版本（Docker Desktop），但是為保證服務(wù)穩(wěn)定性、提高資源利用率、簡(jiǎn)化部署流程、降低部署難度，建議使用Linux系統(tǒng)，可直接在教師機(jī)或服務(wù)器安裝Linux操作系統(tǒng)，也可使用虛擬機(jī)。本文將基于虛擬機(jī)部署演示。

部署準(zhǔn)備

1.開(kāi)源虛擬機(jī)VirtualBox

VirtualBox是Oracle公司開(kāi)發(fā)的虛擬機(jī)軟件，它的特點(diǎn)是開(kāi)源、免費(fèi)、操作界面簡(jiǎn)單明了。虛擬機(jī)屬于平臺(tái)虛擬化技術(shù)，它通過(guò)硬件或軟件技術(shù)支持，將有限的硬件資源虛擬成多個(gè)可共用的虛擬資源，這些虛擬資源所具有的功能與所虛擬的真實(shí)硬件資源，如硬盤(pán)、內(nèi)存、光驅(qū)等是等效的，用戶所使用的虛擬資源與真正的物理資源無(wú)異。簡(jiǎn)單來(lái)說(shuō)就是在一臺(tái)真實(shí)的計(jì)算機(jī)上運(yùn)行多臺(tái)虛擬計(jì)算機(jī)，它們的配置和操作系統(tǒng)可以根據(jù)用戶需要自定義。

圖1部署方案架構(gòu)

2.開(kāi)源操作系統(tǒng)Linux

Linux是一套免費(fèi)使用和自由傳播的類(lèi)UNIX操作系統(tǒng)，具有出色的安全性、靈活性和穩(wěn)定性等優(yōu)勢(shì)。Linux有上百種不同的發(fā)行版，如Debian，Ubuntu，CentOS等。本文選用的是Debian12操作系統(tǒng)。

3.Docker

Docker是基于Go語(yǔ)言實(shí)現(xiàn)的開(kāi)源項(xiàng)目，是為開(kāi)發(fā)人員設(shè)計(jì)的，以容器調(diào)度和資源分割為單位，封裝了整個(gè)軟件運(yùn)行的環(huán)境，用于構(gòu)建、發(fā)布和運(yùn)行應(yīng)用的平臺(tái)。Docker設(shè)計(jì)之初的目的是“Build，Ship AndRun Any App、Anywhere\"，其理念使程序?qū)崿F(xiàn)了“一次封裝，到處運(yùn)行”。[4正因如此，Docker受到許多開(kāi)發(fā)者的青睞，成為流行的開(kāi)源項(xiàng)目，越來(lái)越多的開(kāi)源項(xiàng)目都提供了Docker部署方案，大大簡(jiǎn)化了部署流程，降低了部署難度。使用

表1

Docker部署項(xiàng)目的基本流程是：先從Docker的倉(cāng)庫(kù)（Repository）中獲取鏡像（Image）文件，再使用鏡像文件創(chuàng)建容器（Container）并運(yùn)行。

部署流程

1.系統(tǒng)安裝

① 安裝虛擬機(jī)軟件VirtualBox。 ② 創(chuàng)建虛擬機(jī)，安裝操作系統(tǒng)。ONLYOFFICEDocs對(duì)操作系統(tǒng)配置有基本要求（如表1），因此在創(chuàng)建虛擬機(jī)時(shí)要注意設(shè)置以滿足配置需求，防止部署失敗。筆者安裝的操作系統(tǒng)為Debian12，建議跳過(guò)VirtualBox的自動(dòng)安裝，安裝時(shí)手動(dòng)設(shè)置國(guó)內(nèi)的軟件源以提高后續(xù)部署速度。如果不熟悉Linux系統(tǒng)，可以安裝圖形化界面，方便日常文件操作。在系統(tǒng)安裝完成后，建議設(shè)置虛擬機(jī)的IP地址為固定IP地址，方便后續(xù)訪問(wèn)。 ③ 以root身份登錄系統(tǒng)。由于部署過(guò)程需要獲取最高系統(tǒng)權(quán)限，所以使用root身份登錄。具體操作為：?jiǎn)?dòng)命令終端（Terminal），使用“suroot\"命令切換root身份，輸入密碼后登錄。

2.Docker部署

（1）更新軟件包

執(zhí)行命令“aptupdate”（注意本文所有命令均不包含兩側(cè)的雙引號(hào)）。

（2）安裝Docker

執(zhí)行命令“apt install -ydocker.io docker-compose”。

（3）驗(yàn)證安裝

執(zhí)行命令“docker-v”。如果返回Docker版本信息（如圖2），則表明docker安裝成功。安裝過(guò)程如果緩慢或安裝失敗，可以檢查軟件源是否設(shè)置為國(guó)內(nèi)源。

（4）添加國(guó)內(nèi)的Docker鏡像源

為了加快后續(xù)Docker鏡像的拉取速度，建議修改“/etc/docker/daemon.json\"文件，在“registrymirror”中添加國(guó)內(nèi)的鏡像源（如圖3，也可使用其他鏡像源）。具體命令如下：“nano/etc/docker/daemon.json\".Linux中的nano編輯器不支持鼠標(biāo)操作，注意查閱底部的操作說(shuō)明。可將命令中的“nano”替換“gnome-text—editor”，或直接啟動(dòng)圖形化文本編輯器程序修改該文件。

（5）重啟Docker

依次執(zhí)行命令“systemctl daemon-reload\"和“systemctlrestart docker”

3.ONLYOFFICE DoCs部署

（1）拉取鏡像

執(zhí)行命令“dockerpullonlyoffice/documentserver\"。

（2）創(chuàng)建容器并啟動(dòng)

執(zhí)行命令“dockerrun -i -t -d -p 80：80-restart=always -e JWT_ENABLED °leddash 1 --nameonlyofficeonlyoffice/documentserver\"（命令參數(shù)解釋如表2）。Docker會(huì)全自動(dòng)進(jìn)行部署，需要耐心等待一段時(shí)間。

（3）檢查程序運(yùn)行情況

在虛擬機(jī)中使用瀏覽器訪問(wèn)“http：//127.0.0.1：80”，如果返回圖4界面，表明部署成功。

（4）修改配置文件

執(zhí)行命令“dockerexec-itonlyofficebash\"，在onlyoffice容器中啟動(dòng)交互式終端，執(zhí)行命令“nano/etc/onlyoffice/documentserver/local.json\"，在\"CoAuthoring\"字段中添加如圖5所示的參數(shù)，保存后執(zhí)行“supervisorctl restart all\"重啟服務(wù)，最后執(zhí)行“exit”命令退出容器終端。

（5）設(shè)置端口轉(zhuǎn)發(fā)

由于VirtualBox中虛擬機(jī)的默認(rèn)聯(lián)網(wǎng)方式為單向NAT（網(wǎng)絡(luò)地址轉(zhuǎn)換）模式，僅允許虛擬機(jī)通過(guò)宿主機(jī)（運(yùn)行VirtualBox軟件的計(jì)算機(jī)，本文指教師機(jī)或服務(wù)器）的IP地址對(duì)外訪問(wèn)，局域網(wǎng)其他計(jì)算機(jī)無(wú)法訪問(wèn)虛擬機(jī)。為了方便DzzOffice連接ONLYOFFICEDoCs，將宿主機(jī)的IP地址和端口號(hào)轉(zhuǎn)發(fā)到虛擬機(jī)的80端口（ONLYOFFICEDoCs默認(rèn)端口號(hào)）。

具體操作如下：關(guān)閉虛擬機(jī)操作系統(tǒng)，依次點(diǎn)擊“設(shè)置一網(wǎng)絡(luò)一網(wǎng)卡2”，勾選“啟用網(wǎng)絡(luò)連接”，連接方式為“網(wǎng)絡(luò)地址轉(zhuǎn)換（NAT）”，點(diǎn)擊“端口轉(zhuǎn)發(fā)”進(jìn)行配置。本文中虛擬機(jī)的IP地址為“10.0.3.15”，ONLYOFFICE Docs的端口號(hào)為80，宿主機(jī)的IP地址為“192.168.14.26”，可按圖6所示進(jìn)行設(shè)置。在重新啟動(dòng)虛擬機(jī)后，即可在局域網(wǎng)直接訪問(wèn)服務(wù)器（http：//192.168.14.26：80）使用ONLYOFFICEDoCs服務(wù)。

（6）在DzzOffice中設(shè)置API

進(jìn)入DzzOffice的管理后臺(tái)，在應(yīng)用市場(chǎng)中安裝“onlyoffice”擴(kuò)展應(yīng)用，根據(jù)部署的實(shí)際情況設(shè)置API地址（如圖7），并啟用插件。至此，部署完成，在分配文檔權(quán)限后，即可實(shí)現(xiàn)在DzzOffice中協(xié)作編輯。

4.Etherpad部署

（1）拉取鏡像

執(zhí)行命令“docker pulletherpad/etherpad\"

圖6端口轉(zhuǎn)發(fā)設(shè)置

圖7DzzOffice中onlyoffice擴(kuò)展配置

表3

（2）創(chuàng)建容器并啟動(dòng)

執(zhí)行命令“dockerrun-i -t -d -p 9001：9001-restart=always-e'ADMIN_PASSWORD O= 123456 --nameetherpad etherpad/etherpad\"（參數(shù)解釋如上頁(yè)表2、表3）。

（3）訪問(wèn)或管理Etherpad

輸入IP地址和端口號(hào)訪問(wèn)，管理界面網(wǎng)址為：“IP地址：9001/admin”。

（4）設(shè)置端口轉(zhuǎn)發(fā)

將宿主機(jī)的IP地址和端口號(hào)轉(zhuǎn)發(fā)到虛擬機(jī)的9001端口（參考上文），以便師生通過(guò)局域網(wǎng)訪問(wèn)Etherpad服務(wù)。

結(jié)語(yǔ)

本方案提供了一種教學(xué)導(dǎo)向的在線協(xié)作文檔部署思路，通過(guò)開(kāi)源工具與容器化技術(shù)，降低了技術(shù)門(mén)檻與運(yùn)維成本。ONLYOFFICEDocs適合文檔協(xié)作類(lèi)任務(wù)，Etherpad則能滿足輕量化的課堂實(shí)時(shí)互動(dòng)需求，兩者結(jié)合可靈活適配不同教學(xué)場(chǎng)景。教師可通過(guò)此平臺(tái)引導(dǎo)學(xué)生體驗(yàn)協(xié)同編輯、版本管理等數(shù)字化技能，同時(shí)保障數(shù)據(jù)安全。

參考文獻(xiàn)：

[1苗宣衍.利用DzzOffice快速搭建信息技術(shù)作業(yè)平臺(tái)[J].中國(guó)信息技術(shù)教育，2022（06）：.73-75.

[2]楊培康.在VirtualBox虛擬機(jī)上安裝Linux操作系統(tǒng)[J].華東科技，2024（O4）.111-113.

[3]盧道設(shè)，許燦，張志青，等.虛擬機(jī)技術(shù)在實(shí)踐教學(xué)中的應(yīng)用[J].軟件導(dǎo)刊，2014，13（06）：165-167.

[4]金琦.初識(shí)D0CKER容器技術(shù)[J.中國(guó)信息技術(shù)教育，2019（Z3）：105-109.e