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" />
                    
Directory.Packages.props
<PackageReference Include="NeoAdmin.Blazor" />
                    
Project file
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
                    
#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
                    
Install as a Cake Addin
#tool nuget:?package=NeoAdmin.Blazor&version=1.0.34
                    
Install as a Cake Tool

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 ServerInteractiveServer),浏览器与服务器通过 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 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.

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