GoAdmin 权限管理系统安装配置完全指南

GoAdmin 权限管理系统安装配置完全指南

go-admin 基于Gin + Vue + Element UI & Arco Design & Ant Design 的前后端分离权限管理系统脚手架（包含了：多租户的支持，基础用户管理功能，jwt鉴权，代码生成器，RBAC资源控制，表单构建，定时任务等）3分钟构建自己的中后台项目；项目文档》：https://www.go-admin.pro V2 Demo： https://vue2.go-admin.dev V3 Demo： https://vue3.go-admin.dev Antd 订阅版：https://antd.go-admin.pro 项目地址: https://gitcode.com/gh_mirrors/go/go-admin

项目基础介绍及主要编程语言

GoAdmin 是一个基于Golang（使用Gin框架）和前端Vue技术栈（包括Element UI、Arco Design及Ant Design）的高效前后端分离权限管理系统。该框架旨在简化中后台项目的快速搭建，提供了多租户支持、用户管理、JWT身份验证、代码生成器、RBAC（Role-Based Access Control）资源控制、表单构建以及定时任务等功能。项目遵循MIT许可协议，允许开发者自由地使用和修改。

关键技术和框架

• 后端: Go语言（Gin框架），利用GORM作为数据库ORM库。
• 前端: 根据选择支持Vue.js，集成了Element UI、Arco Design和Ant Design三种UI框架。
• 认证机制: JWT（JSON Web Tokens）用于安全的用户鉴权。
• 权限模型: 基于Casbin实现RBAC访问控制模型。
• 其他: 集成Swagger用于API文档自动生成，以及代码生成工具减少开发工作量。

安装和配置步骤

准备环境

确保你的开发环境中已安装以下组件：

• Go: 版本1.18或更高。
• Node.js: 推荐版本v14.16.0及其以上。
• npm/cnpm: 至少版本6.14.11。
• Git: 用于克隆项目源代码。

步骤一：获取源代码

打开终端，执行以下命令下载后端和前端代码到同一目录下：

# 后端代码
git clone https://github.com/go-admin-team/go-admin.git
cd go-admin

# 前端代码（假设在同一个目录）
cd ..
git clone https://github.com/go-admin-team/go-admin-ui.git

步骤二：配置环境

1. 进入后端项目目录 (cd go-admin)。

2. 更新依赖并编译后端服务：

   go mod tidy
   go build
   

3. 修改配置文件以符合你的数据库设置。编辑 config/settings.yml 文件，设置正确的数据库连接信息。

   # 示例配置（根据实际数据库配置进行修改）
   database:
     default: mysql
     mysql:
       host: 127.0.0.1
       port: 3306
       user: root
       password: yourpassword
       dbname: goadmin
   

步骤三：初始化数据库和启动服务

1. 初始化数据库表结构：

   # 在Linux/macOS环境下
   ./go-admin migrate -c config/settings.yml
   
   # Windows环境下
   go-admin.exe migrate -c config/settings.yml
   

2. 启动后端服务：

   # 在Linux/macOS环境下
   ./go-admin server -c config/settings.yml
   
   # Windows环境下
   go-admin.exe server -c config/settings.yml
   

前端配置与启动

1. 切换到前端项目目录 (cd ../go-admin-ui)。

2. 安装前端依赖:

   npm install  # 或者使用cnpm install如果在国内
   

3. 启动前端开发服务器：

   npm run dev
   

此时，后端API服务应运行在约定的端口上（默认通常是8000），前端应用会在另一个端口启动（如localhost:9527），你可以通过浏览器访问前端界面，并与后端服务进行交互。

请注意，根据实际情况调整数据库配置和环境变量，以保证项目的顺利运行。此外，对于生产部署，还有额外的安全性和性能考虑需要实施，这里提供的主要是开发环境的快速入门指南。

go-admin 基于Gin + Vue + Element UI & Arco Design & Ant Design 的前后端分离权限管理系统脚手架（包含了：多租户的支持，基础用户管理功能，jwt鉴权，代码生成器，RBAC资源控制，表单构建，定时任务等）3分钟构建自己的中后台项目；项目文档》：https://www.go-admin.pro V2 Demo： https://vue2.go-admin.dev V3 Demo： https://vue3.go-admin.dev Antd 订阅版：https://antd.go-admin.pro 项目地址: https://gitcode.com/gh_mirrors/go/go-admin