如何在 Windows 上 使用 ONLYOFFICE 协作编辑文档

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

ONLYOFFICE Document Server提供文档协作的服务功能，支持Word，Excel和PowerPoint以及国产WPS的协作。但是这里告诉我们，需要进行文档管理和存储的二次开发。它api里现成的开发好的文档管理平台，有java，node.js,PHP等，可能不具备权限功能吧。

Please note, that ONLYOFFICE Document Server includes the documenteditor, document editing service, document command service and documentconversion service.The document manager and documentstorage service areeither included to Community Server or must be implemented by the softwareintegrators who use ONLYOFFICE Document Server on their own server.

它自己的ONLYOFFICE/CommunityServer就是管理文件用的，是一个庞大的项目管理系统。

ONLYOFFICE CommunityServer is a free open source collaborative system developed to managedocuments, projects, customer relationship and email correspondence, all in oneplace.

Nextcloud，可道云等云盘系统也支持ONLYOFFICE协作服务，我用Golang语言开发的EngineerCMS来实现ONLYOFFICE的文档管理和存储，调用ONLYOFFICE Document Server服务来进行文档协作，权限完全按照官方的community。

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

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

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

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

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

报表的汇总。

市场上协作的平台不下几十种，著名的如石墨，一起写，腾讯文档协作TIM，Google Doc，office365，office online等，基本按人月收费，免费的有人数限制，并且想自己部署在局域网的话也不大可能。你的文档上传给他们或许有诸多不便呢。比如银行的报表，嘿嘿，你懂的。

所以，我就在ONLYOFFICE Document Server基础上用Golang语言开发了文档管理和存储功能，方便大家免费无限制任意部署的需求。

总的思路就是比如在局域网的某台windows（或linux）电脑上安装docker容器来运行ONLYOFFICE Document Server，然后运行EngineerCMS来调用ONLYOFFICE Document Server的服务。在云服务器上部署也是一个道理。

ONLYOFFICE目前存在的缺点：汉字输入不是很方便，就是当输入符号的时候，它会重复将前面的汉字又输进去一次：解决办法，在设置里勾选象形文字（5.1.2新版已经解决这个问题）；Excel表格里的文字格式没有删除线、上下标之类，文本框中的文字有这些格式，Word中也有；QQ拼音输入法按空格不能输出汉字，（5.1.2新版已经解决这个问题）搜狗输入法可以；字体/样式选择里显示的是英文，不是汉字（用ps修改一下图片即可）；打开文档默认文字检查都是打开的，新版5.1.2版支持word目录，但没有文档结构（免费版不支持文档结构图，需要另外开发，已经有解决方案）。但瑕不掩瑜，它的功能还是很强大的，而且随着版本的更替，会解决这些问题的。

2、安装准备

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

环境是win7以上，win10以下。Win10区别就是安装的docker软件不同而已，win10不需要设置端口转发。

linux就更简单了。

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

第二步：下载和安装docker toolbox，默认安装即可。下载地址http://get.daocloud.io/，下载支持旧版windows的docker toolbox，win10就直接下载docker了。

第三步：启动docker后在里面拉取Onlyoffice Document Server 的Docker镜像

3、拉取ONLYOFFICE Document Server 的Docker镜像

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

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

用docker load < fei5onlyoffice5.3.4.tar命令。

建议用离线的，

（Administrator@604TFALNDKDKJWCMINGW64 ~

$ dockerexport -o onlyoffice-`date +%Y%m%d`.tar 6df）

$ docker import  onlyoffice-20180220-import.tar onlyoffice/documentserver

离线的包在我的网盘中：https://pan.baidu.com/s/1gf0ucuR，离线包有5个：

第一个是onlyoffice_load.tar，替换好了字体，修正了几个翻译错误，是用commit命令生成新的包后save导出的。

第二个是onlyoffice-20180220-import.tar，这个包虽然里面已经替换好了字体，但导入后暂时不知道怎样运行起来。

第三个是onlyofficedocumentserver-load.tar这个包就是原生态的pull下来的镜像打的包，用save命令打的包，用loader命令导入，然后运行，需要替换字体。

第四个是fei3onlyoffice.tar，这个包是用5.1.5版做成的，添加了字体，修改了几处界面翻译错误，修改了。

第五个是fei5onlyoffice5.3.4.tar，这个包是用5.1.5版做成的，添加了字体……

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

4、启动——映射至9000端口

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

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

5、替换 添加容器onlyofficedocument server的字体

