星尘,轻量级分布式服务框架。配置中心、集群管理、远程自动发布、服务治理。服务自动注册和发现、负载均衡、动态伸缩、故障转移、性能监控。
星尘,轻量级分布式服务框架。配置中心、集群管理、远程自动发布、服务治理。服务自动注册和发现、负载均衡、动态伸缩、故障转移、性能监控。
应用服务犹如宇宙中的尘埃,而作为应用服务承载体的计算机节点是为星星,星星与尘埃构成整个浩瀚星空,即为星尘!
Stardust 星尘,轻量级分布式服务框架!
集群管理、配置中心、性能监控、远程发布、服务治理。服务自动注册和发现,负载均衡,动态伸缩,故障转移。
演示系统:http://star.newlifex.com
| 文档 | 说明 |
|---|---|
| 需求文档 | 愿景、核心目标、功能需求、暂缓清单(v3.2) |
| 功能清单 | 全部功能实现/测试/注释状态追踪(v3.2) |
| 架构设计 | 架构文档总索引,链接各组件架构(v3.2) |
| 文档 | 说明 |
|---|---|
| StarServer 架构 | 服务端核心(应用/配置/注册/日志/平台/基础能力) |
| NODE-StarAgent 架构 | 节点代理守护/监控/发布 |
| SDK-分布式核心SDK架构 | 客户端 SDK(配置/追踪/注册发现) |
| APM-监控系统架构 | APM 监控子系统详细架构 |
| PUB-远程发布架构 | 远程发布子系统详细架构 |
| GW-网关架构 | 网关总架构 |
| 文档 | 说明 |
|---|---|
| NODE-9-指令下发 | NODE-9 命令下发流程(WebSocket 双通道) |
| APM-3-链路追踪统计 | APM-3 追踪统计性能瓶颈与优化 |
| NODE-15-StarAgent远程部署 | NODE-15 远程部署方案 |
| NODE-16-阿里云DNS动态域名解析 | NODE-16 动态域名解析 |
| NODE-14-防火墙管理 | NODE-14 防火墙端口管理 |
| PUB-21-分布式文件存储 | 文件存储设计 |
| PUB-23-流水线部署流程 | 流水线编译→上传→部署流程 |
| PUB-19-应用包规范 | 应用包格式与规范 |
| SVR-8-远程命令执行安全 | 安全方案 |
| PUB-20-部署代理 | 部署代理使用说明 |
| GW-8-网关使用指南 | 网关使用说明 |
| NODE-17-进程管理 | 进程启动与守护 |
| MCP-MCP架构 | MCP HTTP 服务架构 |
| MCP-1-token管理 | MCP Token 凭证管理 |
| MCP-2-action扩展 | MCP Action 扩展指南 |
| MCP-3-客户端接入 | MCP 客户端接入指南 |
…核心组件:
星尘监控介绍 https://newlifex.com/blood/stardust_monitor
应用监控
物联网平台远程控制花园水泵的调用链 传送门
关系图
调用链页面支持 TraceAnonymous 属性,设置后允许未登录用户访问,适用于公开展示或演示场景。
| 组件 | 功能 | 典型部署 | 说明 |
|---|---|---|---|
| StarServer | 注册 / 配置 / 发布 / 统计 API | 1~N | 可横向扩展,持久化依赖数据库/Redis(可选) |
| StarWeb | 管理与可视化界面 | 1 | 可与 StarServer 同机或分离 |
| StarAgent | 节点守护/监控/远程部署 | N(每机一实例) | 支持 Windows 服务、Linux systemd、容器或后台进程 |
| Stardust.Core(SDK) | 客户端接入 | 与业务应用同进程 | 通过 AddStardust/UseStardust 集成 |
| Stardust.Extensions | ASP.NET Core 扩展 | 业务 Web/API | 暴露中间件与注册/发现便捷方法 |
| StarGateway(可选) | 网关/反向代理 | 视需求 | 可与服务发现协同 |
dotnet build 直接编译NewLife.Stardust (核心);NewLife.Stardust.Extensions (ASP.NET Core 扩展)cd Stardust.Server
dotnet runcd ../Stardust.Web
dotnet run首次运行自动建库建表(默认 SQLite / 可配置 MySql / SqlServer / PostgreSql / Oracle / 达梦 等;在 *.config / appsettings.* 或环境变量中设置连接字符串)。
cd StarAgent
# 直接运行(调试)
dotnet run
# 或发布后安装为系统服务(示例)
dotnet publish -c Release -o publish
# Windows: StarAgent.exe -install
# Linux: chmod +x StarAgent && ./StarAgent install配置 StarServer 地址后,节点会在平台显示。
引用包:
dotnet add package NewLife.Stardust.Extensions在 Program / Startup:
var builder = WebApplication.CreateBuilder(args);
var star = builder.Services.AddStardust("OrderService");
var app = builder.Build();
app.UseStardust();
app.RegisterService("OrderService"); // 注册到星尘
// app.ConsumeService("UserService"); // 可选:消费其它服务
app.Run();运行后即可在 StarWeb 看到实例在线、性能指标与调用链。
除了 .NET SDK,星尘还提供多语言SDK支持:
| SDK | 说明 | 文档 |
|---|---|---|
| JavaScript/Node.js | 支持Node.js和浏览器环境,提供APM监控能力 | SDK/JavaScript/README.md |
| Python | Python 3.7+ APM监控SDK | Doc/SDK/stardust-sdk-python.md |
| Java | Java APM监控SDK | Doc/SDK/stardust-sdk-java.md |
| Go | Go语言APM监控SDK | Doc/SDK/stardust-sdk-go.md |
| PHP | PHP APM监控SDK | Doc/SDK/stardust-sdk-php.md |
JavaScript SDK 快速示例:
// Node.js 环境
const { StardustTracer } = require('stardust-tracer');
const tracer = new StardustTracer('http://star.example.com:6600', 'MyApp', 'MySecret');
await tracer.start();
// 浏览器环境
const tracer = new StardustBrowserTracer('http://star.example.com:6600', 'MyWebApp', 'MySecret');
await tracer.start();
installBrowserInterceptors(tracer); // 自动拦截fetch和XMLHttpRequest除了 .NET SDK 外,星尘还提供了多种语言的 SDK,方便不同技术栈的应用接入:
适用于 PHP 7.4+,支持 APM 监控和配置中心。
// APM 监控
require_once 'SDK/PHP/src/StardustTracer.php';
$tracer = new StardustTracer('http://star.example.com:6600', 'MyPHPApp', 'secret');
$tracer->login();
$span = $tracer->newSpan('业务操作');
// ... 业务逻辑
$span->finish();
$tracer->flush();
// 配置中心
require_once 'SDK/PHP/src/StardustConfig.php';
$config = new StardustConfig('http://star.example.com:6600', 'MyPHPApp', 'secret', 'dev');
$config->login();
$dbHost = $config->get('database.host', 'localhost');详细文档:SDK/PHP/README.md | Doc/SDK/stardust-sdk-php.md
var star = services.AddStardust("OrderService");
var cfg = star.GetConfig();
var dbConn = cfg["Db:ConnStr"]; // 自动从平台下发在平台“配置中心”中为指定应用添加 Key=Value(支持分环境 / 分项目 / 模板继承),客户端自动长轮询/推送更新。修改后应用实例收到变更事件,可用于热更新业务参数。
app.RegisterService("SvcName", address: null, environment, healthUrl)app.ConsumeService("SvcName");ServiceProviderResolver 自定义策略SDK 内置 ITracer,进入点会自动创建 span;你也可以:
using var span = star.Tracer?.NewSpan("biz:calc", new { id });采集:
| 诉求 | 星尘 | 单一注册中心 (如 Consul/Eureka) | 仅配置中心 | 传统脚本发布 |
|---|---|---|---|---|
| 功能覆盖 | 注册/发现/配置/发布/监控/追踪 | 注册 + 健康 | 配置 | 仅分发 |
| 接入复杂度 | 低 | 中 | 中 | 高 |
| 运维统一度 | 高 | 中 | 中 | 低 |
| 语言生态 | 以 .NET 为主 | 多语言 | 多语言 | 任意 |
| 远程发布 | 内置 | 否 | 否 | 需自建 |
Q: 是否必须同时部署 StarServer 与 StarWeb?
A: 可同机;StarWeb 负责管理界面,StarServer 提供核心 API。小规模可同机部署,也可分离扩展。
Q: Agent 必须安装系统服务吗?
A: 推荐服务方式以保证宕机自恢复;也可容器模式或前台调试运行。
Q: 支持容器 / K8s 吗?
A: 支持。Agent 可作为 DaemonSet,业务 Pod 通过 SDK 接入;后续可结合 StarGateway 做入口治理。
Q: 配置热更新需要重启应用吗?
A: 不需要。SDK 自动监听,提供变更回调。
Q: 如何定制发布流程?
A: 可扩展构建脚本或在 Repository 中附加自定义打包脚本,再由平台执行。
[Obsolete]可与以下 NewLife 项目协同:
使用NewLife组件的最简便方式是从Nuget引用,例如在项目Nuget管理中搜索NewLife.Stardust 并引入。
NewLife组件由社区共创20多年,使用MIT开源协议,任何人可任意修改并再次发行(无需声明来源)!许多企业基于此构建内部开发框架时,甚至可通过批量替换源码中所有NewLife字符串为贵公司名实现私有化定制。
团队始终秉承开放态度,不仅支持VisualStudio(最新正式版)打开解决方案编译,也兼容dotnet build命令行编译,项目文件摒弃复杂功能以追求简单易用,真正做到开箱即用。
我们公开强命名证书newlife.snk以支持独自编译替换程序集。
命令行中运行以下命令快速体验NewLife组件:
dotnet new install NewLife.Templates
dotnet new nconsole --name test
cd test
dotnet run各项目默认支持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 |
| 中间件 | 对接知名中间件平台 | |
| [Ne |
暂无开放 Issues,或尚未同步最近议题。