youlai-gin

🖥️ 在线预览  |  📑 阅读文档  |  🌐 官网

📢 项目简介

youlai-gin 是 vue3-element-admin 的 Go/Gin 后端实现，接口路径与返回结构完全对齐，可直接为前端提供后端服务。

• 🚀 技术栈：Go 1.25+ + Gin + GORM，轻量高性能组合
• 🔐 安全认证：JWT 无状态认证 + Redis 会话管理，支持会话治理
• 🔑 权限管理：RBAC 权限模型，菜单/按钮/接口三级权限统一治理
• 🛠️ 模块能力：用户、角色、菜单、部门、字典、日志等核心模块开箱即用

🌈 项目源码

项目	Gitee	GitHub	GitCode
✅ Go 后端	youlai-gin	youlai-gin	youlai-gin
Vue3 管理端	vue3-element-admin	vue3-element-admin	vue3-element-admin
uni-app 移动端	vue-uniapp-template	vue-uniapp-template	vue-uniapp-template

项目目录

目录结构

youlai-gin/
├─ configs/                   # 配置文件
│  ├─ dev.yaml                # 开发环境配置
│  ├─ prod.yaml               # 生产环境配置
│  └─ test.yaml               # 测试环境配置
├─ docs/                      # 项目文档
├─ examples/                  # 示例代码
├─ internal/                  # 核心业务源码
│  ├─ auth/                   # 认证模块(登录/Token/会话)
│  ├─ health/                 # 健康检查
│  ├─ platform/               # 平台模块(文件/扩展能力)
│  ├─ router/                 # 路由注册
│  └─ system/                 # 系统模块(用户/角色/菜单等)
├─ pkg/                       # 通用包 (中间件/响应等)
│  ├─ middleware/             # 中间件(JWT/CORS/RequestID)
│  ├─ response/               # 统一响应结构
│  ├─ database/               # 数据库连接
│  ├─ redis/                  # Redis 连接
│  ├─ logger/                 # 日志
│  └─ ...                     # 其他通用工具
├─ scripts/                   # 数据库脚本
├─ Dockerfile                 # Docker 镜像构建文件
├─ go.mod                     # 依赖管理
├─ go.sum                     # 依赖版本锁定
└─ main.go                    # 应用入口

🚀 快速启动

1. 环境准备

技术	版本/说明	安装文档
Go	1.25 或更高版本	官方下载
MySQL	5.7 或 8.x	Windows / Linux
Redis	7.x	Windows / Linux

💡 贴心小提示：本地未配置 MySQL、Redis 不影响启动，项目默认会连接 youlai 线上公共环境运行，方便您快速体验。

2. 开发工具

GoLand（推荐）：

• 直接使用 JetBrains GoLand 即可，首次打开项目时按提示下载/配置 Go SDK。

VS Code：

1. 安装 VS Code 扩展插件（扩展市场搜索安装）：

   插件名称	作用
   Go	Go 语言支持（gopls/调试/格式化/测试）
   Go Test Explorer	测试用例可视化运行（可选）
   REST Client	直接在 VS Code 内调试 HTTP 接口（可选）

2. 安装 Go 工具链（首次使用 Go 扩展通常会提示安装）：

   在 VS Code 命令面板（Ctrl+Shift+P）中执行 Go: Install/Update Tools，建议至少安装：

   • gopls（语言服务）
   • dlv（Delve 调试器）
   • goimports（自动整理 imports）

3. 初始化数据库

使用数据库客户端（如 Navicat、DBeaver）执行 scripts/mysql/youlai_admin.sql 脚本，完成数据库和基础数据的初始化。

4. 修改配置

编辑 configs/dev.yaml 文件，根据实际情况修改 MySQL 和 Redis 的连接字符串。

5. 启动项目

# 下载依赖
go mod tidy

# 生成 Swagger 文档 (可选)
# swag init

# 启动项目
go run main.go

💡 开发技巧：热重载 推荐使用 air 工具实现热重载，提升开发效率。

# 安装 air
go install github.com/cosmtrek/air@latest

# 启动 (代替 go run)
air

启动成功后，访问 http://localhost:8000/swagger/index.html 验证项目是否成功。

🤝 前端整合

youlai-gin 与 vue3-element-admin 前后端协议完全兼容，可无缝对接。

# 1. 获取前端项目
git clone https://gitee.com/youlaiorg/vue3-element-admin.git
cd vue3-element-admin

# 2. 安装依赖
pnpm install

# 3. 配置后端地址 (编辑 .env.development)
VITE_APP_API_URL=http://localhost:8000

# 4. 启动前端
pnpm run dev

• 访问地址: http://localhost:3000
• 登录账号: admin / 123456

🐳 项目部署

1. 编译部署

# 编译适用于当前系统的二进制文件
go build -o youlai-gin main.go

# 运行
./youlai-gin

💡 提示：为了让服务在后台持续运行，你可以使用 nohup ./youlai-gin & 命令，或使用 Systemd 进行进程守护。

2. Docker 部署

# 构建镜像
docker build -t youlai-gin:latest .

# 运行容器
docker run -d -p 8000:8000 --name youlai-gin youlai-gin:latest

💖 技术交流

• 问题反馈：Gitee Issues
• 技术交流：关注公众号【有来技术】回复“交流群”，或加微信好友【haoxianrui】进微信群
• 官网主页：https://www.youlai.tech