项目简介
本项目是前后端分离的极速后台开发框架,基于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】