快速开始
基础环境说明
| 工具 | 版本 | 下载地址 | 备注 |
|---|---|---|---|
| JDK | 2.x为1.8+，3.x为17+ | java开发的基础环境 | |
| Maven | 3.6+ | ||
| Mysql | 5.7+、8.0+ | 必需 | |
| Redis | 5.0+ | 必需 | |
| IDEA | 不限 | 后端开发 | |
| Navicat | 不限 | 数据库管理工具 | |
| RedisDesktopManager | 不限 | Redis管理工具 | |
| VSCode | 不限 | 前端开发 | |
| NodeJS | 14.0+、16.0+ | 前端开发基础环境 |
本地运行后端项目
下载地址
git clone git@gitee.com:mldong/mldong.git
# 如果为3.x则需
git checkout boot3
创建数据库
依次执行
doc/sql/mldong-plus1.0.sql===>系统管理+工作流程模块doc/sql/dev.sql===>在线开发，元数据管理模块doc/sql/biz_demo.sql===>演示模块
数据库配置
mldong-admin/src/resources/application-local.yml
# Mysql数据库
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://${DB_HOST:172.16.31.160}:${DB_PORT:3306}/${DB_NAME:mldong-plus}?autoReconnect=true&useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=CONVERT_TO_NULL&useSSL=false&serverTimezone=CTT&nullCatalogMeansCurrent=true
username: ${DB_USER:root}
password: ${DB_PASSWORD:8Eli#gr#AUk}
redis:
host: ${REDIS_HOST:172.16.31.160}
port: ${REDIS_PORT:6379}
password: ${REDIS_PASSWORD:gEwjEHLM}
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
logging:
level:
com.mldong: debug
或者添加环境变量：
- DB_HOST：数据库 ip 地址
- DB_PORT：数据库端口
- DB_USER：数据库用户名
- DB_PASSWORD：数据库密码
- REDIS_HOST：Redis ip地址
- REDIS_PORT：Redis端口
- REDIS_PASSWORD：Redis密码
启动
mldong-admin/src/main/java/com/mldong/MldongAdminApplication.java
访问接口文档
http://localhost:18080/doc.html
本地运行前端项目
前端有 2 个可选开源版本，按需选择：
选项 A：mldong-vue（基于 Vben2，含工作流，主推生产）
下载地址
git clone git@gitee.com:mldong/mldong-vue.git
安装依赖
yarn install
# 如果报gifsicle-5.3.0.tgz: Integrity check failed for "gifsicle"错，则执行
yarn install --update-checksums
启动
yarn dev:local
访问前端
选项 B：mldong-vben5（基于 Vben5，不含工作流，需 wf 请选 Pro 版）
注意：本版本不包含工作流模块。如需工作流，请使用选项 A 或购买 Pro 版。
下载地址
git clone https://gitee.com/mldong/mldong-vben5.git
cd mldong-vben5
安装依赖（使用 pnpm）
corepack enable # 启用 pnpm（如未启用）
pnpm install
修改代理地址（本地联调必须）
默认代理指向 apifox 云 mock（
https://apifox-plus.mldong.com/m1/...），不是 localhost 后端。本地联调前必须改成自己的后端地址。
打开 apps/web-antd/vite.config.mts，把 /api 的 target 改成你的后端地址：
proxy: {
'/api': {
changeOrigin: true,
rewrite: (path) => path.replace(/^\/api/, ''),
// 改成你的后端地址（如本地 mldong-admin 默认 18080）
target: 'http://localhost:18080',
ws: true,
},
},
启动（antd 版本为例，默认端口 5666）
pnpm dev:antd
# 其他版本：pnpm dev:ele / pnpm dev:naive / pnpm dev:tdesign