Web快速开发平台,搭建管理后台,灵活可扩展!内部集成了用户权限管理、模板继承、SSO登录、OAuth服务端、数据导出与分享等多个功能模块,在真实项目中经历过单表100亿数据添删改查的考验。
$ dotnet add package NewLife.Cube.Core
魔方是一个快速 Web 开发平台,面向“数据驱动 + 快速迭代 + 可深度定制”场景。几分钟内即可把实体 / 数据库表转为带权限、列表、详情、增删改、导出、统计的完整后台界面,并开放标准 API 给 Vue / Blazor / Antd / 移动端或第三方系统调用。默认模板已在真实项目中经历单表 100 亿数据增删改查考验。
演示站点:https://cube.newlifex.com CentOS7 + CDN
SSO中心:https://sso.newlifex.com OAuth 服务端
Swagger:https://cube3.newlifex.com
魔方教程:https://newlifex.com/cube
XCode教程:https://newlifex.com/xcode
核心库教程:https://newlifex.com/core
+-------------------------------------------------------------+
| 前端 (Vue / Blazor / Antd / 传统 Razor UI) |
+----------------------+------------------+-------------------+
| 皮肤视图(Razor) | API Controllers | Swagger 分组文档 |
+----------------------+------------------+-------------------+
| EntityController / ReadOnlyEntityController 基础能力 |
+------------------+---------------------+--------------------+
| 权限(EntityAuthorize) | 过滤(ApiFilter) | 统一响应(ApiResponse)|
+-------------------------------------------------------------+
| 实体 & 业务逻辑 (XCode ORM + 扩展) |
+-------------------------------------------------------------+
| 数据访问:MySql/SqlServer/SQLite/Oracle/PostgreSQL/达梦等 |
+-------------------------------------------------------------+
| NewLife.Core(日志/配置/缓存/序列化/追踪) + 生态组件 |
+-------------------------------------------------------------+
GetFields?kind=List|Detail|AddForm|EditForm 驱动动态前端生成。/Admin/Index/GetMenuTree 根据权限生成多级菜单。admin 被禁用。通过 NuGet 引入 NewLife.Cube.Core。MIT 协议,可私有化替换字符串“NewLife”。支持 VS 与 CLI。newlife.snk 已公开便于强命名一致性。
命令行体验:
dotnet new install NewLife.Templates
dotnet new cube --name CubeWeb
dotnet new xcode --name Zero.Data
cd CubeWeb
dotnet build
start http://localhost:6080
dotnet run
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddCube(); // 注册权限、菜单、实体控制器扫描
var app = builder.Build();
app.UseMetronic(app.Environment); // or UseAdminLTE / UseTabler ...
app.UseCube(app.Environment); // 路由 & 静态资源 & 中间件
app.Run();访问 / 登录后台;Swagger 查看接口;前端可调用标准 CRUD API。
public class AppController : EntityController<App, AppModel>
{
static AppController()
{
LogOnChange = true; // 修改日志
ListFields.RemoveField("Secret"); // 隐藏敏感列
var log = ListFields.AddListField("Log", "UpdateUserId");
log.DisplayName = "修改日志";
log.Url = "/Admin/Log?category=应用系统&linkId={ID}";
log.Target = "_blank";
}
}前端:/Cube/App/GetFields?kind=1 获取列表字段定义,无需硬编码。
/Admin/User/Login -> JWT Token(Header/Cookie/Query)。/Admin/Index/GetMenuTree。/{Area}/{Controller}/GetFields?kind=1..4。Detail / Insert / Update / Delete。stat;分页信息:page。admin 禁用。CubeEmbeddedFileProvider。AddTheme/AddSkin。MetronicModule 实现 IModule 并在 Use 阶段挂载。.cshtml 覆盖父级。dotnet publish 后拷贝 dll + 配置即可。NewLife.Agent 安装为 Windows Service 或 systemd。StarAgent拉起守护,或通过星尘平台发布。(下方为原始详尽步骤,保持一致)
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*",
"Urls": "http://*:8080;https://*:8081",
//"StarServer": "http://star.newlifex.com:6600",
"ConnectionStrings": {
"Membership": "Data Source=..\\Data\\Membership.db;provider=sqlite",
"Cube": "Data Source=..\\Data\\Cube.db;provider=sqlite",
"Log": "Data Source=..\\Data\\Log.db;provider=sqlite"
//"Membership": "Server=.;Port=3306;Database=Membership;Uid=root;Pwd=root;provider=mysql",
//"Cube": "Server=.;Port=3306;Database=Membership;Uid=root;Pwd=root;provider=mysql",
//"Log": "Server=.;Port=3306;Database=Membership;Uid=root;Pwd=root;provider=mysql"
}
}
第三代聚焦“前后端分离 + 多前端生态 + 最小侵入”。后端接口合并在 master,前端仓库独立(Vue / QuickVue / Antd / Blazor)。
Vue版:https://vue.newlifex.com, https://quickvue.newlifex.com
Antd版:https://antd.newlifex.com
Swagger:https://cube3.newlifex.com/swagger/index.html
NewLife.Cube;MVC 保留在 NewLife.CubeNC。NewLife.CubeAntd)。NewLife.CubeNewLife.CubeNCEntityController / EntityReadonlyController前端仓库:
https://github.com/NewLifeX/NewLife.CubeVue
https://github.com/NewLifeX/NewLife.QuickVue
https://github.com/NewLifeX/NewLife.CubeAntd
https://github.com/NewLifeX/NewLife.CubeBlazor
/Admin/User/Login 测试账号 admin/admin test/test/Admin/Index/GetMenuTree/{Area}/{Controller}/GetFields?kind=1 (1=List 2=Detail 3=AddForm 4=EditForm)page:分页信息stat:统计行Detail | 新增 Insert | 修改 Update | 删除 Delete.github/copilot-instructions.md。Q: 隐藏字段?
A: 控制器静态构造:ListFields.RemoveField("字段")。
Q: 自定义统计?
A: 重写搜索逻辑,填充返回集合的 stat。
Q: 切换主题?
A: 引入主题包并 app.UseXXX(env),后台可配置默认。
Q: 数据库驱动来源?
A: 首次运行自动从 PluginServer 下载,可自定义。
Q: 集成自定义前端?
A: 依靠字段元数据 + 标准 CRUD/JWT 登录。
MySql / SQLite / Sql Server / Oracle / PostgreSql / SqlCe / AccessASP.NET Core Web项目NewLife.Cube.Core,或自己编译最新的魔方 NewLife.CubeNC源码appsettings.json的ConnectionStrings段设置名为Membership的连接字符串,用户角色权限菜单等存储在该数据库Data Source=..\Data\Membership.db查看,在浏览器中查看,运行魔方平台MySql/SQLite/Oracle/SqlCe数据库自动下载匹配(x86/x64)的数据库驱动文件,驱动下载地址可在Config\Core.config中修改PluginServerConfig/Cube.config中修改PluginServeradmin,密码是admin,也可以使用NewLife等第三方OAuth登录,首个进入系统的用户抢得管理员,原admin禁用*.dll、appsettings.json、*.deps.json、*.runtimeconfig.json,以及其它自己添加的资源文件ASP.NET MVC项目NewLife.Cube,或自己编译最新的魔方 NewLife.Cube源码Web.config的<connectionStrings>段设置名为Membership的连接字符串,用户角色权限菜单等存储在该数据库<add name="Membership" connectionString="Data Source=..\Data\Membership.db" providerName="Sqlite"/>查看,在浏览器中查看,运行魔方平台MySql/SQLite/Oracle/SqlCe数据库自动下载匹配(x86/x64)的数据库驱动文件,驱动下载地址可在Config\Core.config中修改PluginServerConfig/Cube.config中修改PluginServeradmin,密码是admin,也可以使用NewLife等第三方OAuth登录,首个进入系统的用户抢得管理员,原admin禁用.cshtml文件设置自定义工具为RazorGenerator,可以把.cshtml编译生成到DLL里面Bin、web.config、Global.asax,以及其它自己添加的资源文件各项目默认支持net9.0/netstandard2.1/netstandard2.0/net4.62/net4.5,旧版(2024.0801)支持net4.0/net2.0
| 项目 | 年份 | 说明 |
|---|---|---|
| 基础组件 | 支撑其它中间件以及产品项目 | |
| NewLife.Core | 2002 | 核心库,日志、配置、缓存、网络、序列化、APM性能追踪 |
| NewLife.XCode | 2005 | 大数据中间件,单表百亿级,MySql/SQLite/SqlServer/Oracle/PostgreSql/达梦,自动分表,读写分离 |
| NewLife.Net | 2005 | 网络库,单机千万级吞吐率(2266万tps),单机百万级连接(400万Tcp长连接) |
| NewLife.Remoting | 2011 | 协议通信库,提供CS应用通信框架,支持Http/RPC通信框架,高吞吐,物联网设备低开销易接入 |
| NewLife.Cube | 2010 | 魔方快速开发平台,集成了用户权限、SSO登录、OAuth服务端等,单表100亿级项目验证 |
| NewLife.Agent | 2008 | 服务管理组件,把应用安装成为操作系统守护进程,Windows服务、Linux的Systemd |
| NewLife.Zero | 2020 | Zero零代脚手架,基于NewLife组件生态的项目模板NewLife.Templates,Web、WebApi、Service |
| 中间件 | 对接知名中间件平台 | |
| NewLife.Redis | 2017 | Redis客户端,微秒级延迟,百万级吞吐,丰富的消息队列,百亿级数据量项目验证 |
| NewLife.RocketMQ | 2018 | RocketMQ纯托管客户端,支持Apache RocketMQ和阿里云消息队列,十亿级项目验 |
| NewLife.MQTT | 2019 | 物联网消息协议,MqttClient/MqttServer,客户端支持阿里云物联网 |
| NewLife.IoT | 2022 | IoT标准库,定义物联网领域的各种通信协议标准规范 |
| NewLife.Modbus | 2022 | ModbusTcp/ModbusRTU/ModbusASCII,基于IoT标准库实现,支持ZeroIoT平台和IoTEdge网关 |
| NewLife.Siemens | 2022 | 西门子PLC协议,基于IoT标准库实现,支持IoT平台和IoTEdge |
| NewLife.Map | 2022 | 地图组件库,封装百度地图、高德地图、腾讯地图、天地图 |
| NewLife.Audio | 2023 | 音频编解码库,PCM/ADPCMA/G711A/G722U/WAV/AAC |
| 产品平台 | 产品平台级,编译部署即用,个性化自定义 | |
| Stardust | 2018 | 星尘,分布式服务平台,节点管理、APM监控中心、配置中心、注册中心、发布中心 |
| AntJob | 2019 | 蚂蚁调度,分布式大数据计算平台(实时/离线),蚂蚁搬家分片思想,万亿级数据量项目验证 |
| NewLife.ERP | 2021 | 企业ERP,产品管理、客户管理、销售管理、供应商管理 |
| CrazyCoder | 2006 | 码神工具,众多开发者工具,网络、串口、加解密、正则表达式、Modbus、MQTT |
| EasyIO | 2023 | 简易文件存储,支持分布式系统中文件集中存储。 |
| XProxy | 2005 | 产品级反向代理,NAT代理、Http代理 |
| HttpMeter | 2022 | Http压力测试工具 |
| GitCandy | 2015 | Git源代码管理系统 |
| SmartOS | 2014 | 嵌入式操作系统,完全独立自主,支持ARM Cortex-M芯片架构 |
| SmartA2 | 2019 | 嵌入式工业计算机,物联网边缘网关,高性能.NET8主机,应用于工业、农业、交通、医疗 |
| FIoT物联网平台 | 2020 | 物联网整体解决方案,建筑、环保、农业,软硬件及大数据分析一体化,单机十万级点位项目验证 |
| UWB高精度室内定位 | 2020 | 厘米级(10~20cm)高精度室内定位,软硬件一体化,与其它系统联动,大型展厅项目验证 |

新生命团队(NewLife)成立于2002年,是新时代物联网行业解决方案提供者,致力于提供软硬件应用方案咨询、系统架构规划与开发服务。
团队主导的80多个开源项目已被广泛应用于各行业,Nuget累计下载量高达400余万次。
团队开发的大数据中间件NewLife.XCode、蚂蚁调度计算平台AntJob、星尘分布式平台Stardust、缓存队列组件NewLife.Redis以及物联网平台FIoT,均成功应用于电力、高校、互联网、电信、交通、物流、工控、医疗、文博等行业,为客户提供了大量先进、可靠、安全、高质量、易扩展的产品和系统集成服务。
我们将不断通过服务的持续改进,成为客户长期信赖的合作伙伴,通过不断的创新和发展,成为国内优秀的IoT服务供应商。
新生命团队始于2002年,部分开源项目具有20年以上漫长历史,源码库保留有2010年以来所有修改记录
网站:https://newlifex.com
开源:https://github.com/newlifex
QQ群:1600800/1600838
微信公众号:
