NewLife.Stardust - Stardust Distributed Platform

🌐 简体中文 | 繁體中文 | Español | Deutsch | 日本語 | Français | Português | Русский | 한국어 | العربية

Stardust is a lightweight distributed service platform: node management, configuration center, registry and service discovery, distributed tracing and APM, log center and remote release, with automatic service registration and discovery, load balancing, dynamic scaling and failover. Application services are like dust in the universe, and the computer nodes that host them are the stars; stars and dust together form the vast starry sky, which is Stardust.

Demo system: http://star.newlifex.com

Contents: Quick Start · Main Features · Ecosystem Map · Documentation · Contributing · Team · License

Quick Start

Install

• Source: clone this repository and build directly with Visual Studio / Rider / dotnet build
• NuGet: NewLife.Stardust (core); NewLife.Stardust.Extensions (ASP.NET Core extensions, brings the core package transitively)

dotnet add package NewLife.Stardust.Extensions

Start the platform

1. Start StarServer:

cd Stardust.Server
dotnet run

2. Start StarWeb:

cd ../Stardust.Web
dotnet run

On first run, the database and tables are created automatically (SQLite by default; MySql / SqlServer / PostgreSql / Oracle / DaMeng etc. are configurable; set the connection string in *.config / appsettings.* or environment variables).

Deploy StarAgent to business nodes

cd StarAgent
# Run directly (debug)
dotnet run
# Or publish and install as a system service (example)
dotnet publish -c Release -o publish
# Windows: StarAgent.exe -install
# Linux:   chmod +x StarAgent && ./StarAgent install

After configuring the StarServer address, the node will appear on the platform.

Other platforms

# macOS self-contained packages (osx-x64 / osx-arm64)
cd Tools && build-agent-osx.bat

# Android simplified agent (requires the Android workload)
dotnet build StarAgent.Android/StarAgent.Android.csproj -c Release
# Output: Bin/Agent/mobile/android/com.newlife.staragent-Signed.apk
pwsh StarAgent.Android/pack-android.ps1 -Mode Aot
pwsh StarAgent.Android/run-android.ps1 -Smoke

# iOS minimal agent (requires macOS + Xcode)
bash StarAgent.iOS/run-ios.sh

Mobile platforms are subject to system limitations: Android requires a foreground service and a battery whitelist; iOS can only be online intermittently (reporting in the foreground and when awakened by BGTask) and does not support process supervision or remote release. See NODE-StarAgent Architecture for details.

Create an application (StarWeb)

• Create a new application in “Application Management” to generate an AppId / Secret
• You can configure the category, project, expected port, heartbeat policy, etc.

Integrate a business application

Reference the package:

dotnet add package NewLife.Stardust.Extensions

In Program / Startup:

var builder = WebApplication.CreateBuilder(args);

// One line: connect to Stardust, inject the tracing middleware, and enable
// HttpClient / WebApi / database / Redis auto-instrumentation.
var star = builder.Services.AddStardust("OrderService");

var app = builder.Build();
// app.UseStardust(); // Optional: only when you need a custom middleware order
app.RegisterService("OrderService"); // Register with Stardust
// app.ConsumeService("UserService"); // Optional: consume other services
app.Run();

After it starts, you can see the instance online, performance metrics, and call chains in StarWeb.

Multi-language SDK Support

In addition to the .NET SDK, Stardust also provides multi-language SDK support:

See SDK/README.md for the unified capability matrix, naming, and release plan.

JavaScript SDK quick example:

// Node.js: one-line create and start
const { init } = require('./SDK/JavaScript');
const tracer = init({
  server: 'http://star.example.com:6600',
  appId: 'MyApp',
  secret: 'MySecret',
  version: '1.2.3',
});

// Browser: prefer the one-line loader.js (see SDK/README.md), or call init directly
const webTracer = Stardust.init({
  server: 'http://star.example.com:6600',
  appId: 'MyWebApp',
  tokenProvider: async () => (await fetch('/api/stardust-token')).json(),
  version: '1.2.3',
});
// Automatically collects page loads, routes, JS errors, fetch/XHR

Template scaffolding

Run the following commands in a command line to quickly try the NewLife components:

dotnet new install NewLife.Templates
dotnet new nconsole --name test
cd test
dotnet run

Main Features

+--------------------+        +-------------------+        +---------------------+
|   App Instance     | <----> |  Registry/Config  | <----> |   StarServer Core   |
| (AddStardust ext)  |        | (service/config/  |        | (API & task/stats)  |
+---------+----------+        |    discovery)     |        +----------+----------+
          |                   +---------+---------+                   |
          v                             ^                             v
   StarAgent (node supervision/deploy/monitoring)             StarWeb admin UI
          |                             |                             |
       Remote release / performance & logs / metrics ---+--- Data storage (XCode ORM, multi-database)

var star = services.AddStardust("OrderService");
var cfg = star.GetConfig();
var dbConn = cfg["Db:ConnStr"]; // Delivered automatically from the platform

app.RegisterService("SvcName", address: null, environment, healthUrl);
app.ConsumeService("SvcName");

using var span = star.Tracer?.NewSpan("biz:calc", new { id });

Ecosystem Map

NewLife is a layered ecosystem of independently versioned open-source projects. The map below is shared verbatim by every NewLife repository; each project links to its repository and its primary NuGet package.

