如何在 Windows 上使用 ONLYOFFICE 协作编辑文档（更新）

q平面人

已于 2025-03-15 12:38:03 修改

阅读量10w+

点赞数 89

分类专栏： onlyoffice 水利项目管理水利信息化文章标签： ONLYOFFICE 实时文档协作 ENGINEERCMS beego golang

于 2018-02-19 20:21:39 首次发布

本文链接：https://blog.csdn.net/hotqin888/article/details/79337881

版权

onlyoffice 同时被 3 个专栏收录

45 篇文章

订阅专栏

水利信息化

41 篇文章

订阅专栏

水利项目管理

36 篇文章

订阅专栏

2025年3月15日更新

1、说明——可以加我qq504284沟通。

ONLYOFFICE API | ONLYOFFICE提供文档协作的服务功能，支持Word，Excel和PowerPoint以及国产WPS的协作。需要配套一个文档管理和存储服务（平台或系统，下文叫文档管理平台或文档管理服务吧）。它api里现成的开发好的文档管理平台案例，有java，node.js，PHP等，可能不具备权限功能吧。

Basic concepts | ONLYOFFICE

它支持接入

可道云等云盘系统也支持ONLYOFFICE协作服务。

我用Golang语言开发的EngineerCMS来实现ONLYOFFICE的文档管理、下载和存储和权限设置，调用ONLYOFFICE Docs服务来进行文档协作，权限完全按照官方的community。

协作的好处在于少了来回传递文档，少了汇总的负责人，特别是十多人合作编写文档的时候，汇总的工作量大，容易出错，任何人稍微修改一点，都要重新传递整个文档，汇总后还要再次发给大家核对……。

协作也可以应用于校审流程，校核和审查直接在文档上修改即可。

其他如月报的合作，工作任务表的更新：每个人的任务表要随时更新，除非用专业的任务管理软件，否则用Excel表格的话，也是要负责人汇总更新表格，应付领导检查。

会议纪要写好了，把链接发给大家，有意见直接在上面修改补充。

投标要多人协作的话，用这个平台也是不错的。

报表的汇总。

市场上协作的平台如腾讯文档，office365，WPS等，基本按人月收费，免费的有人数限制，并且想自己部署在局域网的话也不大可能。你的文档上传给他们或许有诸多不便呢。比如银行的报表，嘿嘿，你懂的。

所以，我就在onlydocs基础上用Golang语言开发了文档管理、存储、下载和权限设置等功能，方便大家免费无限制任意部署的需求。

总的思路就是比如在局域网的某台windows（推荐用linux-centos，因为很稳定）电脑上安装docker容器来运行ONLYOFFICE Docs，然后在EngineerCMS里设置好onlydocs服务的ip、端口号即可。在云服务器上部署也是一个道理。

特别提醒：

1是要改default.json，允许私有ip上的文件下载，

2是文档下载服务的接口要改一下，documentType返回是word，cell,slide和pdf。

3是docker要新版，为了能装新版docker，linux内核要新；

4是web页面要简化，官方完整的可能导致无法编辑，或者说不要带history功能，

5是docker run是否要关闭token，要看文档服务系统那边功能情况，

6是不要用127.0.0.1和localhost这样的地址，

7是尽量避免虚拟机里装docker，因为和文档下载服务那边的通信可能有问题；

8是文件下载服务必须和docker在一个系统里，据说docker不能跨系统来下载外面的文件。

ONLYOFFICE随着版本的不断更迭，功能越来越接近MSOFFICE，比如有文档结构（word文档导航），历史版本的对照功能，excel里的文字删除线、筛选、透视表等。

2、安装准备

推荐用linux系统，稳定，用几十年不用动。需要注意的是，盘的分区和文件存放的位置要弄好，不然容易把盘充满。

如果是局域网，部署的电脑拥有固定ip（下文叫宿主机，切记）。电脑能打开cup的虚拟功能。如果部署到云主机，道理是一样的。

环境是win7以上，win10，win11。

Win10区别就是安装的docker软件不同而已（win10不要安装docker toolbox了），win10不需要设置端口转发。