在网盘中下载字体winfont压缩包。字体来源于https://github.com/neroxps/Docker-Only-Office-Chinese-font和win10系统，win10系统提取中文字体的方法：控制面板——搜字体——查看安装的字体——再在搜索栏输入中文 2个字，这些就是需要的中文字体了。有些体积大的字体就不要放了，免得OO启动太慢。

新版5.1.2已经支持中文字体，所以不用删除它自带的字体了。但只有文泉驿的3种字体，可以根据下文再增加一些字体。

//进入容器（运行的镜像）内，删除/usr/share/fonts下除truetype外其他文件和文件夹

$ docker exec -it 38e27 /bin/bash

root@38e27823ae92:/#dir或者ls –al

root@6dfa5705aaef:~#cd /usr/share/fonts/

root@6dfa5705aaef:/usr/share/fonts#ls

truetype  X11

//删除文件夹X11

root@6dfa5705aaef:/usr/share/fonts#rm -R dir X11

rm:cannot remove dir: No such file or directory

root@6dfa5705aaef:/usr/share/fonts#ls

truetype

root@6dfa5705aaef:/usr/share/fonts#cd truetype

root@6dfa5705aaef:/usr/share/fonts/truetype#ls -al

total462392

drwxr-xr-x11 root   root       4096 Feb 19 04:17 .

………………

//删除trutype文件夹下所有文件，除了custome文件夹外

root@6dfa5705aaef:/usr/share/fonts/truetype#rm -R dir *.*

rm:cannot remove dir: No such file or directory

root@6dfa5705aaef:/usr/share/fonts/truetype#rm -R dir *

rm:cannot remove dir: No such file or directory

rm:cannot remove custom: Device or resource busy

root@6dfa5705aaef:/usr/share/fonts/truetype#ls

custom

root@6dfa5705aaef:/usr/share/fonts/truetype#ls -al

total 12

drwxr-xr-x10 root root 4096 Feb 19 10:14 .

drwxr-xr-x  6 root root 4096 Feb 19 10:12 ..

drwxr-xr-x  2 root root 4096 Feb 19 03:48 custom

……

root@6dfa5705aaef:/usr/share/fonts/truetype#exit

exit

Administrator@604TFALNDKDKJWCMINGW64 ~/winfont

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

字体文件在我的网盘中：https://pan.baidu.com/s/1gf0ucuR

$ 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 run命令，要用docker start 容器id

完成后记得清理chrome浏览器缓存，否则还是乱码。设置—高级—隐私设置和安全性—清除浏览数据—时间范围选择时间不限……

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

修正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

7、连接数20个的限制

做完以上工作，你可以将修改后的容器保存为新的镜像，然后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://github.com/3xxx/EngineerCMS/releases下载编译好的二进制文件

或者直接去https://pan.baidu.com/s/1gf0ucuR下载软件包，直接运行engineercms即可用浏览器chrome访问127.0.0.1了，不用配置环境，因为它是golang语言编写的跨平台的可执行文件。如果运行出现闪退，则更改一下端口号。

（1）运行前要替换EngineerCMS\views\onlyoffice\onlyoffice.tpl中的3处IP，如果engineercms和docker安装在同一个电脑上，那么三个IP相同，见6.1节。

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

有问题联系我QQ504284，微信hotqin999

http://blog.csdn.net/hotqin888

6.1协作编辑页面要根据你的情况进行修改（ip地址、汉化界面）

一定要用ip，不要用localhost、127.0.0.1之类的代替本机ip，本机调试要用192.168.99.100

EngineerCMS\views\onlyoffice\onlyoffice.tpl：



   


    

//alert({{.Doc.FileName}}); window.docEditor = new DocsAPI.DocEditor("placeholder", { "document": { "fileType": "{{.fileType}}", "key": "{{.Key}}",//"Khirz6zTPdfd7" "title": "{{.Doc.FileName}}", "url": "http://运行engineercms电脑的ip:端口号/attachment/onlyoffice/{{.Doc.FileName}}" }, "documentType": "{{.documentType}}", "editorConfig": { "callbackUrl": "http://运行engineercms电脑的ip:端口号/url-to-callback?id={{.Doc.Id}}", "user": { "id": "{{.Uid}}", "name": "{{.Uname}}" }, "lang": "zh-CN",//"en-US",汉化 }, "height": "100%", "width": "100%" }); 安装docker电脑的ip:9000/web-apps/apps/api/documents/api.js"> //alert({{.Doc.FileName}}); window.docEditor = new DocsAPI.DocEditor("placeholder", { "document": { "fileType": "{{.fileType}}", "key": "{{.Key}}",//"Khirz6zTPdfd7" "title": "{{.Doc.FileName}}", "url": "http://运行engineercms电脑的ip:端口号/attachment/onlyoffice/{{.Doc.FileName}}" }, "documentType": "{{.documentType}}", "editorConfig": { "callbackUrl": "http://运行engineercms电脑的ip:端口号/url-to-callback?id={{.Doc.Id}}", "user": { "id": "{{.Uid}}", "name": "{{.Uname}}" }, "lang": "zh-CN",//"en-US",汉化 }, "height": "100%", "width": "100%" });

