【qKnow开源版】快速部署流程（自主部署）2026年9月版原创

大家好，欢迎来到本次qno部署讲解专场，今天为大家讲解纯自主私有化部署。自主化部署对比docker部署操作会繁琐不少，因为需要手动完成工具安装以及各项环境配置。接下来我们就逐个来看对应的部署要点。首先我们先来了解前期需要做好的工具准备工作，在执行docker部署操作前要准备jdk maven mysq等环境系统，对这些运行环境工具都有着明确的版本约束。拿JDK举例，版本要求比较高，最低需要17版本，这里建议直接使用JDK17 ma文需要3.8以上版本，更推荐选用ma文3.9，避免运行出现依赖冲突。MYSQ数据库我们推荐大家使用5.7版本，NEWO4G要求4.40及以上项目基准版本为4.40向量数据库。Vivi it直接使用最。

新稳定版本即可。Redis这边建议使用5.0版本，前端环境依赖node JS版本必须要16以上，我们项目实际使用22版本，优先选择高版本，避免启动异常。这些工具可以官网手动下载，也可以用docker安装。Docker部署的方式整体会更加便捷高效一些。如果手动下载的话，搜索安装配置整套流程很耗时间。为了带大家尽快了解部署流程，接下来我将演示如何通过docker安装这些工具。在项目目录中我已经提前写好了docker启动脚本，脚本里面封装好了全部启动与安装的执行命令。我先运行脚本，之后再逐一讲解命令逻辑。我们双击脚本，可以看到镜像正在逐个拉取，趁镜像拉取的间隙，给大家讲解脚本流程，脚本会先清除已有的老的镜像，避免因为镜像冲突拉取失败。接着会按照顺序逐个拉取，首先是redis，下一个是MYSQL。全部镜像拉取完毕后，就要处理MYC库数据库脚本会执行命令，自动完成基础数据库的初始化，刚创建的数据库是空库，业务数据需要手动导入。项目附带初始化脚本，建好库就可以执行导入。等所有服务全部启动完成之后，会输出说明文档，文档里面会列出各个组件对应的账号以及密码这些凭证后续配置后端数据库连接时会用到docker，拉取镜像速度虽有限，但优于手动安装。

手动下载安装环境，整体耗时会高出很多。在镜像拉取等待期间，我们来看后端环境配置，我们需要配置mycql NEO、4j vivi还有redis。镜像下载完成后，我演示配置文件的所在位置。部署的第一步就是工具准备和环境配置，也就是我们前面讲的，下面讲第二步，怎么把项目代码拉取到本地，我们访问getty，找到这里，点击克隆下载，我们提供开源版本仓库，可以复制对应的下载链接。

在本地终端执行get命令，就可以拉取项目源码。拉取结束后，本地磁盘会生成完整项目文件夹。可以使用idea或者eclipse这类工具打开项目代码。本次演示我使用idea开发工具来操作，刚导入项目汇报依赖缺失，需要修改IDE配置项，点击文件打开项目结构，找到设置，在项目设置里面找到SDK设置SDK版本必须设置为JDK17，点击下拉选项，选择JDK17，如果没有JDK17，也可以点击下载JDK，找到对应版本下载语言级别同步选择JDK17，确定没问题之后点击应用即可。接下来我们再来完成maven工具的相关配置，点击左上角文件选择设置，点击打开，在构建执行部署这个目录里点击打开，然后找到这个构建工具的栏目，找到may问选项。

这里我使用3.9.16版本填写路径与仓库信息，分别配置maven程序路径配置文件和本地仓库配置，保存后执行微问构件下载项目依赖包构建成功还不能直接启动，要配置数据库连接参数刀ER镜像还在后台拉取，大家稍作耐心等待，我们可以看到reddis mysql new4J已经完成等待最后一个ViVi的拉取。我们先去看一下配置位置，My seql和redis的配置放在kno server模块内，然后我们依次打开s RC man resource配置资源文件夹，找到application devve文件，点击往下滑，找到配置连接的地方，可以看到第一行当前数据库的连接方式是MYCY库，在这里配置redis信息，然后再往下找，这部分就是MYCY库数据库连接配置的。

