菜单、按钮、API 三层 RBAC 权限控制,配合动态路由与菜单自动生成
gvray-react — React 后台模板
作者 gvray
基于 React、Umi、TypeScript 与 Ant Design 的企业级后台模板,内置 RBAC 权限、动态路由、多主题、国际化与 Mock/OpenAPI 能力,可作为中后台项目的起步框架。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 2
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
access + refresh 双 Token 认证,带过期缓冲策略
Zustand 状态管理,支持持久化与 Immer
浅色/深色多主题切换与基于 React Intl 的国际化
Mock 与真实接口无缝切换,OpenAPI 自动同步 TypeScript 类型
TablePro 增强表格内置高级搜索、分页、刷新与 useTablePro Hook
模板详细介绍
gvray-react 是一个以 React、Umi、TypeScript 和 Ant Design 构建的企业级后台管理模板,定位为可直接使用的 Starter Template。它把权限体系作为核心设计:菜单、按钮与 API 三层 RBAC 控制,配合 access + refresh 双 Token 认证和基于权限自动生成的动态路由与菜单,让不同角色看到不同的界面与操作入口。状态管理使用 Zustand,支持持久化与 Immer;请求层基于 @gvray/request 的 Axios 管线,提供统一错误处理。
模板内置浅色与深色多主题切换、基于 React Intl 的国际化、全局字典系统(DictionaryLabel、DictionarySelect、useDict)、全局错误边界以及 TablePro 增强表格(高级搜索、分页、刷新、useTablePro Hook)。工程侧提供 Mock 与真实接口切换、OpenAPI 自动同步 TypeScript 类型、运行时配置、Docker 与多环境配置。功能模块覆盖身份与权限、组织架构、系统管理、系统监控和日志审计,仓库附带架构文档、开发指南、主题规范与 Docker 部署说明。
适合你的项目吗?
适用场景
- 企业后台管理系统的基础框架搭建
- SaaS 管理平台与中后台管理平台开发
- 需要 RBAC 权限体系与动态路由的权限系统
- 作为 Admin Starter Template 或前端架构实践项目
适合人群
- 使用 React、Umi、TypeScript 与 Ant Design 技术栈的团队
- 需要菜单、按钮、API 三层权限控制的后台项目
- 希望以现成模板起步并保留 Mock/OpenAPI 工作流的前端开发者
- 需要多主题与国际化支持的中后台产品
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
环境要求 Node.js >= 20,并使用 Node 内置的 Corepack
- 2
使用 pnpm install 安装依赖
- 3
pnpm start 或 pnpm start:dev 使用内置 Mock 数据,测试账号 admin / 123456
- 4
pnpm start:staging 连接 gvray-admin 后端,推荐先启动后端再体验完整功能
- 5
环境变量配置参考 .env.dev、.env.staging、.env.prod
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可证允许免费使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本,仅需保留版权和许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明和许可声明
额外费用与待核对事项
- README未提供额外条款,无法确认演示素材或第三方资源的授权范围
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
许可证原文
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
许可证原文
https://github.com/gvray/gvray-react/blob/main/LICENSEhttps://github.com/gvray/gvray-react/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 86 / 100
- 技术栈
- React
- 网站类型
- 后台 · 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-09-11
- 截图检查日期
- 2026-09-14
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 React。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。
ant-design-pro
Ant Design Pro 是 Ant Design 官方推出的企业级中后台前端脚手架,基于 React 19、Umi Max 4 和 antd 6 构建,内置 TypeScript 支持。
React · 后台

react-boilerplate
react-boilerplate 是一个为有一定 React 和 Redux 经验的开发者设计的启动器,目标是快速搭建可扩展、离线优先的 Web 应用。
React · 启动器

coreui-free-react-admin-template
Free React Admin & Dashboard Template Built for AI-Assisted Development
React · 后台

fastapi-react
fastapi-react 是一个基于 Cookiecutter 的模板,用于快速搭建 FastAPI 与 React(TypeScript)的全栈项目。
React · 后台

react-antd-admin-template
一个基于React+Antd的后台管理模版,在线预览https://nlrx-wjc.github.io/react-antd-admin-template/
React · 后台

shadcn-landing-page
Free Landing page template using Shadcn, React, Typescript and Tailwind
React · 企业官网
