后端运行 - qModel 开源版

千桐科技2026/7/15大约 3 分钟安装部署

一、准备工作（必备环境）

在运行系统之前，请确保您已安装以下环境：

软件/工具	版本要求	推荐版本
JDK	>= 1.8	1.8
MySQL	>= 5.7.0	5.7
Redis	>= 5.0	5.0
Maven	>= 3.6	3.6
Node.js	>= 16	16
Python	>= 3.8	3.13.13
pip	>= 21.0	26.0.1

提示: 前端安装完 Node.js 后，建议设置淘宝镜像源以提升依赖包下载速度。不推荐使用 cnpm，可能会引入一些不可预知的问题。
npm config set registry https://registry.npmmirror.com

二、获取项目代码（下载与解压）

前往【qModel Gitee 下载页面】下载项目并解压到您的工作目录。

三、目录结构

1. 项目结构;

├─qmodel-framework          # 公共配置模块
├─   ├─qmodel-auth           # oauth2模块
├─   ├─qmodel-common         # 共通模块
├─   ├─qmodel-config         # 配置模块
├─   ├─qmodel-file           # 文件管理模块
├─   ├─qmodel-generator      # 代码生成器
├─   ├─qmodel-mybatis        # mybatis配置
├─   ├─qmodel-quartz         # 定时任务模块
├─   ├─qmodel-redis          # redis模块
├─   ├─qmodel-security       # security模块
├─qmodel-module-system       # 系统管理模块
├─qmodel-module-model        # 模型管理模块
├─qmodel-server              # 启动项目
├─qmodel-ui                  # 前端模块
├─sql                        # sql脚本
├─README.md                  # 相关介绍
├─QUICKSTART.md              # 快速启动

2. 前端结构;

├─qmodel-ui                  # 前端模块
├─   ├─public                   # 静态资源目录
├─   ├─src
├─   |  ├─api                   # 接口
├─   |  ├─assets                # 图片、样式等资源
├─   |  ├─components            # 通用组件
├─   |  ├─layout                # 布局
├─   |  ├─plugins               # 插件
├─   |  ├─router                # 路由
├─   |  ├─store                 # 状态管理
├─   |  ├─utils                 # 工具类
├─   |  ├─views                     # 页面视图
├─   |  |   ├─system                # 系统管理模块
├─   |  |   ├─model                 # 模型管理模块
├─   ├─.env.development         # 开发环境配置
├─   ├─.env.production          # 生产环境配置
├─   ├─vite.config.js           # Vite配置文件

四、必要配置（数据库与服务配置）

1. 创建MySQL数据库并导入数据

创建 MySQL 数据库：qmodel_dev
导入数据脚本：qmodel_YYYYMMDD.sql、quartz.sql

2. 修改MySQL数据库连接配置

路径：qModel/qmodel-server/src/main/resources/application-dev.yml

datasource:
  type: mysql

mysql:
  driver-class-name: com.mysql.cj.jdbc.Driver
  url: 数据库地址
  username: 数据库账号
  password: 数据库密码

3. 配置Redis连接

路径：qModel/qmodel-framework/qmodel-redis/src/main/resources/application-redis-dev.yml

redis:
  host: Redis地址
  port: Redis端口
  password: Redis密码

4. 配置服务端口和访问路径

路径：qModel/qmodel-server/src/main/resources/application.yml

server:
  port: 端口            # 默认为8090
  servlet:
    context-path: /应用路径  # 应用访问路径，默认为空

五、后端运行（启动服务器）

使用 IntelliJ IDEA 或 Eclipse 导入项目。
IDE 将自动加载 Maven 依赖，初次加载可能较慢。
运行 tech.qiantong.qmodel.server.QModelApplication.java。启动成功后，可通过 http://localhost:8090 访问后端服务。
出现以下提示，表示后端服务启动成功：

qModel 算法模型平台启动成功

注意: 仅启动后端服务不会显示静态页面，请继续部署前端服务。

Tips: 如果提示缺少依赖包aspose-words-java、aspose-cells-java时，需要将项目根目录下lib文件夹中的两个jar包引入，在项目根目录下运行如下两行代码：

mvn install:install-file -Dfile=lib/aspose-cells-21.8.cracked.jar  -DgroupId=com.aspose-cells  -DartifactId=aspose-cells-java -Dversion=21.8 -Dpackaging=jar
mvn install:install-file -Dfile=lib/aspose-words-15.8.0-jdk16.jar  -DgroupId=com.aspose-words  -DartifactId=aspose-words-java -Dversion=15.8.0 -Dpackaging=jar

完成！