Project	What it does	Downloads
Foundation
NewLife.Core	Logging, configuration, caching, networking, serialization, scheduling and APM tracing.
NewLife.XCode	Data middleware: single tables at the tens-of-billions scale, automatic sharding, read-write splitting, 10+ databases.
NewLife.Net	High-performance network library: 1.77M pps / 14.5 Gbps on a single machine (TCP 1KB, 2026-10), 4M long-lived TCP connections.
NewLife.Remoting	Protocol communication and RPC framework for client/server applications and IoT devices.
NewLife.Agent	Installs .NET applications as OS daemons: Windows services and Linux systemd.
NewLife.Templates	dotnet new project templates for console, web, API, service, data and IoT projects.
Data & Messaging
NewLife.Redis	Redis client with microsecond latency, millions of ops/s and built-in message queues.
NewLife.RocketMQ	Pure managed RocketMQ client for Apache RocketMQ and Alibaba Cloud Message Queue.
NewLife.MQTT	MQTT client and server, including Alibaba Cloud IoT connectivity.
NewLife.NovaDb	Hybrid database in C#: embedded or networked, relational, time-series, message queue and KV in one.
NewLife.MySql	MySql driver and helper layer built on the NewLife data stack.
Web, AI & Distributed
NewLife.Cube	Rapid admin-platform framework: permissions, SSO, OAuth server and CRUD scaffolding.
Stardust	Distributed service platform: node management, APM, configuration center, registry and release center.
AntJob	Distributed task and real-time data scheduling platform with sharding, retries and backfill.
NewLife.AI	Unified client for 46 LLM providers plus ChatAI, a ready-to-run web chat application.
Industrial & IoT
NewLife.IoT	IoT standard library defining protocol contracts and device abstractions.
NewLife.Modbus	Modbus TCP/RTU/ASCII implementation on top of NewLife.IoT.
NewLife.Siemens	Siemens PLC protocol on top of NewLife.IoT.
NewLife.Omron	Omron PLC protocol on top of NewLife.IoT.
NewLife.Melsec	Mitsubishi Melsec PLC protocol on top of NewLife.IoT.
NewLife.OPC	OPC client for industrial data access.	—
NewLife.BACnet	BACnet building-automation protocol stack.
ZeroIoT	Lightweight open-source IoT platform with gateway and device management.	—
Vehicle Telematics
NewLife.JT808	JT/T 808 vehicle positioning protocol: 70+ message bodies, 2011/2013/2019.
NewLife.JT809	JT/T 809 platform-to-platform protocol for transport authorities.
NewLife.JT1078	JT/T 1078 in-vehicle video: RTP parsing, FLV/fMP4 remuxing and live streaming.
Domain Components
NewLife.Office	One package for Excel, Word, PPT, PDF and 15+ document formats.
NewLife.Audio	Cross-platform audio: codecs, device I/O, DSP, containers and streaming.
NewLife.Video	Video codecs, container formats, frame processing and streaming.
NewLife.Map	Unified interface over Baidu, AMap, Tencent and Tianditu with geocoding and coordinate conversion.
NewLife.IP	IPv4 geolocation with an offline memory-mapped database and an online API fallback.
Tools & Products
CrazyCoder	Developer toolbox: network, serial port, crypto, regex, Modbus and MQTT.
GitCandy	Self-hosted Git source code management system.	—
LuckyClover	Installs the matching .NET runtime automatically when launched from an older host.	—

Badges show the primary package of each project; theme, extension and satellite packages are listed on their NuGet pages. The 30+ packages not listed here (FTP, LoRa, Office extensions, protocol drivers and more) are available under the NewLifeX organization and on newlifex.com.

Documentation

📋 Core Documents (Trilogy)

🏗️ Main Component Architecture

🔧 Submodule Documents

Contributing

Build and test

dotnet build 星尘.slnx -c Release
dotnet test 星尘.slnx -c Release --no-build

• The solution opens in Visual Studio (latest stable) and also builds from the command line with dotnet build; project files avoid complex features to stay out-of-the-box.
• The strong-name certificate newlife.snk is published so you can build and replace assemblies independently.
• CI: .github/workflows/test.yml builds the solution and runs the full test suite.

Release

Push a v-prefixed tag to trigger .github/workflows/publish.yml. The workflow builds 星尘.slnx, packs Stardust, Stardust.Extensions and DeployAgent, and pushes the packages to NuGet.org and GitHub Packages.

Feedback

• Before submitting, make sure dotnet build and the relevant tests pass; follow the repository conventions for code style and commit messages.
• Report bugs and suggestions via Issue; Stars and PRs are welcome.

Team

Founded in 2002, the NewLife team has spent more than two decades on the .NET and IoT ecosystem, maintains nearly 100 open-source projects (34 of them core to this map), and delivers integrated software and hardware solutions for power, logistics, healthcare, industrial control and internet industries. We live by the motto “learning has no seniority — mastery earns respect”.

Open-source components have been downloaded 6.48M times from NuGet (ecosystem-wide, as of 2026-10).

Website: https://newlifex.com · Open source organization: https://github.com/NewLifeX

License

This project is licensed under MIT. NewLife components have been co-created by the community for more than 20 years and are released under the MIT open-source license: anyone can modify and redistribute them freely (no attribution required). Many enterprises build internal development frameworks on top of them; private customization can even be achieved by batch-replacing all NewLife strings in the source code with the company name.

Welcome to Star / Fork / Issue / PR to build a better .NET distributed infrastructure together.