Gin-Admin
基于 Golang + Gin + GORM 2.0 + Casbin 2.0 + Wire DI 的轻量级、灵活、优雅且功能齐全的 RBAC 脚手架。
English | 中文
- 📜 优雅实现
RESTful API，采用接口化编程范式，让您的 API 设计更加专业规范 - 🏠 采用清晰简洁的模块化架构，让代码结构一目了然，维护升级更轻松自如
- 🚀 基于高性能
GIN框架，集成丰富实用的中间件（身份认证、跨域、日志、限流、链路追踪、权限控制、容错、压缩等），助您快速构建企业级应用 - 🔐 集成业界领先的
Casbin权限框架，灵活精准的 RBAC 权限控制让安全防护固若金汤 - 📄 基于功能强大的
GORM 2.0ORM 框架，优雅处理数据库操作，大幅提升开发效率 - 🔌 创新采用
WIRE依赖注入，革命性地简化模块依赖关系，让代码更加优雅解耦 - 📝 基于高性能
Zap日志框架，配合 Context 链路追踪，让系统运行状态清晰透明，问题排查无所遁形 - 🔑 整合久经考验的
JWT认证机制，让用户身份验证更加安全可靠 - 🔬 自动集成
Swagger接口文档，API 文档实时更新，开发调试更轻松 - 在线体验 - 🔧 完善的单元测试体系，基于
testify框架保障系统质量，让 bug 无处藏身 - 💯 采用无状态设计，支持水平扩展，搭配 Redis 实现动态权限管理，让您的系统轻松应对高并发
- 🔨 开发者福音！配套强大的脚手架工具 gin-admin-cli，让您的开发工作事半功倍
- Go 1.19+
- Wire
go install github.com/google/wire/cmd/wire@latest - Swag
go install github.com/swaggo/swag/cmd/swag@latest - GIN-ADMIN-CLI
go install github.com/gin-admin/gin-admin-cli/v10@latest
可通过
gin-admin-cli help new查看命令的详细说明
gin-admin-cli new -d ~/go/src --name testapp --desc 'A test API service based on golang.' --pkg 'github.com/xxx/testapp' --git-url https://gitee.com/lyric/gin-admin.git通过更改
configs/dev/server.toml配置文件中的MenuFile = "menu_cn.json"可以切换到中文菜单
cd ~/go/src/testapp
make start
# or
go run main.go startmake build
# or
go build -ldflags "-w -s -X main.VERSION=v1.0.0" -o testappdocker build -f ./Dockerfile -t testapp:v1.0.0 .可通过
gin-admin-cli help gen查看命令的详细说明
- name: Dictionary
comment: 字典管理
disable_pagination: true
fill_gorm_commit: true
fill_router_prefix: true
tpl_type: "tree"
fields:
- name: Code
type: string
comment: Code of dictionary (unique for same parent)
gorm_tag: "size:32;"
form:
binding_tag: "required,max=32"
- name: Name
type: string
comment: Display name of dictionary
gorm_tag: "size:128;index"
query:
name: LikeName
in_query: true
form_tag: name
op: LIKE
form:
binding_tag: "required,max=128"
- name: Description
type: string
comment: Details about dictionary
gorm_tag: "size:1024"
form: {}
- name: Sequence
type: int
comment: Sequence for sorting
gorm_tag: "index;"
order: DESC
form: {}
- name: Status
type: string
comment: Status of dictionary (disabled, enabled)
gorm_tag: "size:20;index"
query: {}
form:
binding_tag: "required, enabled"gin-admin-cli gen -d . -m SYS -c dictionary.yaml可通过
gin-admin-cli help remove查看命令的详细说明
gin-admin-cli rm -d . -m CMS --structs Article通过 Swag 可以自动生成 Swagger 文档
make swagger
# or
swag init --parseDependency --generalInfo ./main.go --output ./internal/swagger依赖注入本身的作用是解决了各个模块间层级依赖繁琐的初始化过程，通过 Wire 可以自动生成依赖注入代码，简化依赖注入的过程。
make wire
# or
wire gen ./internal/wirex├── cmd (命令行定义目录)
│ ├── start.go (启动命令)
│ ├── stop.go (停止命令)
│ └── version.go (版本命令)
├── configs
│ ├── dev
│ │ ├── logging.toml (日志配置文件)
│ │ ├── middleware.toml (中间件配置文件)
│ │ └── server.toml (服务配置文件)
│ ├── menu.json (初始化菜单文件)
│ └── rbac_model.conf (Casbin RBAC 模型配置文件)
├── internal
│ ├── bootstrap (初始化目录)
│ │ ├── bootstrap.go (初始化)
│ │ ├── http.go (HTTP 服务)
│ │ └── logger.go (日志服务)
│ ├── config (配置文件目录)
│ │ ├── config.go (配置文件初始化)
│ │ ├── consts.go (常量定义)
│ │ ├── middleware.go (中间件配置)
│ │ └── parse.go (配置文件解析)
│ ├── mods
│ │ ├── rbac (RBAC 模块)
│ │ │ ├── api (API层)
│ │ │ ├── biz (业务逻辑层)
│ │ │ ├── dal (数据访问层)
│ │ │ ├── schema (数据模型层)
│ │ │ ├── casbin.go (Casbin 初始化)
│ │ │ ├── main.go (RBAC 模块入口)
│ │ │ └── wire.go (RBAC 依赖注入初始化)
│ │ └── mods.go
│ ├── utility
│ │ └── prom
│ │ └── prom.go (Prometheus 监控，用于集成 prometheus)
│ └── wirex (依赖注入目录，包含了依赖组的定义和初始化)
│ ├── injector.go
│ ├── wire.go
│ └── wire_gen.go
├── pkg (公共包目录)
│ ├── cachex (缓存包)
│ ├── crypto (加密包)
│ │ ├── aes (AES加密)
│ │ ├── hash (哈希加密)
│ │ └── rand (随机数)
│ ├── encoding (编码包)
│ │ ├── json (JSON编码)
│ │ ├── toml (TOML编码)
│ │ └── yaml (YAML编码)
│ ├── errors (错误处理包)
│ ├── gormx (Gorm扩展包)
│ ├── jwtx (JWT包)
│ ├── logging (日志包)
│ ├── mail (邮件包)
│ ├── middleware (中间件包)
│ ├── oss (对象存储包)
│ ├── promx (Prometheus包)
│ └── util (工具包)
├── test (单元测试目录)
│ ├── menu_test.go
│ ├── role_test.go
│ ├── test.go
│ └── user_test.go
├── Dockerfile
├── Makefile
├── README.md
├── go.mod
├── go.sum
└── main.go (入口文件)