Recommended path for new users

After you get the source code, follow this path to build your first module.

  1. 1Quick Start
  2. 2Start a New Module
  3. 3Code Generation
  4. 4AdminTable
  5. 5Data Permissions
  6. 6Multi-Tenant
  7. 7Print Template
  8. 8AI Assistant Guide
  9. 9Deployment

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