第一步：确定电脑打开了cpu虚拟打开。https://jingyan.baidu.com/article/22fe7ced3b4c003002617f17.html

第二步：下载和安装docker toolbox（win7）/docker（win10），默认安装即可。下载地址DaoCloud | Docker 极速下载，下载支持旧版windows的docker toolbox。win10就直接下载docker了。切记，win7下安装完成docker后，启动docker的时候断网，启动后可以联网。win10安装完docker后在cmd里执行docker命令。

第三步：启动docker后在里面拉取Onlyoffice Docs 的Docker镜像，然后运行即可。

下面过程看起来繁琐，等你理解后其实就2步：安装docker，拉取镜像（或导入离线包），然后运行。linux上也是这2步。再就是在文档管理平台上配置一下IP和端口。

3、拉取ONLYOFFICE Docs 的Docker镜像（可选）

拉取镜像：启动docker，在里面输入命令docker pull onlyoffice/documentserver

（注意：win7下的docker要断网启动！！切记，启动后再联网。如果已经运行了onlyoffice document server，下次开机，重新启动docker后，不需要再运行onlyoffice的，当你启动docker后，OO已经启动了）

可以用我做好的镜像导入（离线包导入），已经导入好了中文字体，修正了几个翻译错误，可以省略第5步，从第4步直接跳过第5步到第6步。

建议用离线的，导入离线包命令为：docker load < fei6onlyoffice5.4.2.tar

fei6onlyoffice5.4.2.tar，这个包解决了中文字体名称问题。

下载放到docker命令行对应的目录下，方便运行命令导入(load)这个镜像。一般在c盘-users-administrator或者其他用户名下（在docker命令行里输入dir，看看当前目录下有哪些文件，一般就能找到这个目录了。）

4、启动——映射至9000端口（运行镜像后变成容器）

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

如果是导入的镜像，上面的命令中onlyoffice/documentserver用镜像id代替，查阅镜像用docker images命令。

运行后就可以通过http://192.168.99.100:9000访问OO服务的欢迎界面了，运行后的我们称之为容器。

5、添加容器onlyofficedocument server的字体（可省略）

在网盘中下载字体winfont压缩包。字体来源于GitHub - neroxps/Docker-Only-Office-Chinese-font和win10系统，win10系统提取中文字体的方法：控制面板——搜字体——查看安装的字体——再在搜索栏输入中文 2个字，这些就是需要的中文字体了。OO首次加载会比较慢，因为加载中文字体，一般达到50M以上。需要精简字体的方法，可以查阅网络或找我。

Administrator@604TFALNDKDKJWCMINGW64 ~/winfont

//将当前文件夹C:\Users\Administrator\下的winfont文件夹内的字体全部拷贝到容器的文件夹/usr/share/fonts/truetype中

$ tar -cv * | docker exec -i 6df tar x -C/usr/share/fonts/truetype

kaiu.ttf

msjh.ttc

msjhbd.ttc

msjhl.ttc

msyh.ttc

msyh.ttf

msyhbd.ttc

msyhl.ttc

simfang.ttf

simhei.ttf

simkai.ttf

simli.ttf

simsun.ttc

simsunb.ttf

simyou.ttf

……

Administrator@604TFALNDKDKJWCMINGW64 ~/winfont

//进入容器内

$ docker exec -it 6df /bin/bash

root@6dfa5705aaef:/#sudo mkfontscale

root@6dfa5705aaef:/#sudo mkfontdir

root@6dfa5705aaef:/#sudo fc-cache -fv

/usr/share/fonts:caching, new cache contents: 0 fonts, 1 dirs

…………

fc-cache:succeeded

root@6dfa5705aaef:/#exit

exit

//退出容器

Administrator@604TFALNDKDKJWCMINGW64 ~/winfont

$ docker exec 6df /usr/bin/documentserver-generate-allfonts.sh

GeneratingAllFonts.js, please wait...Done

onlyoffice-documentserver:docservice:stopped

onlyoffice-documentserver:docservice:started

onlyoffice-documentserver:converter:stopped