的地方，将docker输出的地址、端口、密码填入配置文件，Redis地址填local host端口默认使用6379密码的话默认是REDIS123。我们回到代码配置界面，找redis配置的地方。

这里配置redis的地址，根据左侧的信息复制，然后粘贴。然后端口号、密码依次进行填写。填写完毕后往下滑找到MYSQL配置的地方。在这里需要填写连接信息，我们去启动文件里看一下配置MYSQL的地址、端口、账号、密码、数据库名称，依次复制填写到对应的配置里。配置完毕后，我们接下来配置NEO4G的连接信息，NEW4G配置位于k framework的COLONIAL4G模块，我们依次点击打开找到配置位置。

修改resource下application neo4j def配置文件，这里就是配置NEO4J连接信息的地方，根据启动信息把NEO4G的访问地址、端口、账号、密码依次填入信息填写完毕后，我们将下一个vivi eight的配置ViVi配置在k no AI模块的O配置文件，我们依次点击s RC man resource文件，点击application AI DA ammo文件，这里就是配置ViVi向量数据库的地方。我们根据左侧启动信息查看配置，复制服务地址端口a pik对应填写访问密码，然后粘贴到配置里面全部连接参数配置完成后端就可以准备启动。

我们先看一下docker服务启动情况，镜像还在处理当中，可以看到MYC库已经就绪，因为我们docker启动的Mac库是空库，要准备初始化数据。我这里推荐大家使用navicate数据可视化工具去补充数据。打开工具后点击左上角的链接，选择MYSQL，我们可以去启动信息里看数据库地址、端口账号、密码，根据左侧连接信息依次复制到连接工具中。我们先创建一个数据库连接名称，然后复制左侧信息，输入端口用户名、密码信息，输入完毕后点击。

1测试链接服务尚未全部就绪，等待完成后再进行连接，可以看到所有服务已经启动成功，我们再点击测试下navi k连接成功，刚建好的数据库里面是空数据，我们进入数据库点击打开。然后就是去项目中找到初始化数据库文件。具体位置在CQ文件夹下面，记住路径。回到工具，鼠标点击右键，选择初始化文件。然后选择完毕之后，点击开始，就会自动进行初始化数据创建，等待他执行完毕。

执行完毕，关闭弹框，刷新下数据库，点击查看可以看到初始化数据表已经全部准备好了，系统所需相关配置全部完成，准备启动后端服务控制台打印启动成功提示代表后端运行正常，具体执行情况是否完成，我们可以去文档这里看下成功展示。好的，我们可以看到后端已经执行成功，接下来我们就进行前端项目配置和启动，使用前端工具打开项目，我就用tra给大家演示一下，在这里可以根据路径去导入前端项目，导入项目成功之后就能够看到前端项目的全部文件。我们打开vtcon.js，这里维护后端接口端口前后端端口号必须保持一致才能正常通信，我们去后端。

看一下端口是多少，打开后端项目后找到no server文件，然后我们依次打开s RC man resource配置资源文件夹，然后找到后端端口的配置位置，看一下端口号是否和前端配置的一致。好的，我们可以看到前后端的端口配置一致没问题。接下来就是前端的启动准备了，我们先去文档站看一下启动需要哪些东西。第一步就是修改服务端端口，我们刚才已经看到了，是一致的。

然后就是安装依赖，我们复制一下这个命令。在这里粘贴运行，它就会自动去淘宝镜像源拉取所需依赖。我们等待他下载完成。可以看到依赖下载结束，项目目录会生成node modules文件夹，这里也就是前端启动所需依赖的位置，前期准备已经完毕，然后我们去文档站看下启动命令，找到这个项目启动命令并复制。

输入npm run deve命令，启动前端开发服务，等待加载页面，加载完成，默认账号qno密码QNO123，填写验证码登录，就可以成功进入系统界面，依次点开各个页面，检查功能是否出现报错。各项菜单访问正常，Qo自主部署全部结束，快来访问qno官网申领试用吧。