JeecgBoot部署及AI知识库使用教程

1.jpg

在当今数字化时代,快速高效地开发应用程序是众多开发者的追求。JeecgBoot作为一款优秀的低代码开发平台,凭借其丰富的功能和便捷的开发方式,受到了广大开发者的青睐。本文将详细介绍JeecgBoot的部署教程,帮助大家更好地利用这一强大工具,顺利开展项目开发工作。

PART.one
应用与介绍
 
 

JeecgBoot是一款企业级低代码平台集成了AI应用平台功能,旨在帮助开发者快速实现低代码开发和构建、部署个性化的AI应用。前后端分离架构AntDesign4、Vue3,SpringBoot,SpringCloudAlibaba,Mybatis-plus,Shiro/SpringAuthorizationServer,强大的代码生成器让前后端代码一键生成,无需写任何代码;提供强大的报表和大屏工具,满足企业级数据产品需求!

引领AI低代码开发模式:AI生成->OnlineCoding->代码生成->手工MERGE,帮助Java项目解决80%的重复工作,让开发更多关注业务,提高效率、节省成本,同时又不失灵活性!低代码能力:Online表单、表单设计、流程设计、Online报表、大屏/仪表盘设计、报表设计;AI应用平台功能:AI知识库问答、AI模型管理、AI流程编排、AI聊天等,支持含ChatGPT、DeepSeek、Ollama等多种AI大模型。

JeecgBoot提供了一系列低代码能力,实现真正的零代码在线开发:Online表单开发、Online报表、复杂报表设计、打印设计、在线图表设计、仪表盘设计、大屏设计、移动图表能力、表单设计器、在线设计流程、流程自动化配置、插件能力(可插拔)。

AI赋能低代码:目前提供了AI应用、AI模型管理、AI流程编排、AI对话助手,AI建表、AI写文章、AI知识库问答、AI字段建议等功能;支持各种AI大模型ChatGPT、DeepSeek、Ollama、智普、千问等。

JEECG宗旨是:简单功能由OnlineCoding配置实现,做到零代码开发;复杂功能由代码生成器生成进行手工Merge实现低代码开发,既保证了智能又兼顾灵活;实现了低代码开发的同时又支持灵活编码,解决了当前低代码产品普遍不灵活的弊端!

JEECG业务流程:采用工作流来实现、扩展出任务接口,供开发编写业务逻辑,表单提供多种解决方案:表单设计器、online配置表单、编码表单。同时实现了流程与表单的分离设计(松耦合)、并支持任务节点灵活配置,既保证了公司流程的保密性,又减少了开发人员的工作量。

PART.two
JeecgBoot 部署
 
 
微信截图_20250807154929.png
01
所需环境

部署JeecgBoot之前,确保你的系统满足以下环境要求,这是顺利部署和运行项目的基础。

1.JDK1.8

JeecgBoot基于Java开发,JDK1.8是其稳定运行的基础。安装时,建议选择官方网站提供的安装包,按照向导一步步操作。安装完成后,务必配置环境变量,在系统变量中新建JAVA_HOME,值为JDK的安装路径,例如“C:\ProgramFiles\Java\jdk1.8.0_201”,然后在Path变量中添加“%JAVA_HOME%\bin”和“%JAVA_HOME%\jre\bin”。配置完成后,打开命令提示符,输入“java-version”和“javac-version”,若能显示出对应的版本信息,则说明JDK安装和配置成功。

2.IDEA、Maven

IDEA是功能强大的Java集成开发环境,推荐使用Ultimate版本,对Java开发支持更全面。安装时可根据自己的操作系统选择对应的版本,安装过程中可以勾选创建桌面快捷方式等选项。Maven用于项目依赖管理和构建,下载后解压到指定目录,比如“D:\apache-maven-3.6.3”。然后在IDEA中进行配置,打开IDEA,进入“File->Settings->Build,Execution,Deployment->BuildTools->Maven”,在“Mavenhomedirectory”中选择解压后的Maven目录,“Usersettingsfile”选择Maven目录下conf文件夹中的settings.xml文件,这样IDEA就会使用我们指定的Maven了。

3.MySql、Navicat