onlyoffice-documentserver:converter:started

如果机器重启后，断网情况下启动docker，此时不需要再运行docker run命令，OO服务已经随DOCKER启动了。

完成后记得清理chrome浏览器缓存，否则新导入的字体不会生效。chrome浏览器：设置—高级—隐私设置和安全性—清除浏览数据—时间范围选择时间不限……

具体替换字体的命令见下图，很详细具体了。

插图上写的界面汉化不对，这些只是导入中文字体而已，和界面汉化无关。界面中汉化其实就是在页面中将 "lang": "zh-CN"

修正excel、word、ppt翻译错误：

Administrator@604TFALNDKDKJWC MINGW64 ~/zh

$ docker exec -it 6df /bin/bash

root@6dfa5705aaef:/#cd /var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale/

root@6dfa5705aaef:/var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale#ls

cs.json en.json fr.json ja.json nl.json pt.json sk.json tr.json vi.json

de.json es.json it.json lv.json pl.json ru.json sl.json uk.json zh.json

root@6dfa5705aaef:/var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale#exit

exit

Administrator@604TFALNDKDKJWC MINGW64 ~/zh

$ tar-cv zh.json | docker exec -i 6df tar x -C /var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale/

zh.json

word的翻译文件/var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/locale/

$ tar-cv zh.json | docker exec -i 6df tar x -C /var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/locale/

6、还可以替换帮助文件为中文……

/var/www/onlyoffice/documentserver/apps/presentationeditor/main/resources/help/zh/Contents.json

/var/www/onlyoffice/documentserver/apps/spreadsheeteditor/main/resources/help/zh/Contents.json

/var/www/onlyoffice/documentserver/apps/documenteditor/main/resources/help/zh/Contents.json

做完以上工作，你可以将修改后的容器保存为新的镜像，然后save导出后给其他机器用。

docker commit将修改后镜像保存到本地，参数是容器ID，新名字:版本标志

#docker ps -all

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

b3426410ff43 centos:7 "/bin/bash" 4 minutes ago Exited (0) 4 seconds ago centos7ssh

#docker commit b59myimage/centos7-ssh（这个是例子）

下次可以输入刚保存的名字启动修改了字体的镜像了。

导出镜像——一定要导出保存，否则docker经常自己升级，容器啊，镜像啊，都会丢失，追悔莫及。

所以，启动docker的时候要关闭网络，否则它自动升级。等docker完全启动后，再打开网络。

docker save -o onlyoffice.tar onlyoffice/documentserver

6、运行和修改文档管理平台EngineerCMS

你可以直接去https://github.com/3xxx/engineercms查看源码，自己编译。

也可以去链接：https://pan.baidu.com/s/1f4zuhoymaHMN_QAEgZLwOg
提取码：upvm下载软件包，推荐进入cmd命令行界面里，进入engineercms的目录，输入engineercms允许，如果运行成功，即可用浏览器访问127.0.0.1:端口号了，不用配置环境，因为它是golang语言编写的跨平台的可执行文件。如果运行出现闪退，则在conf文件夹下更改app.conf文件中的端口号，或者修改runmode为prod模式。

（1）运行前要配置conf/app.conf文件里的，机器ip地址请用cmd命令行下，ipconfig命令来获取

#####配置onlyoffice#####
####1.onlyoffice的服务ip和端口号，或域名，如http://172.26.32.1:9000;https://zsj.itdos.net/
onlyofficeapi_url = http://192.168.100.37:9002
####2.engineercms服务的ip和端口号，或域名，如http://172.26.32.1:8081;https://zsj.itdos.net/
engineercmsapi_url = http://192.168.137.1:8081
####是否开启onlyoffice token,true or false#####
JWT_ENABLED = true
####onlyoffice token secret#####
onlyoffice_token_secret = ********

（2）docker toolbox访问前要按照下文中第7节中的方法设置宿主机（安装docker的电脑）virtualbox的端口转发。win10的windows docker不用设置端口转发了。

有问题联系我QQ504284，微信hotqin999

hotqin888的专栏_q平面人_CSDN博客