NeoAdmin.Blazor
1.0.34
dotnet add package NeoAdmin.Blazor --version 1.0.34
NuGet\Install-Package NeoAdmin.Blazor -Version 1.0.34
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NeoAdmin.Blazor" Version="1.0.34" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="NeoAdmin.Blazor" Version="1.0.34" />
<PackageReference Include="NeoAdmin.Blazor" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add NeoAdmin.Blazor --version 1.0.34
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: NeoAdmin.Blazor, 1.0.34"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package NeoAdmin.Blazor@1.0.34
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=NeoAdmin.Blazor&version=1.0.34
#tool nuget:?package=NeoAdmin.Blazor&version=1.0.34
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
NeoAdmin.Blazor
基于 ASP.NET Core Blazor Server 的后台管理框架核心库:NeoUI 组件、FreeSql CRUD、RBAC、字典/参数、定时任务、审批流、REST API 等。
安装
dotnet add package NeoAdmin.Blazor
快速集成
在宿主 Program.cs 中:
builder.AddNeoAdminSerilog();
builder.Services.AddNeoUIPrimitives();
builder.Services.AddNeoUIComponents();
builder.Services.AddNeoAdmin(builder.Configuration);
builder.Services.AddNeoAdminApi(Assembly.GetExecutingAssembly());
// ...
app.UseNeoAdminSerilogRequestLogging();
app.UseNeoAdmin();
app.MapRazorComponents<YourApp>()
.AddAdditionalAssemblies(typeof(NeoAdmin.Blazor.Components.LayoutAdmin).Assembly)
.AddInteractiveServerRenderMode();
项目模板
推荐使用 NeoAdmin.Templates 通过 dotnet new neoadmin 生成完整宿主项目。
部署注意(反向代理 / WebSocket)
NeoAdmin 使用 Blazor Server(InteractiveServer),浏览器与服务器通过 SignalR 长连接通信,底层依赖 WebSocket(路径通常为 /_blazor)。
若前面有 Nginx、Caddy、Traefik、云负载均衡 等反向代理,必须开启 WebSocket 转发,否则会出现页面空白、按钮无响应、频繁「连接已断开」等问题。
Nginx 示例(将 5050 换成实际 upstream 端口):
location / {
proxy_pass http://127.0.0.1:5050;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 3600s;
}
要点:
Upgrade/Connection "upgrade"缺一不可- HTTPS 终止在代理层时,建议设置
X-Forwarded-Proto,以便应用识别真实协议 - 多实例部署时,SignalR 连接须会话保持(sticky session),或另行配置共享 DataProtection / SignalR Backplane
更多部署说明见仓库根目录 README.md 与宿主 NEOADMIN开发上手.md。
核心模块目录(Core/)
按功能划分的平台能力,避免根目录散落多个小文件夹:
| 路径 | 命名空间 | 职责 |
|---|---|---|
Core/Identity/ |
NeoAdmin.Blazor.Core.Identity |
登录、Token、API 统一返回体 |
Core/Authorization/ |
NeoAdmin.Blazor.Core.Authorization |
REST API 路径权限过滤器 |
Core/Navigation/ |
NeoAdmin.Blazor.Core.Navigation |
菜单树、路径解析、菜单 CRUD |
Core/Workflow/ |
NeoAdmin.Blazor.Core.Workflow |
审批流规则与审批按钮定义 |
Core/Scheduling/ |
NeoAdmin.Blazor.Core.Scheduling |
FreeScheduler 注册与任务同步 |
文档与源码
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- FreeScheduler (>= 2.1.4)
- FreeSql (>= 3.5.304)
- FreeSql.Provider.SqliteCore (>= 3.5.304)
- NCrontab (>= 3.4.0)
- NeoUI.Blazor (>= 4.1.7)
- Newtonsoft.Json (>= 13.0.3)
- Rougamo.Fody (>= 5.0.2)
- Serilog.AspNetCore (>= 9.0.0)
- Serilog.Sinks.File (>= 6.0.0)
- SQLitePCLRaw.bundle_e_sqlite3 (>= 3.0.3)
- Swashbuckle.AspNetCore (>= 10.0.0)
- Yitter.IdGenerator (>= 1.0.14)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.34 | 0 | 6/16/2026 |
| 1.0.33 | 0 | 6/16/2026 |
| 1.0.32 | 0 | 6/16/2026 |
| 1.0.31 | 0 | 6/16/2026 |
| 1.0.30 | 38 | 6/15/2026 |
| 1.0.29 | 48 | 6/14/2026 |
| 1.0.28 | 47 | 6/14/2026 |
| 1.0.27 | 62 | 6/13/2026 |
| 1.0.25 | 48 | 6/13/2026 |
| 1.0.24 | 41 | 6/13/2026 |
| 1.0.23 | 53 | 6/13/2026 |
| 1.0.22 | 51 | 6/12/2026 |
| 1.0.21 | 52 | 6/12/2026 |
| 1.0.20 | 68 | 6/10/2026 |
| 1.0.19 | 100 | 6/3/2026 |
| 1.0.18 | 85 | 6/3/2026 |
| 1.0.17 | 91 | 6/3/2026 |
| 1.0.16 | 95 | 6/3/2026 |
| 1.0.15 | 129 | 5/29/2026 |
| 1.0.14 | 111 | 5/29/2026 |
Loading failed