MySql作为项目的数据库,版本需在5.7+,以保证与JeecgBoot的兼容性。安装MySql时,选择自定义安装,可根据需要选择安装路径,在配置环节,设置字符集为utf8mb4,这能更好地支持各种字符。安装完成后,记得设置root用户的密码,并确保MySql服务处于启动状态。Navicat是方便的数据库管理工具,安装后打开,点击“连接->MySql”,在弹出的窗口中输入连接名(可自定义)、主机名或IP地址(本地一般为localhost)、端口(默认3306)、用户名(默认root)和密码,点击“测试连接”,显示连接成功后即可使用。

4.Redis

Redis作为缓存数据库,能有效提升JeecgBoot的系统性能,比如存储用户登录信息、会话数据等。Windows系统下可从GitHub上下载Redis的安装包,解压后放在指定目录,如“D:\Redis”。打开命令提示符,进入Redis目录,输入“redis-server.exeredis.windows.conf”启动Redis服务,若要将其安装为Windows服务,可输入“redis-server--service-installredis.windows.conf--loglevelverbose”,之后可通过“netstartredis”启动服务,“netstopredis”停止服务。

5.Node.js

用于运行前端项目,建议选择LTS版本,稳定性更好。安装时,在nodejs文件夹下新建“node_global”和“node_cache”文件夹,并在“node_global”下新建“node_modules”文件夹。在命令提示符(CMD)中输入以下两行命令设置全局文件和缓存文件:

npmconfigsetprefix"D:\Node.js\node_global"

npmconfigsetcache"D:\Node.js\node_cache"

同时创建系统环境变量NODE_PATH,值为“D:\Node.js”,并在path环境变量中添加“%NODE_PATH%”和“%NODE_PATH%\node_global”。设置完成后,关闭命令提示符并重新打开,输入“node-v”和“npm-v”,若能显示版本信息,则说明Node.js安装配置成功。

6.cnpm安装

在CMD中输入“npminstall-gcnpm--registry=https://registry.npm.taobao.org”,使用淘宝镜像源安装cnpm,能大大加快后续依赖包的安装速度。安装完成后,输入“cnpm-v”,若显示版本信息则安装成功。

7.yarn安装

在CMD中输入“npminstall-gyarn--registry=https://registry.npm.taobao.org”。若安装过程中报错,可能是权限问题,可尝试以管理员身份运行CMD命令行,右键点击CMD图标,选择“以管理员身份运行”,然后重新执行安装命令。安装成功后,输入“yarn-v”查看版本信息。

02
拉取代码
微信截图_20250807155345.png

代码是项目的核心,拉取代码时要确保网络畅通,避免因网络问题导致代码拉取失败。

1.后端

在命令行中执行“gitclonehttps://gitee.com/jeecg/jeecg-boot.git”,将JeecgBoot后端代码克隆到本地。如果你的电脑上没有安装Git,需要先从Git官网下载并安装,安装过程中按照默认选项即可。安装完成后,在命令提示符中输入“git--version”,能显示版本信息说明Git安装成功。拉取代码时,选择一个合适的目录,比如“D:\projects”,在该目录下打开命令提示符,执行上述命令,等待代码拉取完成。

2.前端

执行“gitclonehttps://gitee.com/jeecg/jeecgboot-vue3.git”,克隆前端代码。同样在合适的目录下执行命令,建议将前端代码和后端代码放在同一父目录下,方便管理,比如“D:\projects\jeecg-boot”(后端)和“D:\projects\jeecgboot-vue3”(前端)。 

03
启动后端

微信截图_20250807155430.png

后端是项目的核心逻辑处理部分,启动后端前的配置至关重要,直接影响项目能否正常运行。

1.初始化数据库

找到JeecgBoot项目中“jeecg-boot/db/jeecgboot-mysql-5.7.sql”脚本文件。打开Navicat,连接到MySql数据库后,右键点击连接名,选择“新建数据库”,数据库名可设置为“jeecg-boot”,字符集选择“utf8mb4”,排序规则选择“utf8mb4_general_ci”。然后双击打开该数据库,右键点击数据库名称,选择“运行SQL文件”,在弹出的窗口中找到上述sql脚本文件,点击“开始”执行脚本。脚本执行过程中,会自动创建各种表和初始化数据,等待执行完成,确保没有报错信息。

2.修改项目配置

