Windows部署kodbox可道云+Onlyoffice在线协同办公、office云编辑

发表于 更新于 分类于 阅读次数： Waline：

一、环境准备

硬件要求：

硬件 建议
CPU 2核心以上，加上onlyoffice建议4核及以上
内存 4G以上，加上Onlyoffice建议8G及以上
磁盘 500G以上

注意一点要纯净干净环境，没有安装过其它带Nginx/MySQL/PHP（已有环境不可安装）

二、安装宝塔面板

一）下载

官方下载地址：https://www.bt.cn/new/download.html

image-20230312143746633

二）安装宝塔

最好有两个盘，默认会安装到除C盘以外的其它盘。因为新系统对C盘的权限控制有要求，安装到C盘需要手动设置权限。

安装成功后打开以下面板工具箱。

在这里可以设置用户名和密码

iShot2023-03-12 17.55.38

打开面板会自动打开默认浏览器，并出现以下页面：

iShot2023-03-12 17.58.36

三、安装环境nginx+PHP+Mysql

打开宝塔后会推荐安装套件，我们采用一键安装就行。主要是能省不少事：

1、一键安装环境套件

1
2
3
4
5
Nginx: 1.18以上

Mysql：就装5.7就行

PHP：7.2、7.3

iShot2023-03-12 18.03.06

安装过程：

iShot2023-03-12 18.03.26

2、安装Redis

iShot2023-03-12 18.12.29

3、PHP设置：

1
2
a.安装Redis扩展
b.启用函数：exec、shell_exec

iShot2023-03-12 18.23.52

iShot2023-03-12 18.19.15

iShot2023-03-12 18.19.30

4、Msql设置

设置数据库root密码 务必记住数据库root用户的密码，后续安装kodbox的时候会用到。

image-20230311175514334

四、KodBox部署

一）下载kodbox网站源码

下载地址：https://kodcloud.com/download/

iShot2023-03-12 18.08.14

二）拷进站点根目录

a.目录：C(D):\www\wwwroot\127.0.0.1

b.解压zip文档

iShot2023-03-12 18.15.16

三）安装部署：

浏览器打开网站地址：127.0.0.1或localhost

1、注意检查环境是否满足、全部满足会打勾勾。

iShot2023-03-12 18.20.07

2、数据库配置：
1
2
3
4
5
a.我们这里选择Mysql数据库
b.服务器地址：填 127.0.0.1/localhost
c.用户名:root 密码：123456（之前设置好的）
d.Redis默认
e.其它默认

iShot2023-03-12 18.21.20

iShot2023-03-12 18.30.24

iShot2023-03-12 18.31.03

出现登陆界面部署成功：

iShot2023-03-12 18.31.16

五、Onlyoffice部署

一）Docker环境

1
有Windows Docker环境的可以直接路过，进入二），没有Docker请先安装Docker-for-windows

注意：Windows10版本要求1903 或更高版本，内部版本为 18362 或更高版本，低的版本不支持 WSL 2）

1、下载相关资源

docker安装程序Docker-For-Windows-Desktop

iShot2023-03-12 18.48.47

2、安装Docker-for-windows

iShot2023-03-12 18.52.22

iShot2023-03-12 18.54.32

3、容易出现问题及解决办法：

如果出现如下问题，请按下述方法解决，如果没有直接路过【问题解决】

iShot2023-03-12 21.03.24

  • 启用适用于 Linux 的 Windows 子系统

a.打开网址：https://learn.microsoft.com/zh-cn/windows/wsl/install-manual

b.以管理员身份打开 PowerShell（“开始”菜单 >“PowerShell” >单击右键 >“以管理员身份运行”），然后输入以下命令：

1
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  • 启用虚拟机功能

a.安装 WSL 2 之前，必须启用“虚拟机平台”可选功能。 计算机需要虚拟化功能才能使用此功能。

b.以管理员身份打开 PowerShell 并运行：

1
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

image-20230313120253321

  • 将 WSL 2 设置为默认版本

打开 PowerShell，然后在安装新的 Linux 发行版时运行以下命令，将 WSL 2 设置为默认版本：

1
wsl --set-default-version 2

4、出现启动成功画面说明问题解决了（不行的话再去百度）

iShot2023-03-13 10.06.28

到此Docker安装完成

二）准备Onlyoffice Docker镜像

下载我的Docker镜像：下载密码联系我。去20限制，添加十几套中文字体，手机编辑，秘钥控制访问。

iShot2023-03-12 20.39.39

下载地址：

Onlyoffice-v7.1

Onlyoffice-v7.2

Onlyoffice-v7.3

Onlyoffice-arm-v7.2

三）导入镜像

导入镜像包命令：

1
docker load -i [镜像名:版本号]

以Onlyoffice-v7.2为例：

1
docker load -i ./onlyoffice-cn_7.2.2.56.tar.gz

四）运行容器-http方式

docker运行下载onlyoffice，此处设置onlyoffice监听端口为8000（按实际情况修改）

参数说明：

