Go-Admin后台管理系统安装配置完全指南
项目基础介绍及主要编程语言
Go-Admin 是一个基于 Go (Golang) 开发的高效后台管理系统,它融合了 Gin 框架作为后端服务引擎,并搭配 Vue.js 和 Element UI 构建现代风格的前端界面。项目遵循 MIT 许可证,提供了一套完整的 RBAC (Role-Based Access Control) 权限管理方案,非常适合快速构建具备用户管理、认证和内容管理等功能的应用程序。
关键技术和框架
- 后端: 使用 Go 语言的 Gin 框架进行快速Web应用开发。
- 前端: 结合 Vue.js 和 Element UI 提供友好的用户体验界面。
- 数据库: 支持 MySQL,用于存储系统数据。
- 缓存: 可配置 Redis 进行高速数据访问。
- API 文档: 利用 Swagger 2.0 自动生成RESTful API文档。
- 身份验证: JWT 用于安全的用户认证。
安装和配置步骤
准备工作
确保您的开发环境中已安装以下组件:
- Go 1.13.3 或更高版本。
- MySQL 5.7 或更高版本。
- Redis 3.0 或更高版本。
- Node.js v14.x 或以上,npm 作为其包管理器。
- Git 用于克隆项目。
步骤一:获取项目源代码
打开终端,使用 Git 克隆项目:
git clone https://github.com/guyan0319/go-admin.git
cd go-admin
步骤二:安装后端依赖
确保你位于项目根目录,使用 go mod
管理依赖:
go mod download
步骤三:处理前端依赖(Vue-Element-Admin)
进入前端目录并安装 Node.js 包:
cd vue-element-admin
npm install --registry=https://registry.npm.taobao.org
如果遇到 node_modules.zip
,需先解压至当前目录的 node_modules
文件夹中,或者直接按上述命令安装依赖。
步骤四:数据库准备
- 导入
data/systemdb.sql
到您的 MySQL 中。 - 修改后端配置文件
conf/mysql.go
以匹配你的数据库配置。
var Db = map[string]DbConfig{
"db1": {
DriverName: "mysql",
Dsn: "your_username:your_password@tcp(127.0.0.1:3306)/systemdb?charset=utf8mb4&parseTime=True&loc=Local",
ShowSql: true,
ShowExecTime: false,
MaxIdle: 10,
MaxOpen: 200,
},
}
步骤五:配置 Redis
编辑 conf/redis.go
文件,输入你的 Redis 服务器配置:
var Redis = map[string]string{
"name": "redis",
"type": "tcp",
"address": "127.0.0.1:6379",
"auth": "",
}
步骤六:解决跨域问题
在 main.go
中调整 CORS 设置以允许你的前端域访问。
步骤七:启动后端服务
回到项目根目录,运行后端服务:
cd ..
go run main.go
步骤八:启动前端开发环境
返回前端目录并启动开发服务器:
cd vue-element-admin
npm run dev
步骤九:访问应用
在浏览器中打开 http://localhost:9527/#/login
,输入测试账号登录:
- 账户: admin
- 密码: 111111
至此,您已完成 Go-Admin 系统的基本安装与配置,可以开始探索和定制您的后台管理系统了。
以上是针对新手友好型的 Go-Admin 安装配置流程,确保每一步都按照指示完成,以便顺利启动项目。如果遇到问题,查看项目的官方文档或提交 Github Issue 获取帮助。