快速开始
本文档将帮助你在 5 分钟内在本地运行 MolanDev Cloud,开始你的开发之旅。
环境要求
| 软件 | 版本 | 说明 |
|---|---|---|
| JDK | 17+ | 后端运行环境 |
| Maven | 3.6+ | 后端构建工具 |
| Node.js | 16+ | 前端运行环境 |
| Docker | Latest | 推荐:一键启动中间件 |
| IntelliJ IDEA | 2023+ | 开发 IDE(社区版即可) |
🐳 为什么推荐 Docker?
项目已配置好 docker-compose.yml,只需一条命令就能启动 MySQL、Redis 等中间件,免去手动安装的麻烦。
第一步:启动中间件
使用 Docker(推荐)
bash
# 进入项目目录
cd molandev-backend/deploy/middleware
# 一键启动所有中间件
docker compose up -d
# 查看启动状态
docker compose ps启动的服务:
- MySQL (3306) - 数据库 ✅ 必需
- Redis (6379) - 缓存 ✅ 必需
- RabbitMQ (5672, 15672) - 消息队列 ❌ 单体模式可选
- Nacos (8848) - 配置中心 ❌ 单体模式可选
🔑 默认密码
- MySQL root 密码:
123456 - Redis 密码:
123456
如需修改,编辑 deploy/middleware/.env 文件。
验证服务
bash
# 测试 MySQL
docker exec -it mysql mysql -uroot -p123456 -e "SELECT 1"
# 测试 Redis
docker exec -it redis redis-cli -a 123456 ping
# 应返回: PONG第二步:初始化数据库
创建数据库
打开 MySQL 客户端,执行:
sql
-- 创建系统数据库
CREATE DATABASE IF NOT EXISTS `molandev_sys`
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
-- 创建消息数据库
CREATE DATABASE IF NOT EXISTS `molandev_msg`
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;导入初始化数据
在 deploy/sql/ 目录下找到初始化 SQL:
deploy/sql/
├── molandev_sys.sql # 系统库初始化脚本
└── molandev_msg.sql # 消息库初始化脚本导入方式:
bash
# 命令行导入
mysql -u root -p123456 molandev_sys < deploy/sql/molandev_sys.sql
mysql -u root -p123456 molandev_msg < deploy/sql/molandev_msg.sql或使用 Navicat/MySQL Workbench 等图形化工具导入。
第三步:配置后端
找到配置文件
在 IDEA 中打开:
molandev-backend/molandev-standalone-service/src/main/resources/application-local.yml修改数据库配置
yaml
molandev:
datasource:
sys: # 系统数据库
url: jdbc:mysql://localhost:3306/molandev_sys?characterEncoding=UTF-8&useSSL=false&serverTimezone=GMT%2B8
username: root
password: 123456 # 修改为你的 MySQL 密码
driver-class-name: com.mysql.cj.jdbc.Driver
primary: true
packages:
- com.molandev.base
- com.molandev.knowledge
msg: # 消息数据库
url: jdbc:mysql://localhost:3306/molandev_msg?characterEncoding=UTF-8&useSSL=false&serverTimezone=GMT%2B8
username: root
password: 123456 # 修改为你的 MySQL 密码
driver-class-name: com.mysql.cj.jdbc.Driver
packages:
- com.molandev.base.msg修改 Redis 配置
yaml
spring:
data:
redis:
host: 127.0.0.1
port: 6379
password: 123456 # 修改为你的 Redis 密码(如果没有密码则删除这行)
database: 0第四步:启动后端
找到启动类
在 IDEA 中打开:
molandev-backend/molandev-standalone-service/src/main/java/com/molandev/standalone/StandaloneApp.java运行项目
方式一: 点击 main 方法旁边的绿色运行按钮 ▶️
方式二: Maven 命令
bash
cd molandev-backend/molandev-standalone-service
mvn spring-boot:run -Dspring-boot.run.profiles=local验证启动成功
看到以下日志说明启动成功:
Started StandaloneApp in X.XXX seconds访问接口文档: http://localhost:9099/doc.html
如果能看到 Knife4j 接口文档页面,说明后端运行正常! 🎉
第五步:启动前端
安装依赖
bash
# 进入前端目录
cd molandev-frontend
# 安装依赖(首次需要)
npm install检查代理配置
打开 molandev-frontend/vite.config.js,确认后端代理端口:
javascript
server: {
port: 5173,
proxy: {
'/api': {
target: 'http://localhost:9099', // 确保与后端端口一致
changeOrigin: true
}
}
}启动开发服务器
bash
npm run dev启动成功后会显示:
VITE v5.x.x ready in xxx ms
➜ Local: http://localhost:5173/🎉 访问系统
打开浏览器访问: http://localhost:5173
默认登录账号:
- 用户名:
admin - 密码:
admin123
下一步
恭喜你成功运行 MolanDev Cloud! 🎉
现在你可以:
📖 了解项目
👨💻 开始开发
🔧 深入配置
常见问题
1. 后端启动失败:数据库连接错误
解决方案:
- 检查 MySQL 是否启动:
docker ps | grep mysql - 检查用户名密码是否正确
- 检查数据库是否已创建
2. 后端启动失败:Redis 连接错误
解决方案:
- 检查 Redis 是否启动:
docker exec -it redis redis-cli ping - 检查配置文件中 Redis 密码是否正确
3. 端口占用
解决方案:
修改 application-local.yml 中的 server.port 为其他端口。
4. 前端请求后端 404
解决方案:
- 确认后端服务已启动
- 检查
vite.config.js中的代理端口是否与后端一致 - 修改后重启前端:
npm run dev
更多问题请参考 环境准备。