7、端口转发

http://blog.csdn.net/maodou95838/article/details/78194830?locationNum=1&fps=1#0-qzone-1-51693-d020d2d2a4e8d1a374a433f596ad1440

前文第4节运行ONLYOFFICE DOCUMENT SERVER：

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

-d:后台运行 

-p 9000:80 :端口映射，前一个9000代表虚拟机的端口，后一个80代表docker容器的端口 

命令执行完成后，可以通过http://192.168.99.100:9000访问OO服务的欢迎界面。

这时只能在你自己的机器上访问，同一个局域网中的其他机器是不能访问的，原因是：Windows上的docker是运行在一个虚拟机里面的，看官方给的图： 

 要让别的机器也访问到，需要配置一下虚拟机。设置如下： 

双击运行安装docker toolbox生成的Oracle VMVirtualBox。

点击端口转发：下图中主机IP为安装docker的电脑IP，主机端口为9000，子系统IP为192.168.99.100，子系统端口为9000。

这样配置完成后，别的机器也可以访问docker 容器了。

下文的开发仅供兴趣参考。

8、二次开发EngineerCMS

8.1 协作编辑页面

//alert({{.Doc.FileName}}); window.docEditor = newDocsAPI.DocEditor("placeholder", { "document": { "fileType": "{{.fileType}}", "key": "{{.Key}}",//"Khirz6zTPdfd7" "title": "{{.Doc.FileName}}", "url": "http://运行engineercms电脑的ip:端口号/attachment/onlyoffice/{{.Doc.FileName}}" }, "documentType":"{{.documentType}}", "editorConfig": { "callbackUrl": "http:// 运行engineercms电脑的ip:端口号/url-to-callback?id={{.Doc.Id}}", "user": { "id": "{{.Uid}}", "name": "{{.Uname}}" }, "lang": "zh-CN",//"en-US", }, "height": "100%", "width": "100%" });

8.2 协作页面的保存和回调

type Callback struct {
   Key         string   `json:"key"`
   Status      int     `json:"status"`
   Url         string   `json:"url"`
   Changesurl  string  `json:"changesurl"`
   History     history `json:"history"`
   Users       []string `json:"users"`
   Actions     []action `json:"actions"`
   Lastsave    string  `json:"lastsave"`
   Notmodifiedbool     `json:"notmodified"`
}
type action struct {
   Type   int
   userid string
}
type history struct {
 changes       []change
   serverVersionstring
}
type change struct {
   created string
   User    User1
}

type User1 struct {
   id   string
   name string
}

//关闭浏览器标签后获取最新文档保存到文件夹
func (c *OnlyController) UrltoCallback() {
   // pk1 :=c.Ctx.Input.RequestBody
   id :=c.Input().Get("id")
   //pid转成64为
   idNum, err :=strconv.ParseInt(id, 10, 64)
   if err != nil {
      beego.Error(err)
   }
   //根据附件id取得附件的prodid，路径
   onlyattachment,err := models.GetOnlyAttachbyId(idNum)
   if err != nil {
      beego.Error(err)
   }

   var callbackCallback
   json.Unmarshal(c.Ctx.Input.RequestBody,&callback)
   ifcallback.Status == 1 || callback.Status == 4 {
      c.Data["json"]= map[string]interface{}{"error": 0}
      c.ServeJSON()
   } else ifcallback.Status == 2 {
      resp, err :=http.Get(callback.Url)
      if err != nil{
         beego.Error(err)
      }
      body, err :=ioutil.ReadAll(resp.Body)
     if err != nil{
         beego.Error(err)
     }
      deferresp.Body.Close()
      if err != nil{
         beego.Error(err)
      }
      f, err :=os.create(".\\attachment\\onlyoffice\\"+onlyattachment.FileName)
      if err != nil{
         beego.Error(err)
      }
      deferf.Close()
      _, err =f.Write(body)
      if err != nil{
         beego.Error(err)
      } else {
         err =models.UpdateOnlyAttachment(idNum)
         if err !=nil {
            beego.Error(err)
         }
      }
      c.Data["json"]= map[string]interface{}{"error": 0}
      c.ServeJSON()
   }
}