项目简介
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 一键启动。
bash
docker compose up -d --build默认访问地址：
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 可以作为一个不错的起点。
项目地址：