1
2
3
4
5
6
7
8
--restart=always表示每次开机，只要当docker被设置为开机启动，此onlyoffice就会自动运行
-d 表示后台运行
-i:  交互式操作。
--name：为容器起一个名字
-t:  终端。
-p 8000:80  宿主机的8000端口映射到容器的80端口
-e JWT_ENABLED=false 开启密钥验证，默认开启。v7.2版以后功能。Dzzoffice必需要关闭。
-e JWT_SECRET=65321 设置密钥，如果没有开启密钥验证，无需设置此参数。

运行：

1
docker run -i -t -d --name onlyoffice --restart=always -e JWT_ENABLED=false -p 8000:80 onlyoffice-cn:7.2.2.56

访问http://IP:8000如果出现欢迎页面，则安装成功

image-20230311184513585

六、KodBox插件安装及配置

一）onlyoffice插件安装

1、下载onlyoffice插件~点击我

image-20230313113713509

2、OnlyOffice插件拷贝到kodboxPlugins目录

iShot2023-03-12 18.43.10

3、启动插件

iShot2023-03-13 09.59.52

iShot2023-03-12 18.45.03

二）onlyoffice 对接 KodBox

1、配置插件

如果office和可道云部署在同一台服务器，则无需任何配置

office和可道云不在一台服务器：点击配置插件,将上面office所在服务器ip替换到如图选中的内容(注意结尾/web/不能去除);

点击”检测office服务器”，如果检测通过这说明全部配置完成，刷新可道云页面，选中一个office文件右键打开方式，选择onlyoffice编辑即可体验。

插件设置

配置用户在线编辑的权限

iShot2023-03-13 09.57.36

iShot2023-03-13 09.58.02

检测结果无误如下图:

插件设置

注意：

  1. 上面配置ip也可以是绑定了到该服务器的域名，不能为localhost；
  2. 不知道如何获取本机ip的，可以通过WIN+R快捷键进入CMD==> 输入ipconfig ; 查看以IPV4开头的项；
  3. 如果网络内、或服务器开启防火墙，导致访问不了，可以尝试关闭防火墙或开启8001端口。

2、设置office文档默认onlyoffice打开

在文档上点击右键打到打开为===>设置默认打开

iShot2023-03-13 10.03.13

iShot2023-03-13 10.03.27

3、测试在线编辑

添加了许多中文字体

iShot2023-03-13 10.22.32

iShot2023-03-13 10.21.16

iShot2023-03-12 20.39.39

img

七、Onlyoffice常见问题

在部署过程中常遇到的问题~

一）在线打开office文档，提示无法保存和下载

如果onlyoffice容器和seafile、dzzoffice、nextcloud不在同一主机，在线编辑会提示下载失败。

原因分析：

docker容器内默认是无法访问外网的，如果容器和dzzoffice等服务不在同一主机，则容器需要主动联网。但是linux默认策略是不会转发包的，所以需要开启主机NAT转发。

解决办法：

1
2
3
4
5
6
#编辑系统设置
vi /etc/sysctl.conf
#添加以下内容到sysctl.conf
#添加完毕记得 :wq 保存
net.ipv4.ip_forward = 1
#最后重启主机

img

二）提示“INVALID TOKEN”、“秘钥没有正确生成”错误

在运行Onlyoffice docker应加上参数 -e JWT_ENABLED=false Dzzoffices要关掉密钥验证。默认是开启的，v7.2版以后的功能。

三）关闭 onlyoffice 的 ssl 证书验证

进入onlyoffice容器：

1
2
# docker exec -it onlyoffice bash
# vi /etc/onlyoffice/documentserver/default.json

将”rejectUnauthorized”后面的 true 改为 false 如下图：

重启命令：

1
#/bin/bash -c "supervisorctl restart all"

八、KodBox其他问题

1.VirtulBox无法打开，提示软件不安全

请到官网下载最新版本VirtulBox安装

2.如何查看容器状态？

可以在桌面上运行Docker Quickstart Terminal,然后执行 docker ps查看容器状态

3.如何配置https访问

  • 若全站采用https访问office，需要配置nginx反向代理来实现https转http
  • 具体实现: 参考这里

4.如何自启动office服务，避免每次开启后需要手动启动

  • win + r 输入 shell:startup 回车打开启动目录
  • 将[桌面]/kod/启动或重启.cmd 发送到桌面快捷方式, 并将快捷方式拷贝到该启动目录

5.优化office打开预览速度

  • 优化office打开预览速度，建议分配docker 4G以上内存，设置方法： 启动桌面的 VirtualBox ==> 右键左侧“default”-退出(关闭电源),设置-系统内存设置为 4096 MB; 选择处理器CPU ==> 处理器数量建议尽可能多。

注意：操作完成后，双击运行[桌面]/kod/启动或重启.cmd生效

6.docker占用空间越来越大怎么办

  • 双击运行[桌面]/kod/启动或重启.cmd即可清理相关缓存及临时文件。

其它常见问题请参考我的另一篇文章：Docker 部署 Nextcloud+Onlyoffice 以及常问题