Recommended path for new users
After you get the source code, follow this path to build your first module.
EasyAdminBlazor
EasyAdminBlazor is a back-end management framework based on the .NET 10 + Blazor stack, with BootstrapBlazor driving the UI and FreeSql for data access. Core features and extensions are decoupled — reference an extension only when you need it.
Official Website: https://easyadmin.wang-zhan.com.cn
Core Features
Modular Architecture
Core features are decoupled from extensions. Reference the NuGet package of the extension you need:
| Module | Description |
|---|---|
| User Management | User CRUD, status management, multi-device login detection, bulk role/department assignment and password reset |
| Role Management | Role-based permission assignment, administrator flag, delete protection for referenced roles |
| Menu Management | Infinite-level menu tree, button-level permissions, visual configuration, menu favorites, visibility control |
| Organization | Tree departments, multiple types (group/company/department/supplier), data permission isolation, owner binding, organization chart |
| Configuration Management | Dynamic system settings with database storage and centralized third-party service parameters |
| Dictionary Management | General dictionaries with dropdown/multi-select and bulk import/export |
| Log Management | Operation logs (field-level change details), login logs (IP/city/browser/device), error logs (TraceId) |
| File Management | Local upload/download, image compression/WebP conversion, grouping, controlled download for private files |
| Code Generator | Visually generate CRUD pages (local development environment only) |
| Print Template Designer | Visually design print templates, integrate with AdminTable, one-click print |
| Message Center | In-app messages and system notifications |
| Recycle Bin | Restore soft-deleted records, bulk restore, permanent delete (with confirmation) |
Layered Architecture (Optional)
The default layout has no layers: business entities can live directly in your business project. For larger projects with multiple entry points (API, web front-end, admin back-end) you can split into layers — add a shared layer (XXX.Application / XXX.Core) for entities, DTOs and common services, and let each host project reference it. The framework does not impose any layering (see Starting a New Module for details).
Multi-Tenant (SaaS)
- Independent Database: Each tenant uses its own database
- Domain-Based Resolution: Automatically identifies the current tenant by request Host, zero-configuration switching
- Menu Permission Isolation: Each tenant can independently assign functional menus
- File Storage Isolation: Uploaded files are stored in directories separated by tenant code
- Cache & Lock Isolation: In-memory cache, Redis keys and distributed locks are namespaced with a
tenant:{code}:prefix
Localization
Built-in localization, the UI language can be switched at any time.
Real-Time Chat
In-site instant messaging based on SignalR, supporting real-time message push and unread reminders.
Scheduled Tasks
Integrated with FreeScheduler, supporting Cron expressions and [Scheduler] attribute annotation, with visual task management.
Online Application Upgrade (Extension EasyAdminBlazor.Upgrade)
Admins click Check for updates → Upgrade now in the admin UI: the system stops the service, backs up, replaces files, starts up and runs health checks. A failed step rolls back automatically, and users stay signed in.
- Separated versions: the app version comes from the host
<Version>, the framework version is read independently, and both are shown in the footer - Per-version incremental upgrades: 1.0 → 1.1 → 1.2 in order, no manual version skipping
- Publish once, package automatically: a Release build drops an incremental package (~1–2 MB) into
updates/v<version>/ - Two sources: local directory (manual copy) and HTTPS release index (customer self-service)
- Zero data risk: uploads, logs, keys, configuration and the database are never written to or deleted
- Security checks: triple verification (package SHA256 + file hashes + baseline hash) and ZIP path-traversal rejection
- Failure only rolls back the current step, then guarantees the app is started again
- Deployment aware:
Direct/WindowsService/Systemd/External; automatically disabled for IIS in-process hosting
Lightweight Approval (Extension EasyAdminBlazor.Approval)
State machine + approval record table, supporting fixed 2–3 level sequential approval with countersign, withdrawal, rejection, transfer, rounds and timeline. Conditional updates keep it concurrency-safe, the whole flow is transactional, and notifications are sent after the transaction commits. Approvers can come from department owners, roles, specific users or bill fields.
CMS Front-Office Content (Extension EasyAdminBlazor.Cms)
Corporate-site catalog content (services, products, news, cases) needs no entity: the developer writes a Razor page annotated with [CmsPage] and the extension generates the admin menus, data tables, custom fields, categories, SEO, page copy blocks (<vc:textblock>, WYSIWYG editing in the admin) and comment moderation automatically. Details are served by slug with automatic redirects from legacy /xx/{id} links. See Fast front-office content pages with the Cms extension.
Theme Colors
Five built-in primary colors — Classic Blue, Fresh Green, Elegant Purple, Vibrant Orange and China Red. Switching takes effect immediately and is persisted.
Pluggable Extensions
On-demand capabilities via extension projects:
| Extension | Feature |
|---|---|
EasyAdminBlazor.Mail |
SMTP / SendCloud / Tencent Cloud SES email, provider selectable per call |
EasyAdminBlazor.Captcha |
Form CAPTCHA |
EasyAdminBlazor.Redis |
Redis caching/message persistence |
EasyAdminBlazor.FusionCache |
Hybrid cache acceleration |
EasyAdminBlazor.Chat |
Real-time chat plugin |
EasyAdminBlazor.MultiTenant |
Multi-tenant support |
EasyAdminBlazor.Scheduler |
Background task scheduling |
EasyAdminBlazor.HtmlEditor |
TinyMCE rich text editor |
EasyAdminBlazor.WeChat |
WeChat Mini Program & WeChat Pay integration |
EasyAdminBlazor.Cms |
Front-office content management (page copy, catalog content, categories, comments, SEO) |
EasyAdminBlazor.Approval |
Lightweight multi-level approval (state machine) |
EasyAdminBlazor.Upgrade |
Online application upgrade (incremental packages, automatic rollback) |
Security Features
- Password PBKDF2 encryption with version and iteration count
- Cookie authentication + AES encryption (custom encrypted cookie)
- CSRF protection (Antiforgery Token)
- Admin route encryption (AdminRouteSecret)
- Operation log auditing with field-level change details
- Login failure limit + CAPTCHA
- Login ticket bound to the issuing tenant and time; Host allowlist prevents forged tenant switching
- SSRF hardening: hop-by-hop address validation, no HTTPS downgrade, pinned validated IP against DNS rebinding
- XSS sanitization for in-app messages, approval comments and chat Markdown
- Controlled download endpoint for private files, validating login, tenant, file record and permission
- Triple-verified online upgrades: package SHA256, file hashes and baseline hash
Technology Stack
| Layer | Technology |
|---|---|
| Framework | .NET 10 |
| UI | Blazor Server / BootstrapBlazor |
| ORM | FreeSql (supports MySQL, Sqlite, PostgreSQL, SQL Server, etc.) |
| Real-time Communication | SignalR |
| Authentication | Cookie Authentication (custom encrypted cookie) |
| Cache | IMemoryCache / Redis / FusionCache |
| Task Scheduling | FreeScheduler |
| Image Processing | SkiaSharp |
| ID Generation | Yitter Snowflake Algorithm |
| Excel | MiniExcel |
| Rich Text | TinyMCE |