项目简介

Shiyu Admin 是一个开源的通用后台管理系统，定位是为中后台业务提供一套开箱即用、结构清晰、便于二次
开发的基础框架。

项目内置了用户管理、角色管理、菜单管理、部门管理、操作日志、系统监控、数据管理等常见后台能力，适
合作为企业内部管理系统、权限后台、业务运营平台的起始模板。

项目地址：

https://github.com/Rodert/ShiyuAdmin

技术栈

前端：

• React
• Umi Max
• Ant Design ProComponents
• TypeScript
• Nginx

后端：

• Go
• Gin
• GORM
• PostgreSQL
• Redis
• JWT 鉴权

部署：

• Docker
• Docker Compose

核心功能

1. 用户与权限体系

项目内置基础 RBAC 权限模型：

• 用户管理
• 角色管理
• 菜单管理
• 用户角色关联
• 角色菜单权限关联
• 超级管理员标识
• 普通用户只读权限示例

默认会初始化：

• 超级管理员：拥有全部后台权限
• 普通用户：仅能访问欢迎页

2. 动态菜单

后台菜单来自后端接口，前端根据当前用户权限动态渲染菜单。

这意味着不同角色登录后，可以看到不同的功能入口，避免前端写死权限逻辑。

3. 操作日志

系统会记录关键操作日志，包括：

• 用户编码
• 用户名
• 模块
• 操作动作
• 请求方法
• 请求路径
• IP
• 状态
• 错误信息
• 耗时
• 创建时间

这对于后台系统审计、问题追踪和安全分析比较重要。

4. 系统监控

系统监控目前包含：

• Redis 缓存状态
• 在线用户
• 数据库状态
• 数据库版本
• 表数量
• 数据库连接池信息

这些信息可以帮助开发者快速判断系统运行状态。

5. 数据管理

数据管理模块可以查看数据库表结构和字段信息，包括：

• 表名
• 表类型
• 表注释
• 字段名
• 字段类型
• 是否可为空
• 最大长度
• 默认值
• 字段注释
• 表数据预览

表和字段注释对后台系统非常重要，尤其是项目长期维护时，可以显著降低理解成本。

6. 登录页与品牌化

项目登录页已做品牌化改造：

• 使用项目 Logo
• 深色左右分栏布局
• 默认账号填充
• 浏览器标签 favicon
• PWA manifest 信息
• Meta 描述

Meta 描述：

Shiyu Admin 是一个开源的通用后台管理系统。

本地 Docker 启动

项目支持 Docker Compose 一键启动。

docker compose up -d --build

默认访问地址：

前端：http://localhost:18000
后端：http://localhost:18080
PostgreSQL：localhost:15432
Redis：localhost:16379

查看服务状态：

docker compose ps

查看日志：

docker compose logs -f
docker compose logs -f shiyu-backend
docker compose logs -f shiyu-frontend

停止服务：

docker compose down

清理数据卷：

docker compose down -v

默认账号

管理员账号：

用户名：admin
密码：Admin@123

普通用户账号：

用户名：user
密码：User@123

普通用户默认只允许访问欢迎页，适合用于验证权限隔离效果。

项目特点

低耦合设计

项目尽量将职责拆分清楚：

• 前端页面只负责展示和交互
• API 请求集中在 services 层
• 后端接口、服务、仓储分层明确
• 数据库注释集中维护
• 权限种子逻辑保持幂等

这样后续扩展功能时，不需要在多个地方反复修改同一类逻辑。

开箱即用

通过 Docker Compose 可以直接启动：

• 前端
• 后端
• PostgreSQL
• Redis

适合快速体验，也适合拿来作为新后台项目的基础模板。

易于二次开发

项目已经包含后台系统常见的基础模块，后续可以继续扩展：

• 字典管理
• 参数配置
• 文件管理
• 通知公告
• 定时任务
• 多租户
• 数据权限增强
• API 文档集成
• 更多系统监控指标

适用场景

Shiyu Admin 适合以下场景：

• 企业内部管理后台
• SaaS 管理端
• 业务运营平台
• 权限管理系统
• Go + React 全栈项目脚手架
• 学习 RBAC、Gin、GORM、Ant Design Pro 的实践项目

总结

Shiyu Admin 的目标不是做一个复杂臃肿的大而全系统，而是提供一个清晰、实用、可持续扩展的后台管理基
础框架。

它已经具备后台系统常见的核心能力，包括用户、角色、菜单、部门、日志、监控和数据管理，并且支持
Docker 一键启动。

如果你正在寻找一个 Go + React 技术栈的开源后台项目，Shiyu Admin 可以作为一个不错的起点。

项目地址：

• https://github.com/Rodert/ShiyuAdmin