# go-admin

**Repository Path**: cnygf/go-admin

## Basic Information

- **Project Name**: go-admin
- **Description**: go-admin后台开发框架
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-20
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# go-admin
<div align="center">
	<img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/gfastlogo.png">
    <p>
        <h1>go-admin v1.0.1</h1>
    </p>
    <p align="center">
        <a href="https://github.com/gin-gonic/gin" target="_blank">
	        <img src="https://img.shields.io/badge/gin-v1.9.1-green" alt="gin">
	    </a>
	    <a href="https://v3.vuejs.org/" target="_blank">
	        <img src="https://img.shields.io/badge/vue.js-vue3.x-green" alt="vue">
	    </a>
	    <a href="https://element-plus.gitee.io/#/zh-CN/component/changelog" target="_blank">
	        <img src="https://img.shields.io/badge/element--plus-%3E1.0.0-blue" alt="element plus">
	    </a>
		<a href="https://www.tslang.cn/" target="_blank">
	        <img src="https://img.shields.io/badge/gorm-%3E1.0.0-blue" alt="typescript">
	    </a>
		<a href="https://vitejs.dev/" target="_blank">
		    <img src="https://img.shields.io/badge/vite-%3E2.0.0-yellow" alt="vite">
		</a>
		<a href="https://github.com/yangzongzhuan/RuoYi-Vue3/blob/master/LICENSE" target="_blank">
		    <img src="https://img.shields.io/badge/RuoYi_Vue3_license-MIT-success" alt="license">
		</a>
	</p>
</div>



## 平台简介
* 基于全新iris+gorm+Vue3+Element Plus开发的全栈前后端分离的管理系统
* 前端采用RuoYi-Vue3 、Vue、Element UI。
* 本项目由<a href="https://github.com/cn-ygf/go-admin/" target="_blank"><b>YGF</b></a>个人开发。

## 特征
* 高生产率：几分钟即可搭建一个后台管理系统
* 模块化：单应用多系统的模式，将一个完整的应用拆分为多个系统，后续扩展更加便捷，增加代码复用性。
* 代码生成: 一键生成CRUD业务
* 面向接口开发


## 内置功能

1.  用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2.  部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
3.  岗位管理：配置系统用户所属担任职务。
4.  菜单管理：配置系统菜单，操作权限，按钮权限标识等。
5.  角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
6.  字典管理：对系统中经常使用的一些较为固定的数据进行维护。
7.  参数管理：对系统动态配置常用参数。
8.  操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
9.  登录日志：系统登录日志记录查询包含登录异常。
10. 在线用户：当前系统中活跃用户状态监控。
11. 定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。
12. 代码生成：前后端代码的生成。
13. 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。
14. 在线构建器：拖动表单元素生成相应的HTML代码。
15. 文件上传,缓存标签等。

## 演示地址
[https://demo.go-admin.io](https://demo.go-admin.io)
账号：demo  密码：123456
## 获取代码
```shell
git clone https://gitee.com/cnygf/go-admin
cd go-admin
```
## 配置
项目数据库文件 `resource/data/db.sql` 创建数据库导入后修改配置 `config.yaml.bak` 复制改为`config.yaml`

其中config.yaml配置
```yaml
server:
  # web服务绑定地址，最好加一层nginx
  addr: 127.0.0.1:8081
  # 后台接口路由
  path: "/go-admin-api"
  # 开发模式
  dev: true
  # token过期时间(秒)
  tokenExpires: 7200


# redis服务器
redis:
  host: 127.0.0.1
  port: 6379
  pass: ""
  db: 3

# mysql
mysql:
  host: 127.0.0.1
  port: 3306
  user: root
  pass: 123456
  db: go_admin
```
# 编译和运行
## linux/unix/darwin
```shell
export GOPROXY=https://goproxy.cn
go mod tidy
go build -o go-admin
./go-admin --config=config.yaml
```
## windows
```shell
set GOPROXY https://goproxy.cn
go mod tidy
go build -o go-admin.exe
go-admin.exe --config=config.yaml
```

## docker
```shell
docker build -t go-admin:latest .
docker exec -itd --name go-admin-prd -p 127.0.0.1:8081:8081 go-admin:latest
```

## docker-compose编排一键启动
```shell
docker-compose up -d
```

项目为前后端分离，前端地址：

github地址：[https://github.com/cn-ygf/go-admin-ui](https://github.com/cn-ygf/go-admin-ui)

gitee地址：[https://gitee.com/cnygf/go-admin-ui](https://gitee.com/cnygf/go-admin-ui)

## 文档地址
> [http://doc.g-fast.cn/docs/gfast32](http://doc.g-fast.cn/docs/gfast32)

## 演示图

<table>
    <tr>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01e1blsg80hagzj.png"/></td>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01gckl91kjetl0d.png"/></td>
    </tr>
    <tr>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01gckl91ky1lm3d.png"/></td>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01kkmk7sc1txfvz.png"/></td>
    </tr>
    <tr>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01kkmkfi4syoydw.png"/></td>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01s04zq2470mx3r.png"/></td>
    </tr>
	<tr>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01kkmkfi4tquojj.png"/></td>
        <td><img src="https://yxh-1301841944.cos.ap-chongqing.myqcloud.com/gfast/2022-04-19/cje01s04zq245k17ta.png"/></td>
    </tr>
</table>

## 感谢(排名不分先后)
> iris [https://github.com/kataras/iris](https://github.com/kataras/iris)
>
> gorm [https://github.com/go-gorm/gorm](https://github.com/go-gorm/gorm)
> 
> RuoYi-Vue3 [https://github.com/yangzongzhuan/RuoYi-Vue3](https://github.com/yangzongzhuan/RuoYi-Vue3)

> 感谢你使用go-admin,个人精力时间有限，捐赠99元即可提供业余时间的技术服务。
> 同时您也可以联系我，雇佣我为您干活，谢谢合作！

## 免责声明：
> 1、go-admin仅限自己学习使用，一切商业行为与go-admin无关。

> 2、用户不得利用go-admin从事非法行为，用户应当合法合规的使用，发现用户在使用产品时有任何的非法行为，go-admin有权配合有关机关进行调查或向政府部门举报，go-admin不承担用户因非法行为造成的任何法律责任，一切法律责任由用户自行承担，如因用户使用造成第三方损害的，用户应当依法予以赔偿。

> 3、所有与使用go-admin相关的资源直接风险均由用户承担。


## 商用说明
> 商用注意事项
如果您将此项目用于商业用途，请遵守Apache2.0协议并保留作者技术支持声明。

* go-admin快速开发平台采用Apache-2.0技术协议
* 二次开发如用于商业性质或开源竞品请不要删除和修改go-admin源码头部的版权与作者声明及出处
* 允许进行商用，但是不允许二次开源出来并进行收费
* 我们已经申请了相关的软件著作权和相关登记（证书号:软著登字第xxx号）
* 如果您在自己的项目中使用了我们项目中的扩展或模块，请在项目介绍中进行明确说明

## 支持开源
如果您喜爱go-admin，请给常熬夜的作者来杯茶吧！
> 微信扫一扫
> 
<img src="resources/img/pay.png" width="50%">