一、思路
为简化编译流程,我们仅需修改影响连接限制的docservice服务源代码,然后替换已部署的onlyoffice服务中的对应组件。整个编译过程仅需使用pkg打包工具。
具体编译方案如下:
- 在linux环境下编译生成Linux-64版本的docservice
- 如需编译Linux ARM版本,可在Windows主机上安装Docker Desktop,通过模拟ARM CPU架构在Docker容器内完成编译
以下以linux平台编译linux-64的docservice为例子。
三、具体步骤
(1)下载源代码
其实不需要下载整个document server的代码,下载里面的server代码就可以。代码地址:git clone https://github.com/ONLYOFFICE/server.git
(2)将node.js升级到最新版本
onlyoffice的编译要求是至少18以上。
(3)安装打包工具
npm install -g @yao-pkg/pkg
(4)安装js源代码的依赖包
安装common模块的依赖
进入server源代码的\common\目录(DocService依赖此模块),在命令行运行npm install.
安装DocService模块的依赖
进入server源代码的\DocService\目录,命令行运行npm install
(5)修改源代码
修改\common\sources\commondefines.js
const buildVersion = '9.2.1';
如果你不知道部署的版本号,可以采用以下方式:
查看这部分源代码:http://你已经部署的网站/web-apps/apps/api/documents/api.js
这个文件头有具体的版本号。也可以在服务端查看这个文件,以linux版本服务端为例:/var/www/onlyoffice/documentserver/web-apps/apps/api/documents/api.js
修改\common\sources\constants.js
exports.LICENSE_CONNECTIONS = 20000;//原来是20
exports.LICENSE_USERS = 200;
(7)执行打包
进入源代码目录:\server\DocService,执行命令
pkg . -t node20-linux-x64 --options max_old_space_size=4096 -o docservice
注意:不要漏了 pkg 后面的"."符号,它表示分析当前目录下的package.json文件,自动选择入口文件进行打包。
-t:表示要编译的目标平台,node20表示nodejs的版本,linux表示操作系统,后面还有一个参数是cpu架构,x64和arm64,默认和当前平台相同。
打包过程中有很多warning可以忽略,命令执行输出是:docservice文件,它是一个linux可执行文件。
(8)拉取镜像
(a) sudo docker pull onlyoffice/documentserver
(b) 启动服务
sudo docker run -i -t -d -p 80:80 --restart=always -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver
(c) 备份镜像中的docservice
进入容器切换到/var/www/onlyoffice/documentserver/server/DocService/下备份docservice官方二进制文件
(d)替换docservice
sudo docker cp docservice 容器id:/var/www/onlyoffice/documentserver/server/DocService/
(e)重启docker容器
sudo docker restart 容器id