BeaverX Admin：一套真正能跑起来的开源管理后台

如果你正在找一套前后端完整、能直接二开、文档跟得上的管理后台方案，BeaverX Admin 值得放进你的候选清单。

它不是「只有登录页」的 Demo，也不是把官方模板简单拼在一起------从 RBAC 权限 、服务端菜单 、站内信与 SignalR 实时推送 ，到 Hangfire 定时任务 、CAP 异步导出 、多节点部署指引，都是可运行、可扩展的生产级骨架。

在线体验，无需本地搭建

项目	说明
演示地址	https://beaverxadmin.com/
默认账号	`admin` / `Admin@123`
文档站	https://docs.beaverxadmin.com/

开源演示说明 ：本站为 BeaverX Admin 开源项目在线演示。演示环境每 5 分钟自动清理数据，请勿保存重要信息或用于生产。

打开即可体验：用户/角色/菜单、字典与配置、定时任务与 Hangfire 面板、在线用户、支付示例、富文本与签名等组件------侧边栏里有的，不是空壳。

功能界面预览

以下为在线演示主要界面截图（admin / Admin@123），更多见功能预览。

首页

用户管理

角色管理

字典管理

配置管理

定时任务

Hangfire 调度面板（/hangfire，独立账号，见后端配置）：

在线用户

支付宝

富文本

用户中心

前后端仓库，职责清晰

仓库	技术	说明
beaverx-vue-admin	Vue 3 + TypeScript + Arco Design + Vite 8	管理端 UI，服务端菜单动态路由
BeaverX.Admin	.NET 10 + EF Core + BeaverX 模块化框架	REST API、权限、种子数据、基础设施

数据库支持 PostgreSQL （默认 master 分支）与 MySQL 8+ （master-mysql 分支），前端无需改动，后端切换分支并配置连接串即可。

为什么选它？

1. 服务端菜单 + 权限，前后端对齐

菜单、路由、component 由后端下发，前端按 views/ 路径自动匹配页面
目录 / 菜单 / 按钮三级 RBAC，权限码前后端一致
新增业务模块有完整文档：Entity → AppService → Controller → 菜单种子 → 前端页面

踩坑最多的 403（component 不一致） 在文档里写清楚了，照着做一般一次过。

2. 现代技术栈，长期可维护

后端：.NET 10、JWT + Refresh Token、Serilog、EF Core 迁移、MinIO 文件存储、可切换 Memory/Redis 缓存。

前端：Vue 3 Composition API、Pinia、Vite 8、SignalR 实时通知（导出进度、未读消息），打包后支持新版本检测弹窗提醒用户刷新。

3. 企业场景常见能力，默认就有

能力	说明
站内信	管理端发送 + 用户收件箱 + 未读角标
SignalR	导出任务、未读消息推送，告别轮询
Hangfire	后台 HTTP 定时任务 + 代码 `IRecurringJob` 双模式
异步导出	CAP + 数据库 + MinIO，带幂等与恢复
在线用户	单实例内存 / 多节点 Redis 追踪
多节点部署	文档说明缓存、Backplane、CAP 队列如何改

4. 保姆级文档，不是 README 一发了事

文档站定位是 「从零跑通 → 加菜单 → 加权限 → 加 CRUD 模块」 的连续教程：

适合个人学习、团队内训、以及需要快速交付管理后台原型的场景。

适合谁？

全栈 / 后端：想用 .NET 10 搭一套标准分层后台，不想从零造 RBAC 轮子
前端：熟悉 Vue，希望对接真实 API、服务端菜单、权限指令的完整范例
技术负责人：需要可演示、可二开、文档齐全的开源底座，缩短从 0 到 1 的时间
学习者：通过可读代码 + 教程，理解「管理后台」常见模块怎么串起来

5 分钟本地启动

后端（PostgreSQL 示例）：

bash 复制代码

git clone https://github.com/hdonghua/BeaverX.Admin.git
cd BeaverX.Admin
# 配置 appsettings.Development.json 中的数据库连接串
dotnet ef database update --project BeaverX.Admin.EntityFrameworkCore --startup-project BeaverX.Admin.Http.Host
dotnet run --project BeaverX.Admin.Http.Host

前端：

bash 复制代码

git clone https://github.com/hdonghua/beaverx-vue-admin.git
cd beaverx-vue-admin
pnpm i
# .env.development 中配置 VITE_API_BASE_URL=http://localhost:5216
pnpm dev

浏览器打开 http://localhost:5173，使用 admin / Admin@123 登录。

MySQL 用户请切换后端至 master-mysql 分支，详见 MySQL 支持。

开源与共建

BeaverX Admin 以开源方式发布。若你觉得项目有帮助，欢迎在 GitHub 上给 beaverx-vue-admin 和 BeaverX.Admin 点个 Star------这是对我们最大的鼓励，也能让更多人发现这套方案。

欢迎：

Star 支持项目传播
提交 Issue 反馈问题与需求
Pull Request 贡献代码与文档

链接	地址
前端仓库	github.com/hdonghua/beaverx-vue-admin
后端仓库	github.com/hdonghua/BeaverX.Admin
在线演示	beaverxadmin.com
文档站	docs.beaverxadmin.com

开始阅读教程

若你准备动手，建议按这条路径走：

项目介绍 → 环境准备 → 10 分钟跑起来 → 后端概览 → 前端概览

BeaverX Admin --- 让管理后台从「能跑」到「能改」，再快一步。