EasyAdminBlazor 2.6.1

EasyAdminBlazor

EasyAdminBlazor 是一个基于 .NET 10 + Blazor 技术栈的后台管理框架，UI 层由 BootstrapBlazor 驱动，数据访问由 FreeSql 提供。核心功能与扩展功能解耦，扩展按需引用。

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

核心特性

模块化架构

核心功能与扩展功能解耦，通过 NuGet 扩展按需安装，避免功能臃肿：

应用在线升级（扩展 EasyAdminBlazor.Upgrade）

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

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

详细说明见 应用升级。

多租户（SaaS）

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

多语言

内置本地化支持，界面语言可随时切换。

主题色切换

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

实时聊天

基于 SignalR 实现站内即时通讯，支持消息实时推送、未读提醒。

计划任务

集成 FreeScheduler，支持 Cron 表达式和特性标注 [Scheduler]，可视化任务管理。

轻量审批（扩展）

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

可插拔扩展

通过扩展项目按需添加能力：

自己的功能也能封成这样的扩展包，做法见 如何自建扩展。

安全特性

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

技术栈

快速开始

环境要求

• .NET 10 SDK
• 数据库：用模板创建的新项目默认使用 SQLite，零配置即可跑起来；生产环境再切换到 MySQL 8.0+、SQL Server、PostgreSQL 等 FreeSql 支持的数据库
• （可选）Redis（聊天、分布式缓存等扩展功能需要）

全新项目

# 安装模板包
dotnet new install EasyAdminBlazor.Templates

# 使用模板创建项目
dotnet new easyadmin -n MyProjectName

# 进入项目运行
cd MyProjectName
dotnet run

运行后打开后台登录页：http://localhost:端口/admin/{安全码}。安全码是首次启动时随机生成的 8 位字符，会打印在控制台启动日志里（同时保存在 .aspnet/admin-route-secret.txt，重启不变）；端口同样以控制台启动日志里的监听地址为准。默认账号 admin，密码 123yyq。

源码授权客户：直接引用源码

购买源码授权的客户如果希望项目直接引用你拿到的那份框架源码（而不是公共 NuGet 包），把模板生成项目里的包引用换成源码引用即可：

<ItemGroup>
  
  <ProjectReference Include="..\EasyAdminBlazor\EasyAdminBlazor\EasyAdminBlazor.csproj" />
  
  <ProjectReference Include="..\EasyAdminBlazor\Extensions\EasyAdminBlazor.Cms\EasyAdminBlazor.Cms.csproj" />
</ItemGroup>

几个要点：

• 核心库不用单独引：EasyAdminBlazor.Core 由主框架工程传递引用
• 扩展各自独立：需要哪个扩展就引哪个工程（Extensions/ 下每个目录一个工程）
• 不再依赖框架的 NuGet 版本：框架升级只需更新这份源码；只有第三方依赖（BootstrapBlazor、FreeSql 等）仍走 NuGet
• 发布应用不受影响：源码引用只在编译期生效，你的应用照常 dotnet publish 成可部署产物
• 可移植性：把框架源码目录放在项目同级（如 ../EasyAdminBlazor），别用绝对路径或跨盘符的相对路径，否则别人 clone 你的项目就跑不起来

文档与源码

• 文档：https://easyadmin.wang-zhan.com.cn/doc
• 源码：https://gitee.com/gudufy/EasyAdminBlazor

商业授权与源码

框架本体免费使用（NuGet 包，可直接用于商业项目）；源码为付费授权，购买后可自由修改、二次开发，并可闭源交付给你的客户。

• 购买与价格：https://easyadmin.wang-zhan.com.cn/pay
• 授权协议：免费使用许可（NuGet 包）、源码商业授权协议
• 咨询：84383822@qq.com

已购买源码授权的项目，可在 AddEasyAdminBlazor 中设置 ShowSourceLink = false，去掉后台页头的「获取源码」入口。