打开IDEA,点击“File->Open”,选择后端代码所在的目录“jeecg-boot”,打开项目。等待IDEA加载项目完成,这可能需要几分钟时间,取决于电脑性能和网络状况。加载完成后,找到“jeecg-module-system/jeecg-system-start/src/main/resources/application-dev.yml”配置文件,双击打开进行修改:

  • 数据库配置:找到“spring->datasource”部分,配置数据库连接信息,“url”设置为“jdbc:mysql://localhost:3306/jeecg-boot?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8其中“localhost"是数据库主机地址,“3306”是端口,“jeecg-boot”是数据库名;“username”设置为数据库用户名,一般为“root”;“password”设置为安装MySql时设置的密码。

  • Redis配置:找到“spring->redis”部分,“host”设置为Redis服务所在的主机地址,本地一般为“localhost”;“port”设置为Redis的端口,默认是“6379”;如果Redis设置了密码,还需要配置“password”。

3.启动项目&访问

配置完成后,在IDEA左侧的项目结构中,找到“jeecg-system-start/src/main/java/org/jeecg/JeecgSystemApplication.java”类,右键点击该类,选择“RunJeecgSystemApplication.main()”启动项目。启动过程中,IDEA底部的控制台会输出启动日志,仔细观察日志,若出现“StartedJeecgSystemApplicationinXXseconds(JVMrunningforXX)”等类似信息,说明后端项目启动成功。启动成功后,打开浏览器,输入“http://localhost:8080/jeecg-boot/doc.html”访问后台的swagger地址,在这里可以查看和测试后端的接口。

04
启动前端

前端是用户与系统交互的界面,启动前端前要确保依赖包安装正确。

1.执行命令下载依赖

进入前端项目目录,比如在命令提示符中输入“cdD:\projects\jeecgboot-vue3”。然后执行“pnpmi”或者“yarninstall”命令下载项目所需的依赖包。如果之前没有安装pnpm,可先执行“npminstall-gpnpm”安装。下载依赖过程中,可能会花费一些时间,取决于网络速度,要耐心等待,确保依赖包下载完整,避免中途中断。如果下载过程中出现错误,可尝试删除“node_modules”文件夹和“package-lock.json”文件(或“yarn.lock”文件),然后重新执行安装命令。

2.启动前端项目

依赖包安装完成后,执行“pnpmserve”命令启动前端项目。启动过程中,命令提示符会输出相关日志,当出现“Apprunningat:-Local:http://localhost:3100/”等信息时,说明前端项目启动成功。打开浏览器,输入“http://localhost:3100”访问前端项目,在登录页面输入默认账号“admin”和密码“123456”,点击登录,若能成功进入系统首页,则说明前端启动正常。

PART.three
使用JeecgBootAI知识库
 
 

2.jpg

JeecgBootAI知识库能为项目开发提供智能支持,帮助开发者更高效地获取和利用信息。

01
前置条件

为使AI能精准理解并回答用户问题,需对文档进行向量化处理并存储在向量库中。因此,使用JeecgBootAI知识库前,需准备好向量库,常用的向量库有Milvus、Chroma等。以Milvus为例,需从其官方网站下载并安装,安装完成后启动Milvus服务。然后在JeecgBoot项目的配置文件中配置向量库相关信息,找到对应的配置文件,设置向量库的地址、端口、用户名、密码等,确保系统能正常连接到向量库。

02
知识库管理

知识库管理是使用AI知识库的基础,合理的知识库管理能让信息更有序,便于后续使用。

新建知识库

登录JeecgBoot系统后,在左侧菜单栏中找到“AI知识库”相关模块,点击进入知识库管理页面。点击“创建知识库”按钮,弹出创建窗口,填写以下信息:

•知识库名称:用于区分不同知识库,命名应简洁明了且具有辨识度,比如“项目开发文档库”“API接口说明库”等,避免使用过于模糊或复杂的名称。

•知识库描述:简要介绍知识库的内容,包括知识库的用途、包含的文档类型等,方便其他用户了解该知识库,例如“该知识库包含项目开发过程中的需求文档、设计文档和测试报告等”。

•向量模型:指定当前知识库使用的向量模型(必须为向量模型)。向量模型是将文本、图片、音频等数据转换为数学向量(Vector)的技术,使其能在高维空间中进行计算、比较和检索。可根据实际需求选择合适的向量模型,系统可能会提供一些默认的向量模型供选择,也可以根据文档的特点自定义或导入向量模型。选择完成后,点击“确定”按钮,完成知识库的创建。

03
知识库文档

文档是知识库的核心内容,正确录入和管理文档能确保AI知识库更好地发挥作用。

