【guns】开源下载和安装教程
1、项目介绍
Guns是一个基于Spring Boot3 + Vue3 + JDK17的现代化Java应用开发框架,采用插件化架构设计,提供20+开箱即用功能模块(如用户管理、权限控制、文件管理等),显著提升企业级应用开发效率。其核心特点包括:
- 模块化内核,支持灵活装配插件
- 自动化SQL迁移(Flyway集成)
- 前后端分离架构(Antd Vue前端)
- 企业级安全策略(密码策略、国密加密等)
2、项目下载位置
通过以下途径获取项目代码:
- 主项目仓库:GitCode平台搜索
javaguns/guns - 核心包仓库:GitCode平台搜索
javaguns/roses
推荐下载方式(命令行):
git clone https://gitcode.com/javaguns/guns.git
3、项目安装环境配置
基础环境要求
| 组件 | 版本要求 |
|---|---|
| JDK | 17+ |
| MySQL | 5.7/8.0 |
| Node.js | 20.x |
| Yarn | 1.22+ |
![环境配置示意图] (图示建议:展示JDK版本验证java -version、MySQL服务状态、Node环境检查node -v的终端截图)
4、项目安装方式
后端部署步骤
- 创建空数据库(建议字符集utf8mb4):
CREATE DATABASE guns DEFAULT CHARACTER SET utf8mb4;
- 修改数据库配置:
# application-local.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/guns?useSSL=false
username: root
password: your_password
- 启动主类:
运行 guns-admin模块下的 ProjectStartApplication
前端部署步骤
# 安装依赖
yarn install
# 开发模式运行
yarn run dev
# 生产构建
yarn run build
![启动成功示意图] (图示建议:展示后端启动成功的控制台日志、前端本地访问界面)
5、项目处理脚本
常用脚本说明
- 数据库初始化脚本(自动执行):
- Flyway会在首次启动时自动创建表结构
- 后端快捷命令:
# 清理并重新构建
mvn clean package -DskipTests
# 指定环境启动
java -jar guns-admin.jar --spring.profiles.active=prod
- 前端调试脚本:
# 接口代理配置(vite.config.ts)
server: {
proxy: {
'/api': 'http://localhost:8080'
}
}
初始化账户
系统自动创建默认管理员:
- 账号:admin
- 密码:123456
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



