项目简介
本项目是前后端分离的极速后台开发框架,基于Spring Boot和Vue构建,为企业级应用提供高效、灵活且易于扩展的快速开发平台。框架集成Spring Boot、Spring Security、MyBatis、Jwt、Vue等经典技术,内置部门管理、角色用户、菜单及按钮授权等多种常用模块,还支持在线定时任务配置、多数据源、分布式事务等功能。
项目的主要特性和功能
主要特性
- 完全响应式布局,支持主流设备。
- 强大的一键生成功能,涵盖控制器、模型、视图、菜单等。
- 支持多数据源,简单配置即可切换。
- 支持按钮及数据权限,可自定义部门数据权限。
- 完善的XSS防范及脚本过滤,杜绝XSS攻击。
- Maven多项目依赖,模块及插件松耦合,便于升级和增减。
- 支持国际化,服务端及客户端均适用。
- 完善的日志记录体系,使用简单注解实现。
- 支持服务监控、数据监控、缓存监控功能。
内置功能
涵盖用户管理、部门管理、岗位管理、菜单管理、角色管理、字典管理、参数管理、通知公告、操作日志、登录日志、在线用户、定时任务、代码生成、系统接口、服务监控、缓存监控、在线构建器、连接池监视等功能。
安装使用步骤
准备工作
- JDK版本 >= 1.8(推荐1.8版本)。
- MySQL版本 >= 5.7.0(推荐5.7版本)。
- Redis版本 >= 3.0。
- Maven版本 >= 3.0。
- Node版本 >= 12。
后端运行
- 导入项目:将项目导入Eclipse或IDEA,选Maven -> Existing Maven Projects,按提示完成导入,Eclipse会自动加载依赖包。
- 创建数据库:创建
ry-vue
数据库,导入ry_2021xxxx.sql
和quartz.sql
脚本。 - 运行项目:打开
com.ruoyi.RuoYiApplication.java
运行,出现启动成功提示则启动成功。
前端运行
- 进入项目目录:打开命令行工具,进入
ruoyi-ui
目录。 - 安装依赖:执行
npm install
,建议指定registry
解决速度慢问题。 - 启动项目:执行
npm run dev
。 - 访问项目:打开浏览器,输入
http://localhost:80
,用admin/admin123
登录,页面正常则环境搭建成功。
建议
- 使用Git复制项目:
git clone https://gitee.com/y_project/RuoYi-Vue.git
。 - 前后端需单独启动才能访问。
- 前端设置淘宝镜像源,不建议用cnpm。
必要配置
- 修改数据库连接:编辑
resources
目录下的application-druid.yml
。 - 修改服务器配置:编辑
resources
目录下的application.yml
。
部署系统
前后端需单独部署才能访问。
后端部署
- 打包工程文件:在
ruoyi
项目的bin
目录下执行package.bat
,生成war/jar
包。 - 部署工程文件:jar部署用
java –jar ruoyi.jar
或执行ruoyi/bin/run.bat
;war部署修改ruoyi/pom.xml
后放入tomcat
服务器webapps
。
前端部署
- 打包项目:执行
npm run build:prod
或npm run build:stage
。 - 部署文件:构建后根目录生成
dist
文件夹,将静态文件发布到nginx
或静态服务器。
环境变量
测试或正式环境变量在 .env.xxxx
文件中,以 VUE_APP_
开头,通过 webpack.DefinePlugin
注入全局。
常见问题
- Mac需修改
application.yml
文件路径profile
。 - Linux提示表不存在,在
/etc/my.cnf
添加lower_case_table_names=1
并重启MYSQL服务。 - 权限不足无法写入文件,检查
application.yml
中的profile
路径或logback.xml
中的log.path
路径权限。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】