Gin-Admin 项目安装与配置指南

Gin-Admin 项目安装与配置指南

1. 项目基础介绍

Gin-Admin 是一个基于 Go 语言的开源项目，它提供了一个功能丰富、易于使用的后台管理系统。该项目使用 Gin 框架进行开发，旨在帮助开发者快速构建高效的后端服务。

2. 项目使用的关键技术和框架

• Gin: 一个高性能的 Web 框架，用于快速构建 HTTP Web 服务。
• GORM: 一个流行的 Go 语言 ORM 库，用于处理数据库操作。
• JWT: JSON Web Tokens 用于用户认证和授权。
• Casbin: 一个强大的访问控制库，用于处理权限管理。
• Vue.js: 前端使用 Vue.js，是一个渐进式 JavaScript 框架。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

• Go: 安装 Go 语言环境，版本建议为 1.13 或以上。
• Node.js: 安装 Node.js，版本建议为 12.0 或以上。
• Git: 安装 Git 用于克隆和更新项目代码。

详细安装步骤

步骤 1: 克隆项目代码

打开命令行，执行以下命令克隆项目：

git clone https://github.com/LyricTian/gin-admin.git
cd gin-admin

步骤 2: 安装依赖

在项目根目录下，执行以下命令安装项目依赖：

go mod tidy

步骤 3: 配置数据库

修改配置文件 config.yaml 中的数据库配置，以匹配您的数据库设置。

database:
  # ... 其他数据库配置
  mysql:
    addr: "127.0.0.1:3306"
    user: "root"
    pass: "password"
    name: "gin_admin"

确保数据库已创建，并且用户具有访问权限。

步骤 4: 迁移数据库

执行以下命令进行数据库迁移：

go run migrate.go -path mysql

步骤 5: 运行项目

在项目根目录下，运行以下命令启动项目：

go run main.go

项目将启动，并监听默认的 HTTP 端口。

步骤 6: 构建前端

在项目根目录下，切换到前端目录，并执行以下命令：

cd web
npm install
npm run build

构建完成后，将生成的静态文件移动到后端服务指定的静态文件目录下。

步骤 7: 访问后台

在浏览器中输入 http://localhost:8000，即可访问后台管理系统。

以上就是 Gin-Admin 项目的详细安装和配置指南，按照以上步骤操作，您应该能够成功运行该项目。