1.创建文档

点击已创建的知识库,进入知识库详情页面,系统支持三种方式录入文档:

•手动录入:点击“手动录入”按钮,打开手动录入页面。在“文档标题”输入框中,输入简洁明了的标题,能准确概括文档内容,比如“用户登录功能设计说明”。在“文档内容”编辑框中,填写详细的文档内容,可以使用富文本编辑器进行格式化,如设置字体大小、加粗、添加列表等,使文档更易读。填写完成后,点击“保存”按钮,文档将被添加到知识库中,并自动进行向量化处理。

•文件上传:点击“文件上传”按钮,打开文件上传页面。在“文档标题”输入框中输入标题,然后点击“选择文件”按钮,选择要上传的文件。支持上传的文件格式有txt、markdown、pdf、docx、xlsx、pptx。上传pdf文件时,要确保文件内容清晰,没有加密或损坏;上传docx文件时,注意文件中的图片是否能正常显示。点击“确定”后,系统会自动上传文件,并对文件内容进行解析和向量化处理。向量化是指将文本、图片、音频等数据转换为固定维度的数值向量(Embedding),使其在数学空间中可计算和比较,广泛用于语义搜索、推荐系统和AI知识库等。处理完成后,文件将以文档形式存储在知识库中。

•文档库上传:系统支持批量上传markdown格式的文档库。将多个markdown文件整理好,按照一定的目录结构存放,然后压缩为zip包。若文档中涉及相关图片文件,确保zip包结构正确,如“---|-static|--aigc|---11111.png”,这样系统会自动识别并关联图片与markdown文件,避免图片丢失或无法显示。点击“文档库上传”按钮,选择压缩好的zip包进行上传,系统会智能解析zip包中的内容,将所有的markdown文件添加到文档库中,并完成向量化处理。

2.文档操作

在知识库详情页面的文档列表中,找到需要操作的文档,点击文档数据右下角的“...”按钮,弹出编辑选单,可进行以下操作:

•向量化:当文档内容发生修改,或者需要更新向量时,可选择“向量化”选项,系统会重新计算并更新文档向量,确保AI能基于最新的文档内容进行回答。

•编辑:选择“编辑”选项,可打开文档编辑页面,对文档的标题和内容进行修改。修改完成后点击“保存”按钮,系统会保存修改并重新进行向量化处理。

•删除:若文档不再需要,可选择“删除”选项,在弹出的确认窗口中点击“确定”,即可移除该文档。删除操作要谨慎,一旦删除,文档内容将无法恢复。

3.命中测试

在知识库详情页面,找到“命中测试”选项,点击进入命中测试页面。在输入框中输入测试内容,比如“如何实现用户登录功能”,然后点击“发送”按钮。系统会根据输入的内容,在知识库中进行检索,显示匹配的文档片段。参数说明如下:

•条数:通过设置“条数”参数,可指定返回的匹配结果数量,比如设置为5,系统最多会返回5条匹配度较高的结果。

•Score阈值:Score表示匹配评分,评分越高,说明文档片段与测试内容的匹配度越高。仅当匹配评分(Score)高于设定阈值(Threshold)时,才会返回结果。可根据需要调整阈值,阈值设置过高,可能返回的结果较少;阈值设置过低,可能会返回一些匹配度不高的结果。

匹配结果包含命中段落内容、分段序号和匹配分数,点击条目可查看详细信息,包括该段落所在的文档、在文档中的具体位置等,方便开发者快速定位到相关文档内容。

通过以上JeecgBoot的部署教程以及JeecgBootAI知识库的使用教程,相信大家能够快速上手JeecgBoot平台,并利用其AI知识库功能为项目开发带来更多便利和创新。在实际使用过程中,可能会遇到各种问题,要善于查阅官方文档和社区资料,不断积累经验。同时,可根据项目需求灵活配置和运用相关功能,提升开发效率和应用性能,让JeecgBoot更好地服务于项目开发。

 

摩尔云作为北科控股旗下

工业智能化核心技术子公司,

以“数智赋能,重塑工业未来”为使命,

深入发掘企业AI需求,提高工业智能化水平,

为化工行业提供端到端的智能化转型解决方案。

聚焦工业场景痛点,推动化工行业大模型技术落地,

助力化工园区及企业。以技术创新重塑行业价值链。

摩尔云科技

扫码进入官方网站
获取更多相关内容

Beike Group