新手推荐路径

拿到源码后,按这条路径开始第一个模块。

  1. 1快速上手
  2. 2开始一个新模块
  3. 3代码生成
  4. 4AdminTable
  5. 5数据权限
  6. 6多租户
  7. 7打印模板
  8. 8AI 助手配置
  9. 9部署上线

EasyAdminBlazor

EasyAdminBlazor 是一个基于 .NET 10 + Blazor 技术栈的企业级后台管理框架,UI 层由 BootstrapBlazor 组件库驱动,数据层由 FreeSql 提供支持。功能全面、开箱即用、扩展灵活,特别适合个人开发者接私活、做外包项目。

🌐 官方网站:https://easyadmin.wang-zhan.com.cn


✨ 核心特性

🧩 模块化架构

核心功能与扩展功能拆得比较开,需要用啥就装啥 NuGet 包,不会一上来就塞一堆用不上的东西:

模块 说明
用户管理 用户增删改查、状态管理、多端登录检测、批量设置角色/部门/重置密码
角色管理 基于角色的权限分配、管理员标识、删除引用保护
菜单管理 无限级菜单树、按钮级权限、可视化配置、菜单收藏、隐藏控制
组织架构 树形部门管理、多类型(集团/公司/部门/供应商)、数据权限隔离、负责人绑定、组织结构图
配置管理 系统参数动态配置,支持数据库存储,第三方服务参数集中管理
字典管理 通用字典表,支持下拉/多选,批量导入导出
日志管理 操作日志(字段级变更明细)、登录日志(IP/城市/浏览器/设备)、错误日志(TraceId)
文件管理 本地文件上传/下载、图片压缩/WebP 转换、分组管理
代码生成器 可视化生成 CRUD 页面(仅本地开发环境)
打印模板设计器 可视化设计打印模板、与 AdminTable 联动、一键打印
消息中心 站内信、系统通知
回收站 软删除恢复、批量还原、彻底删除(二次确认)

🏗️ 分层架构(按需)

默认布局很精简:业务实体放在业务项目里就能直接跑。如果项目规模大(有接口、有前台、有后台多个入口),可以自行拆层——新增一个共享层(XXX.Application / XXX.Core)放实体、DTO、公共服务,多个宿主项目各自引用。框架不限制分层方式,由你根据项目情况决定(详见 开始一个新模块 的分层说明)。

🌐 多租户(SaaS)

  • 独立数据库:每个租户用独立的数据库,数据物理隔离
  • 按域名解析:系统根据请求的 Host 自动识别当前租户,零配置切换
  • 菜单权限隔离:每个租户可以独立分配自己能用的功能菜单
  • 文件存储隔离:上传文件按租户 code 分目录存放
  • 缓存与锁隔离:内存缓存 / Redis 键 / 分布式锁统一带 tenant:{code}: 前缀

🌍 多语言

内置本地化支持,界面语言随时切换,国际化不用愁。

💬 实时聊天

基于 SignalR 搞的站内即时通讯,消息实时推送、未读提醒都安排上了。

📋 计划任务

集成了 FreeScheduler,支持 Cron 表达式和 [Scheduler] 特性标注,还有可视化任务管理界面。

🚀 应用在线升级(扩展 EasyAdminBlazor.Upgrade)

管理员在后台点「检查更新 → 立即升级」,系统自动停服务、备份、替换文件、启动并健康检查;失败自动回滚,用户不需要重新登录。

  • 版本分离:应用版本来自宿主 <Version>,框架版本独立读取,页脚同时显示
  • 逐版本增量:1.0 → 1.1 → 1.2 依次升完,无需手工跳版本
  • 发布即出包:Release 发布一次,增量包(约 1~2 MB)自动落在 updates/v<版本>/
  • 两种来源:本地目录(人工拷包)与 HTTPS 发布索引(客户自助升级)
  • 数据零风险:上传文件、日志、密钥、配置、数据库永不写入/删除
  • 安全校验:包 SHA256 + 文件哈希 + 基线哈希三重校验,拒绝 ZIP 路径穿越
  • 失败只回滚当前一步,并保证应用重新拉起
  • 部署适配:支持 Direct / WindowsService / Systemd / External;IIS 进程内托管时自动禁用

⚖️ 轻量审批(扩展 EasyAdminBlazor.Approval)

状态机 + 审批记录表,支持固定 2~3 级串联审批。支持或签、撤回、驳回、转交、轮次与时间线;条件更新保证并发安全,全流程事务化,通知在事务提交后发送。审批人来源支持部门负责人 / 角色 / 指定用户 / 单据字段。

🎨 主题色切换

内置默认蓝、清新绿、典雅紫、活力橙、中国红 5 种主色,切换即时生效并持久化。

🔌 可插拔扩展

想加啥功能装对应的扩展包就行:

扩展 功能
EasyAdminBlazor.Mail SMTP / SendCloud / 腾讯云 SES 邮件发送,可按调用指定服务商
EasyAdminBlazor.Captcha 表单验证码
EasyAdminBlazor.Redis Redis 缓存/消息持久化
EasyAdminBlazor.FusionCache 混合缓存加速
EasyAdminBlazor.Chat 实时聊天插件
EasyAdminBlazor.MultiTenant 多租户支持
EasyAdminBlazor.Scheduler 后台任务调度
EasyAdminBlazor.HtmlEditor TinyMCE 富文本编辑器
EasyAdminBlazor.WeChat 微信小程序、微信支付集成
EasyAdminBlazor.Approval 轻量多级审批(状态机)
EasyAdminBlazor.Upgrade 应用在线升级(逐版本增量、自动回滚)
EasyAdminBlazor.Cms 内容类型、分类、页面元素、后台管理与前台标签

🛡️ 安全特性

  • 密码 PBKDF2 加密存储(带版本与迭代次数)
  • Cookie 认证 + AES 加密(自定义加密 Cookie)
  • CSRF 防护(Antiforgery Token)
  • 管理后台路由加密(AdminRouteSecret)
  • 操作日志审计,字段级变更明细可追溯
  • 登录失败次数限制 + 验证码防暴力破解
  • 登录票据绑定签发租户与时间,Host 白名单校验防止伪造切租户
  • SSRF 加固:逐跳地址校验、禁止 HTTPS 降级、锁定已校验 IP 防 DNS Rebinding
  • XSS 净化:站内信、审批意见、聊天 Markdown 统一处理
  • 在线升级三重校验:包 SHA256、包内文件哈希、基线哈希

🏗️ 技术栈

层级 技术
框架 .NET 10
UI Blazor Server / BootstrapBlazor
ORM FreeSql(支持 MySQL、Sqlite、PostgreSQL、SQL Server 等)
实时通信 SignalR
认证 Cookie Authentication(自定义加密 Cookie)
缓存 IMemoryCache / Redis / FusionCache
任务调度 FreeScheduler
图片处理 SixLabors.ImageSharp
ID 生成 Yitter 雪花算法
Excel MiniExcel
富文本 TinyMCE