# Easy-Vben

**Repository Path**: heima365/Easy-Vben

## Basic Information

- **Project Name**: Easy-Vben
- **Description**: Easy-Vben 开箱即用的中后台管理系统
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 15
- **Created**: 2025-04-12
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: vue3, Ant-Design, 安翅云, vben

## README

<h1 align="center">Easy Vben</h1>

<div align="center">

</div>

基于SpringBoot3、Druid、Mybatis Plus、Apache Shiro、Activiti、Beetl、HuTool、Quartz等开源框架开发，内置权限、部门、参数、字典、定时任务、代码生成等模块。  
建议与 [Easy-Vben-Admin](https://github.com/TengChongChong/Easy-Vben-Admin) 前端开源项目一起使用
## 文档
[在线文档](http://ev-doc.easy-frame.top/ '在线文档')

## 下载

从 码云 仓库中直接安装最新的代码

```
$ git clone --depth=1 https://github.com/TengChongChong/Easy-Vben.git easy-vben
```

## 目录结构

```
├── db                   # Sql脚本
│   ├── activiti         # 工作流
│   ├── easy-vben.sql    # 基础 sql
│   ├── easy-cms.sql     # CMS sql
│   └── quartz.sql       # 定时任务
├── easy-activiti        # 工作流
├── easy-api             # 入口
├── easy-cms             # CMS
├── easy-common          # 工具
│   ├── easy-core        # 基础
│   ├── easy-mybatis     # MyBatis
│   └── easy-redis       # Redis
├── easy-file            # 文件
├── easy-generator       # 代码生成
├── easy-sample          # 示例
├── easy-scheduler       # 定时任务
└── easy-sys             # 系统
```

## 创建数据库

- 创建数据库并执行`/easy-admin/db/easy-vben.sql`初始化表
- 如需使用CMS功能执行`/easy-admin/db/easy-cms.sql`初始化表
- 执行`/easy-admin/db/activiti/*`创建工作流表
- 执行`/easy-admin/db/quartz.sql`创建定时任务表

## 配置数据源&Redis
打开`/easy-admin/easy-api/src/main/resources/application-dev.yml`文件，修改`Redis`与`数据源`配置。 如果你使用默认的参数安装的`Redis`和`MySQL`
只需修改`spring.datasource.password`即可。

```yaml {19}
spring:
  data:
    # Redis
    redis:
      # 数据库索引（默认为0）
      database: 0
      # 服务器地址
      host: 127.0.0.1
      # 服务器连接端口
      port: 6379
      # 服务器连接密码（默认为空）
      password:
  # 数据源，集成多数据源，此处仅需配置主数据源
  datasource:
    dynamic:
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/easy-admin?useUnicode=true&characterEncoding=utf-8&useSSL=false&allowMulQueries=true&allowMultiQueries=true&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&nullDatabaseMeansCurrent=true&useInformationSchema=true
          username: root
          password: xxx
```
多数据源配置请参考[多数据源配置](xxx, '多数据源配置')
## 配置上传的文件存放路径

打开`/easy-admin/easy-api/src/main/resources/application-dev.yml`文件，修改文件存放路径

```yaml {20}
############## X File Storage 配置 (文档: https://x-file-storage.xuyanwu.cn) ##############
dromara:
  x-file-storage: #文件存储配置
    default-platform: local-plus-1 #默认使用的存储平台
    thumbnail-suffix: ".min.jpg" #缩略图后缀，例如【.min.jpg】【.png】
    # 本地存储
    local-plus:
      # 存储平台标识
      - platform: local-plus-1
        # 启用存储
        enable-storage: true
        # 启用访问（线上请使用 Nginx 配置，效率更高）
        enable-access: true
        # 访问域名，例如：“http://127.0.0.1:8030/file/”，注意后面要和 path-patterns 保持一致，“/”结尾，本地存储建议使用相对路径，方便后期更换域名
        domain: ${project.url}/file/
        # 基础路径
        base-path: local-plus/
        # 访问路径
        path-patterns: /file/**
        # 存储路径，上传的文件都会存储在这个路径下面，默认“/”，注意“/”结尾
        storage-path: /Users/tengchong/development/easy-vben/
```
## 启动服务

执行`com.easy.admin.Application`启动服务