【ballcat】开源下载和安装教程

技术文档

【ballcat】开源下载和安装教程

【免费下载链接】ballcat 😸一个便捷好用的框架库，提供了如数据权限、国际化、API验签、WebSocket、操作日志、OpenAPI、数据脱敏、幂等组件、XSS防注入等等一系列组件项目地址: https://gitcode.com/ballcat-projects/ballcat

1、项目介绍

BallCat 是一个基于 Spring Boot 的快速开发框架，提供数据权限、国际化、API验签、WebSocket、操作日志等丰富组件。支持多仓库分发（Github/Gitee/GitCode），当前主分支为 2.x 开发版本，1.x 版本需切换对应分支。

2、项目下载位置

核心仓库：ballcat（基础功能组件）
其他模块：ballcat-business（通用业务）、ballcat-codegen（代码生成器）等

下载方式（任选其一）：

git clone https://github.com/ballcat-projects/ballcat.gitgit clone https://gitee.com/ballcat-projects/ballcat.git

3、项目安装环境配置

基础环境要求：

JDK 1.8+
Maven 3.5+
MySQL 5.7+
Redis 5+

配置示例：

MySQL 数据库创建：

CREATE DATABASE ballcat CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

Redis 配置（默认端口 6379，无密码）

4、项目安装方式

步骤 1：初始化数据库 执行 sql/ballcat.sql 文件至 MySQL

步骤 2：修改配置文件 编辑 ballcat-boot/src/main/resources/application.yml：

spring: datasource: url: jdbc:mysql://localhost:3306/ballcat?useSSL=false username: root password: 123456 redis: host: localhost port: 6379

步骤 3：编译项目

mvn clean install

步骤 4：启动服务

cd ballcat-bootmvn spring-boot:run

5、项目处理脚本

常用脚本示例：

快速清理编译缓存：

# Linux/macOS./mvnw clean# Windowsmvnw.cmd clean

生成代码（需配合 ballcat-codegen）：
```
mvn ballcat-codegen:generate
```

注意事项：

2.x 版本需使用 JDK 11+
前端项目需额外安装 Node.js 环境

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

【ballcat】开源下载和安装教程