gmanager 开源项目安装与使用教程

gmanager 开源项目安装与使用教程

1. 项目介绍

gmanager 是一个基于 gf 框架的管理平台，支持登录、认证、组织机构、用户、角色、菜单和日志管理。该项目已全面支持前后端分离，同时也支持服务端模板部署。登录组件使用 gtoken 完美支持集群部署。

2. 项目快速启动

2.1 下载项目

首先，从 GitHub 下载 gmanager 项目：

git clone https://github.com/goflyfox/gmanager.git

2.2 安装 MySQL 数据库

创建数据库并运行 deploy 目录下的 gmanager.sql 脚本：

CREATE DATABASE gmanager;
USE gmanager;
SOURCE /path/to/gmanager.sql;

2.3 配置数据库连接

修改 config 目录下的 config.toml 配置文件，配置数据库连接信息：

[database]
link = "root:123456@tcp(127.0.0.1:3306)/gmanager"

2.4 运行项目

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

go run main.go

访问 http://localhost 即可看到登录页面，默认账号和密码为 admin/123456。

2.5 服务端打包

可以使用 gf-cli 进行打包，也可以通过原始交叉编译命令打包：

# 打linux环境包
SET CGO_ENABLED=0
SET GOOS=linux
SET GOARCH=amd64
go build main.go

# 打本地环境包
go build main.go

3. 应用案例和最佳实践

3.1 前后端分离部署

gmanager 完全支持前后端分离部署。前端使用 vue-admin-template，具体步骤如下：

1. 下载前端代码：

git clone https://github.com/goflyfox/gmanager-web.git

2. 安装依赖并运行前端项目：

cd gmanager-web
npm install
npm run dev

3. 运行数据库脚本 gmanager-web.sql 以适应前后端分离的菜单结构。

3.2 集群部署

gmanager 使用 gtoken 组件支持集群部署，确保在高并发环境下登录认证的稳定性和安全性。

4. 典型生态项目

4.1 gf 框架

gmanager 基于 gf 框架开发，gf 是一个高性能、模块化、易扩展的 Go 语言开发框架。了解更多信息，请访问 gf 框架 GitHub 页面。

4.2 gmanager-web

gmanager-web 是 gmanager 的前端项目，使用 vue-admin-template 模板开发，提供完整的前端界面和交互逻辑。了解更多信息，请访问 gmanager-web GitHub 页面。

通过以上步骤，您可以快速启动并部署 gmanager 项目，并根据实际需求进行定制和扩展。