节点在线、应用在线、配置在线使用令牌查询
|
# 需求文档
> 版本:v3.1 | 日期:2026-07-29
本文档æè¿°**星尘(Stardustï¼‰åˆ†å¸ƒå¼æœåС平å°**çš„æ„¿æ™¯ã€æ ¸å¿ƒç›®æ ‡å’ŒåŠŸèƒ½éœ€æ±‚ã€‚å®Œæˆçжæ€åœ¨[功能清å•](/NewLife/Stardust/Blob/master/Doc/功能清å•.md)ä¸è¿½è¸ªï¼Œè¯¦ç»†è®¾è®¡åœ¨å„æ¨¡å—æž¶æž„文档ä¸å±•开。
---
## 1. 背景与愿景
### 1.1 系统定ä½
星尘是一个**è½»é‡çº§åˆ†å¸ƒå¼æœåŠ¡æ¡†æž¶**,æä¾›é›†ç¾¤ç®¡ç†ã€é…ç½®ä¸å¿ƒã€æ€§èƒ½ç›‘控(APM)ã€è¿œç¨‹å‘å¸ƒã€æœåŠ¡æ²»ç†ç‰ä¸€ç«™å¼èƒ½åŠ›ã€‚åº”ç”¨æœåŠ¡çŠ¹å¦‚å®‡å®™ä¸çš„å°˜åŸƒï¼Œè®¡ç®—æœºèŠ‚ç‚¹æ˜¯ä¸ºæ˜Ÿæ˜Ÿï¼Œæ˜Ÿæ˜Ÿä¸Žå°˜åŸƒæž„æˆæµ©ç€šæ˜Ÿç©ºï¼Œå³ä¸ºæ˜Ÿå°˜ã€‚
| 工程 | å®šä½ | éƒ¨ç½²æ–¹å¼ | 说明 |
|------|------|----------|------|
| **StarServer** (Stardust.Server) | æœåС平å°åŽç«¯ã€‚API / é…ç½® / 注册 / å‘布 / æŒ‡æ ‡èšåˆ / 统计计算 | ä¸å¿ƒéƒ¨ç½² 1~N 节点 | 坿¨ªå‘扩展 |
| **StarWeb** (Stardust.Web) | 管ç†ä¸Žå¯è§†åŒ–。基于 NewLife.Cube çš„åŽå°ç®¡ç†ç³»ç»Ÿ | ä¸å¿ƒéƒ¨ç½² 1 节点 | å¯ä¸Ž StarServer åŒæœº |
| **StarAgent** | 节点代ç†ã€‚进程守护ã€è¿œç¨‹å‘布ã€ç›‘控采集ã€Web 管ç†é¢æ¿ï¼ˆåæœåŠ¡ç®¡ç†/é…ç½®/本机信æ¯ï¼‰ | æ¯å°æœåŠ¡å™¨ä¸€å®žä¾‹ | Windows æœåŠ¡ / Linux systemd |
| **StarGateway** | æµé‡ç½‘关。åå‘代ç†ã€åЍæ€è·¯ç”±ã€è´Ÿè½½å‡è¡¡ | 按需部署 | å¯é€‰ç»„ä»¶ |
| **Stardustï¼ˆæ ¸å¿ƒåº“ï¼‰** | 客户端 SDK。é…置拉å–ã€æ³¨å†Œå‘现ã€è°ƒç”¨è¿½è¸ªã€æ€§èƒ½å’Œæ—¥å¿—上报 | NuGet 包引用 | 与业务应用åŒè¿›ç¨‹ |
| **Stardust.Extensions** | ASP.NET Core ä¸é—´ä»¶æ‰©å±• | NuGet 包引用 | ä¾¿æ·æŽ¥å…¥ |
| **Stardust.Data** | æ•°æ®å±‚。XCode ORM 实体模型与统计任务 | 与 StarServer åŒè¿›ç¨‹ | 多数æ®åº“兼容 |
| **DeployAgent** | 部署代ç†ã€‚æž„å»ºä¸Žåˆ†å‘æ”¯æ’‘ | 按需部署 | å¯é€‰ç»„件(编译节点) |
### 1.2 愿景
æ˜Ÿå°˜åšæˆäº†ä¼šæ˜¯ä»€ä¹ˆæ ·å:
1. **一键接入分布å¼**ï¼šå‡ è¡Œä»£ç 完æˆåˆ†å¸ƒå¼æŽ¥å…¥ï¼Œåº”ç”¨é›¶æ”¹é€ å³å¯èŽ·å¾—é…ç½®ä¸å¿ƒã€æ³¨å†Œä¸å¿ƒã€APM 能力
2. **è¶…è½»é‡æ— 侵入**ï¼šæ ¸å¿ƒåº“é›¶ç¬¬ä¸‰æ–¹é‡é‡çº§ä¾èµ–,å•进程å³å¯è¿è¡Œï¼Œè‡ªåŠ¨å»ºåº“å»ºè¡¨ï¼Œæ— éœ€é¢å¤–基础设施
3. **全平å°è¦†ç›–**:åŒä¸€ç”Ÿæ€è¦†ç›– .NET Framework 4.5 起至最新 .NET 10,Windows/Linux/ARM/IoT 全平å°
4. **自带è¿ç»´ä½“ç³»**:StarAgent 守护进程 + 远程å‘布 + æŒ‡æ ‡&日志采集,æžå¤§é™ä½Žåˆ†å¸ƒå¼è¿ç»´å¤æ‚度
5. **一体化管ç†**:节点管ç†ã€é…ç½®ä¸å¿ƒã€æ³¨å†Œä¸å¿ƒã€APMã€æ—¥å¿—ä¸å¿ƒã€è¿œç¨‹å‘布统一模型与界é¢
---
## 2. æ ¸å¿ƒç›®æ ‡
### 2.1 æ¨¡å—æ€»è§ˆ
| ç¼–å· | ç›®æ ‡ | 一å¥è¯æè¿° | 所属工程 | 架构文档 |
|------|------|------------|----------|----------|
| SDK | åˆ†å¸ƒå¼æ ¸å¿ƒ SDK | 客户端接入库,é…ç½®/注册/追踪/日志 | Stardust + Extensions | [SDK-åˆ†å¸ƒå¼æ ¸å¿ƒSDKæž¶æž„](/NewLife/Stardust/Blob/master/Doc/SDK-åˆ†å¸ƒå¼æ ¸å¿ƒSDKæž¶æž„.md) |
| SVR | æœåŠ¡ç«¯åŸºç¡€èƒ½åŠ› | å¥åº·æ£€æµ‹ã€æ•°æ®æ¸…ç†ã€.NET è¿è¡Œæ—¶åŒæ¥ | StarServer | [SVR-StarServeræž¶æž„](/NewLife/Stardust/Blob/master/Doc/SVR-StarServeræž¶æž„.md) |
| PLT | å¹³å°ç®¡ç† | 项目管ç†ã€OAuth 授æƒã€ç³»ç»Ÿè®¾ç½® | StarServer + StarWeb | [SVR-StarServeræž¶æž„](/NewLife/Stardust/Blob/master/Doc/SVR-StarServeræž¶æž„.md) |
| APP | åº”ç”¨ç®¡ç† | ç®¡ç†æŽ¥å…¥åº”ç”¨çš„å¯†é’¥ä¸Žç”Ÿå‘½å‘¨æœŸ | StarServer + StarWeb | [SVR-StarServeræž¶æž„](/NewLife/Stardust/Blob/master/Doc/SVR-StarServeræž¶æž„.md) |
| NODE | èŠ‚ç‚¹ç®¡ç† | ä¸å¿ƒåŒ–管ç†å¤šæœºå™¨ä¸Šçš„ StarAgent | StarServer + StarAgent + StarWeb | [NODE-StarAgentæž¶æž„](/NewLife/Stardust/Blob/master/Doc/NODE-StarAgentæž¶æž„.md) |
| CFG | é…ç½®ä¸å¿ƒ | 应用从ä¸å¿ƒè¯»å–é…置,支æŒå¤šçŽ¯å¢ƒçƒæ›´æ–° | StarServer + SDK + StarWeb | [SVR-StarServeræž¶æž„](/NewLife/Stardust/Blob/master/Doc/SVR-StarServeræž¶æž„.md) |
| REG | 注册ä¸å¿ƒä¸ŽæœåŠ¡å‘现 | å¾®æœåŠ¡æ³¨å†Œä¸Žå‘现,分布å¼è°ƒç”¨ | StarServer + SDK + StarWeb | [SVR-StarServeræž¶æž„](/NewLife/Stardust/Blob/master/Doc/SVR-StarServeræž¶æž„.md) |
| APM | 监控ä¸å¿ƒ / APM | å®¢æˆ·ç«¯é‡‡æ ·ç»Ÿè®¡ + æœåŠ¡ç«¯å¤šçº§æ±‡æ€»ï¼Œè°ƒç”¨é“¾è¿½è¸ªä¸Žå‘Šè¦ | StarServer + SDK + StarWeb | [APM-监控系统架构](/NewLife/Stardust/Blob/master/Doc/APM-监控系统架构.md) |
| LOG | 日志ä¸å¿ƒ | ç»Ÿä¸€ä¸ŠæŠ¥ä¸Žé›†ä¸æ£€ç´¢æ—¥å¿— | StarServer + SDK + StarWeb | [SVR-StarServeræž¶æž„](/NewLife/Stardust/Blob/master/Doc/SVR-StarServeræž¶æž„.md) |
| PUB | 远程å‘布 | å‘布应用到多节点,进程守护 | StarServer + StarAgent + StarWeb | [PUB-远程å‘布架构](/NewLife/Stardust/Blob/master/Doc/PUB-远程å‘布架构.md) |
| GW | ç½‘å…³ç®¡ç† | 集ä¸ç®¡ç† StarGateway é…ç½® | StarServer + StarGateway + StarWeb | [GW-网关架构](/NewLife/Stardust/Blob/master/Doc/GW-网关架构.md) |
| DBM | æ•°æ®ä¸é—´ä»¶ç®¡ç† | Redis/MySQL 节点与数æ®ç®¡ç† | StarServer + StarWeb | [SVR-StarServeræž¶æž„](/NewLife/Stardust/Blob/master/Doc/SVR-StarServeræž¶æž„.md) |
| MCP | MCP 工具æœåŠ¡èƒ½åŠ› | é¢å‘ LLM/智能体的 MCP HTTP æœåŠ¡ï¼Œæä¾›æ ‡å‡†åè®®å…¥å£ | StarServer + StarWeb | [MCP-MCPæž¶æž„](/NewLife/Stardust/Blob/master/Doc/MCP-MCPæž¶æž„.md) |
### 2.2 功能全景图
```
┌─────────────────────────────────────────────────────────────────────────────â”
│ StarWeb(管ç†ç•Œé¢ï¼‰ │
│ NODEèŠ‚ç‚¹ç®¡ç† | APPåº”ç”¨ç®¡ç† | CFGé…ç½®ä¸å¿ƒ | REG注册ä¸å¿ƒ │
│ APM监控ä¸å¿ƒ | LOG日志ä¸å¿ƒ | PUBå‘布ä¸å¿ƒ | GWç½‘å…³ç®¡ç† â”‚
│ PLTå¹³å°ç®¡ç† | DBMæ•°æ®ä¸é—´ä»¶ | MCP工具æœåŠ¡ | SVR基础能力 │
└─────────────────────────────────────────────────────────────────────────────┘
│ HTTP/WebSocket
┌────────┴────────────────────────────────────────────────────────────────────â”
│ StarServer(API æœåŠ¡ç«¯ï¼‰ │
│ NODE节点API | APP应用API | CFGé…ç½®API | REG注册API │
│ APM追踪API | LOG日志API | PUBå‘布API | GW网关API │
│ PLTOAuth | DBMä»£ç† | MCPæœåŠ¡ç«¯ | SDKæœåŠ¡ç«¯å助 | SVR基础æœåŠ¡ │
└────────┬────────────────────────────────────────────────────────────────────┘
│
├─────────────────── å®¢æˆ·ç«¯é€šä¿¡é€šé“ â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”€â”
│ │
┌────────┴────────┠┌────────┴────────┠┌──────────────────â”│
│ StarAgent │ │ 业务应用 │ │ StarGateway ││
│ NODE节点守护 │ │ SDK SDK 接入 │ │ GW æµé‡ç½‘å…³ │
│ PUB部署执行 │ │ CFG/REG/APM/LOG │ │ 动æ€è·¯ç”± │
│ APM监控采集 │ │ │ │ è´Ÿè½½å‡è¡¡ │
│ NODE-18 Web颿¿ │ │ │ │ │
└─────────────────┘ └─────────────────┘ └──────────────────┘│
```
---
## 3. 功能需求
### 3.1 SDK åˆ†å¸ƒå¼æ ¸å¿ƒ SDK
> 架构文档:[SDK-åˆ†å¸ƒå¼æ ¸å¿ƒSDKæž¶æž„](/NewLife/Stardust/Blob/master/Doc/SDK-åˆ†å¸ƒå¼æ ¸å¿ƒSDKæž¶æž„.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| SDK-1 | StarClient 客户端 | æ ¸å¿ƒå®¢æˆ·ç«¯ï¼Œç®¡ç†è¿žæŽ¥ã€å¿ƒè·³ã€ä»¤ç‰Œåˆ·æ–° |
| SDK-2 | AppClient 应用客户端 | é¢å‘业务应用的高级客户端 |
| SDK-3 | é…ç½®æ‹‰å– | 从é…ç½®ä¸å¿ƒæ‹‰å–é…ç½® |
| SDK-4 | æœåŠ¡æ³¨å†Œä¸Žå‘现 | 注册æœåŠ¡å’Œå‘现æœåŠ¡æä¾›è€… |
| SDK-5 | 调用追踪(StarTracer) | è‡ªåŠ¨é‡‡é›†è°ƒç”¨é“¾æ•°æ® |
| SDK-6 | 性能监控 | 采集 CPU/内å˜/GC/çº¿ç¨‹æ± ç‰æŒ‡æ ‡ |
| SDK-7 | 日志上报 | 将应用日志上报到日志ä¸å¿ƒ |
| SDK-8 | ASP.NET Core ä¸é—´ä»¶ | AddStardust/UseStardust ç‰ä¾¿æ·æ–¹æ³• |
| SDK-9 | 阿里云 DNS DDNS | 动æ€åŸŸåè§£æž |
| SDK-10 | 事件总线 | 分布å¼äº‹ä»¶å‘布订阅 |
### 3.2 SVR æœåŠ¡ç«¯åŸºç¡€èƒ½åŠ›
> 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| SVR-1 | å¥åº·æ£€æµ‹æŽ¥å£ | æä¾›æœåŠ¡å¥åº·çŠ¶æ€æ£€æµ‹ç«¯ç‚¹ |
| SVR-2 | 接å£åˆ—表 | 自动枚举所有注册的 API æŽ¥å£ |
| SVR-3 | æ•°æ®ä¿ç•™ä¸Žæ¸…ç† | 自动清ç†è¿‡æœŸæ•°æ® |
| SVR-4 | .NET è¿è¡Œæ—¶åŒæ¥ | è‡ªåŠ¨åŒæ¥å®˜æ–¹ .NET å‘å¸ƒä¿¡æ¯ |
| SVR-5 | 分表æœåŠ¡ | æ”¯æŒæŒ‰æ—¶é—´åˆ†è¡¨å˜å‚¨ |
| SVR-6 | 上行链路æœåŠ¡ | 处ç†å®¢æˆ·ç«¯åˆ°æœåŠ¡ç«¯çš„ä¸Šè¡Œæ•°æ®é€šé“ |
| SVR-7 | Apollo é…ç½®é›†æˆ | 支æŒä»Ž Apollo é…ç½®ä¸å¿ƒåŒæ¥ |
| SVR-8 | 远程命令执行安全 | StarAgent 远程命令执行的安全ç–ç•¥ã€æ—¥å¿—审计方案 |
### 3.3 PLT å¹³å°ç®¡ç†
> 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| PLT-1 | æ˜Ÿç³»é¡¹ç›®ç®¡ç† | 多项目分组管ç†ï¼Œéš”ç¦»ä¸šåŠ¡çº¿èµ„æº |
| PLT-2 | 项目用户关系 | 管ç†é¡¹ç›®æˆå‘˜å’Œæƒé™ |
| PLT-3 | StarServer 设置 | StarWeb ä¸Šç®¡ç†æœåŠ¡ç«¯è¿è¡Œå‚æ•° |
| PLT-4 | OAuth æŽˆæƒæœåŠ¡ | 为应用æä¾› OAuth2.0 令牌é¢å‘和刷新 |
### 3.4 APP 应用管ç†
> 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| APP-1 | 应用注册与登录 | 应用使用 AppId/Secret å‘ StarServer æ³¨å†Œå¹¶èŽ·å– JWT 令牌 |
| APP-2 | åº”ç”¨å¿ƒè·³ä¿æ´» | 应用定期å‘é€å¿ƒè·³ï¼ŒæœåŠ¡ç«¯æ›´æ–°åœ¨çº¿çŠ¶æ€å’Œæ—¶é—´ |
| APP-3 | åº”ç”¨åœ¨çº¿çŠ¶æ€ | 实时追踪应用实例在线/ç¦»çº¿çŠ¶æ€ |
| APP-4 | 应用历å²è®°å½• | 记录应用的关键æ“作事件 |
| APP-5 | åº”ç”¨å‘½ä»¤ä¸‹å‘ | å‘应用实例下å‘远程命令 |
| APP-6 | 应用消费关系 | 记录æœåŠ¡æ¶ˆè´¹è€…ä¸ŽæœåŠ¡æä¾›è€…的调用关系 |
| APP-7 | 应用客户端日志 | 查看应用客户端的è¿è¡Œæ—¥å¿— |
| APP-8 | åº”ç”¨ä»¤ç‰Œç®¡ç† | 管ç†åº”用接入令牌的é¢å‘ã€åˆ·æ–°ã€åŠé”€ |
| APP-9 | 应用会è¯ç®¡ç† | 管ç†åº”用 WebSocket/HTTP é•¿è¿žæŽ¥ä¼šè¯ |
| APP-10 | 应用性能查看 | æŸ¥çœ‹åº”ç”¨å®žä¾‹çš„æ€§èƒ½æŒ‡æ ‡é¢æ¿ |
### 3.5 NODE 节点管ç†
> 架构文档:[NODE-StarAgent架构](/NewLife/Stardust/Blob/master/Doc/NODE-StarAgent架构.md)
> 忍¡å—文档:[NODE-9-指令下å‘](/NewLife/Stardust/Blob/master/Doc/NODE-9-指令下å‘.md) | [NODE-14-防ç«å¢™ç®¡ç†](/NewLife/Stardust/Blob/master/Doc/NODE-14-防ç«å¢™ç®¡ç†.md) | [NODE-15-StarAgent远程部署](/NewLife/Stardust/Blob/master/Doc/NODE-15-StarAgent远程部署.md) | [NODE-16-阿里云DNS动æ€åŸŸåè§£æž](/NewLife/Stardust/Blob/master/Doc/NODE-16-阿里云DNS动æ€åŸŸåè§£æž.md) | [NODE-17-进程管ç†](/NewLife/Stardust/Blob/master/Doc/NODE-17-进程管ç†.md) | [NODE-18-Web管ç†é¢æ¿](/NewLife/Stardust/Blob/master/Doc/NODE-StarAgentæž¶æž„.md#6-web-管ç†é¢æ¿) | [SVR-8-远程命令执行安全](/NewLife/Stardust/Blob/master/Doc/SVR-8-远程命令执行安全.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| NODE-1 | 节点注册与登录 | StarAgent 使用硬件信æ¯ï¼ˆUUID/ç£ç›˜/Mac)计算唯一编ç ï¼Œå‘ StarServer æ³¨å†Œå¹¶èŽ·å– JWT 令牌 |
| NODE-2 | èŠ‚ç‚¹å¿ƒè·³ä¿æ´» | StarAgent 定期å‘é€å¿ƒè·³ï¼ˆå«æ€§èƒ½æŒ‡æ ‡ï¼‰ï¼ŒæœåŠ¡ç«¯æ›´æ–°åœ¨çº¿çŠ¶æ€ |
| NODE-3 | 节点在线状æ€ç®¡ç† | 实时追踪节点在线/离线状æ€ï¼Œä¼šè¯è¶…æ—¶è‡ªåŠ¨æ ‡è®°ç¦»çº¿ |
| NODE-4 | 节点历å²è®°å½• | 记录节点登录/登出/å‡çº§ç‰äº‹ä»¶ |
| NODE-5 | 节点数æ®ç®¡ç† | 查看节点上报的详细性能数æ®ï¼ˆCPU/内å˜/ç£ç›˜/网络) |
| NODE-6 | èŠ‚ç‚¹ç‰ˆæœ¬ç®¡ç† | è¿½è¸ªèŠ‚ç‚¹ä¸Šå„æ¡†æž¶ç»„ä»¶çš„ç‰ˆæœ¬ä¿¡æ¯ |
| NODE-7 | 节点统计 | 按时间维度统计节点数é‡ã€åœ¨çº¿çŽ‡ç‰æŒ‡æ ‡ |
| NODE-8 | 节点规则é…ç½® | 为节点é…置自定义规则(如告è¦é˜ˆå€¼ã€éƒ¨ç½²ç–略) |
| NODE-9 | èŠ‚ç‚¹å‘½ä»¤ä¸‹å‘ | 通过 WebSocket å‘ StarAgent 下å‘远程命令(å¯åЍ/åœæ¢æœåŠ¡ã€æ‰§è¡Œè„šæœ¬ç‰ï¼‰ |
| NODE-10 | 节点å‡çº§ | StarAgent 自动检测版本更新并å‡çº§è‡ªèº« |
| NODE-11 | 节点在线会è¯ç®¡ç† | 管ç†èŠ‚ç‚¹ WebSocket é•¿è¿žæŽ¥ä¼šè¯ |
| NODE-12 | 节点定ä½ä¿¡æ¯ | 记录和展示节点的地ç†ä½ç½®ä¸Žç½‘络拓扑 |
| NODE-13 | èŠ‚ç‚¹æ¡†æž¶ç®¡ç† | 管ç†èŠ‚ç‚¹ä¸Šçš„ .NET è¿è¡Œæ—¶ç‰ˆæœ¬ |
| NODE-14 | 防ç«å¢™ç®¡ç† | 通过 StarAgent 管ç†èŠ‚ç‚¹é˜²ç«å¢™è§„则 |
| NODE-15 | StarAgent 远程部署 | 通过 SSH/远程方å¼å°† StarAgent éƒ¨ç½²åˆ°ç›®æ ‡æœºå™¨ |
| NODE-16 | 多供应商 DNS DDNS | 动æ€åŸŸåè§£æžï¼Œæ”¯æŒé˜¿é‡Œäº‘/腾讯云(DNSPod)/优刻得(UDNS)/AWS Route53 四家供应商,æœåŠ¡ç«¯ `DnsService` 自动检测节点 IP å˜åŒ–å¹¶è§¦å‘ DNS æ›´æ–° |
| NODE-17 | è¿›ç¨‹ç®¡ç† | StarAgent ç®¡ç†æœ¬åœ°åº”用进程的å¯åЍã€åœæ¢ã€å®ˆæŠ¤ã€è‡ªåЍé‡å¯ |
| NODE-18 | StarAgent Web 管ç†é¢æ¿ | StarAgent 内置 Web 颿¿ï¼Œ7 Tab 管ç†ç•Œé¢ï¼ˆçжæ€/åæœåŠ¡/控制/é…ç½®/星尘设置/日志/看门狗) |
| NODE-19 | 域åä¾›åº”å•†ç®¡ç† | ç®¡ç† DNS ä¾›åº”å•†å‡æ®é…置(阿里云/AWS Route53 ç‰ï¼‰ï¼Œæ”¯æŒå¤šä¾›åº”商 DDNS |
### 3.6 CFG é…ç½®ä¸å¿ƒ
> 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| CFG-1 | é…置拉å–(GetAll) | 应用通过 API 拉å–全部é…置,支æŒç‰ˆæœ¬å·å¢žé‡æ›´æ–° |
| CFG-2 | é…置设置(SetAll) | 应用上报所用é…置键和缺失键,æœåŠ¡ç«¯æ›´æ–° |
| CFG-3 | é…ç½®åŽ†å² | 记录é…ç½®çš„å˜æ›´åކå²ï¼Œæ”¯æŒå›žæ»šè¿½æº¯ |
| CFG-4 | é…置数æ®ç®¡ç† | 在 StarWeb 上按应用/作用域管ç†é…置项 |
| CFG-5 | 应用规则(Scope) | æ ¹æ®åº”用所在 IP/机房自动匹é…é…置作用域 |
| CFG-6 | é…ç½®åœ¨çº¿çŠ¶æ€ | 追踪é…置在å„åº”ç”¨å®žä¾‹ä¸Šçš„åŠ è½½æƒ…å†µ |
| CFG-7 | HTTP é…ç½®æä¾›è€… | 客户端通过 HTTP 从é…ç½®ä¸å¿ƒæ‹‰å–é…ç½® |
| CFG-8 | é…置自动注册 | 新应用首次拉å–é…置时自动创建应用记录 |
### 3.7 REG 注册ä¸å¿ƒä¸ŽæœåŠ¡å‘现
> 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| REG-1 | æœåŠ¡æ³¨å†Œ | åº”ç”¨å‘æ³¨å†Œä¸å¿ƒä¸ŠæŠ¥è‡ªèº«æä¾›çš„æœåŠ¡ä¿¡æ¯ |
| REG-2 | æœåŠ¡å‘现 | 消费方按æœåС忋‰å–æä¾›è€…列表 |
| REG-3 | æœåŠ¡ä¿¡æ¯ç®¡ç† | 在 StarWeb 上查看和管ç†å·²æ³¨å†Œçš„æœåŠ¡ |
| REG-4 | æ¶ˆè´¹æ–¹ä¿¡æ¯ | 记录æœåŠ¡çš„æ¶ˆè´¹è€…ä¿¡æ¯ï¼Œè°ƒç”¨æ‹“扑 |
| REG-5 | æœåŠ¡å¥åº·æ£€æŸ¥ | 通过心跳和主动探测检查æœåŠ¡å¥åº· |
| REG-6 | 注册ä¸å¿ƒ Web ç®¡ç† | StarWeb 上å¯è§†åŒ–æµè§ˆæ³¨å†Œä¸å¿ƒ |
### 3.8 APM 监控ä¸å¿ƒ / APM
> 架构文档:[APM-监控系统架构](/NewLife/Stardust/Blob/master/Doc/APM-监控系统架构.md)
> 忍¡å—文档:[APM-3-链路追踪统计](/NewLife/Stardust/Blob/master/Doc/APM-3-链路追踪统计.md) | [APM-17-监控接入API](/NewLife/Stardust/Blob/master/Doc/APM-17-监控接入API.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| APM-1 | 埋点数æ®ä¸ŠæŠ¥ | 客户端按周期批é‡ä¸ŠæŠ¥åŸ‹ç‚¹ç»Ÿè®¡æ•°æ® |
| APM-2 | 压缩数æ®ä¸ŠæŠ¥ | æ”¯æŒ GZip 压缩åŽçš„å¤§æ‰¹é‡æ•°æ®ä¸ŠæŠ¥ |
| APM-3 | 追踪统计æœåŠ¡ | æœåŠ¡ç«¯æ ¸å¿ƒç»Ÿè®¡å¼•æ“Žï¼ˆçº¦ 80% 系统资æºï¼‰ï¼Œå¤„ç†åŸ‹ç‚¹æ•°æ®èšåˆ |
| APM-4 | åº”ç”¨æ¯æ—¥ç»Ÿè®¡ | æŒ‰åº”ç”¨ç»´åº¦æ¯æ—¥æ±‡æ€»ç»Ÿè®¡æŒ‡æ ‡ |
| APM-5 | 埋点项统计 | 按 TraceItem 维度统计å„埋点的调用é‡ã€æˆåŠŸçŽ‡ |
| APM-6 | é‡‡æ ·æ•°æ® | è®°å½•æ¯æ¬¡è°ƒç”¨çš„详细信æ¯ï¼Œç”¨äºŽé—®é¢˜æŽ’查 |
| APM-7 | è¿½è¸ªæ•°æ® | å˜å‚¨åŽŸå§‹åŸ‹ç‚¹è®°å½• |
| APM-8 | 分钟/å°æ—¶/天统计 | 多时间粒度的预èšåˆç»Ÿè®¡ |
| APM-9 | 追踪规则 | é…ç½®è¿½è¸ªé‡‡æ ·è§„åˆ™ã€æŽ’é™¤è§„åˆ™ã€è¶…时阈值 |
| APM-10 | 告è¦ç»„ | 定义告è¦é€šçŸ¥ç»„(æˆå‘˜ã€é€šçŸ¥æ–¹å¼ï¼‰ |
| APM-11 | 告è¦åŽ†å² | 记录告è¦è§¦å‘历å²å’Œå¤„ç†æƒ…况 |
| APM-12 | 报è¦è®°å½• | 记录具体的报è¦äº‹ä»¶ |
| APM-13 | 应用跟踪器 | ç®¡ç†æ¯ä¸ªåº”ç”¨å®žä¾‹çš„é‡‡æ ·çŽ‡ã€å‘¨æœŸç‰å‚æ•° |
| APM-14 | å‘Šè¦æœåŠ¡ | åŽå°æœåŠ¡æ ¹æ®è§„则自动触å‘告è¦ï¼Œæ”¯æŒé’‰é’‰æœºå™¨äºº/ä¼ä¸šå¾®ä¿¡ Webhook åŒé€šé“通知 |
| APM-15 | APM 客户端(StarTracer) | 自动埋点采集 DB/Redis/HTTP/gRPC ç‰è°ƒç”¨ |
| APM-16 | 调用链å¯è§†åŒ– | StarWeb 上展示调用链拓扑和详情 |
| APM-17 | 监控接入 API | é¢å‘éž .NET 平尿供 HTTP API,支æŒå¤šè¯è¨€ SDK 接入 |
### 3.9 LOG 日志ä¸å¿ƒ
> 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| LOG-1 | 应用日志接收 | 应用通过 HTTP POST ä¸ŠæŠ¥æ—¥å¿—æ•°æ® |
| LOG-2 | 日志查询 | StarWeb 上按应用/级别/æ—¶é—´/å…³é”®è¯æ£€ç´¢ |
| LOG-3 | å®¢æˆ·ç«¯æ—¥å¿—ç®¡ç† | 管ç†å„客户端实例的日志é…ç½® |
### 3.10 PUB 远程å‘布
> 架构文档:[PUB-远程å‘布架构](/NewLife/Stardust/Blob/master/Doc/PUB-远程å‘布架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| PUB-1 | åº”ç”¨éƒ¨ç½²é›†ç®¡ç† | å®šä¹‰åº”ç”¨éƒ¨ç½²çš„å…ƒä¿¡æ¯ |
| PUB-2 | 应用部署节点 | 将部署集关è”到具体节点 |
| PUB-3 | éƒ¨ç½²ç‰ˆæœ¬ç®¡ç† | ä¸Šä¼ å’Œç®¡ç†åº”用包多版本,按平å°è‡ªåŠ¨åŒ¹é… |
| PUB-4 | éƒ¨ç½²åŽ†å² | è®°å½•æ¯æ¬¡éƒ¨ç½²æ“作的详情 |
| PUB-5 | æµæ°´çº¿ç®¡ç† | 定义 CI/CD æµæ°´çº¿ |
| PUB-6 | æµæ°´çº¿æ¥éª¤ | æµæ°´çº¿çš„å•个执行æ¥éª¤ |
| PUB-7 | æµæ°´çº¿è¿è¡Œ | æµæ°´çº¿çš„æ‰§è¡Œè®°å½•和状æ€è¿½è¸ª |
| PUB-8 | ç¼–è¯‘èŠ‚ç‚¹ç®¡ç† | 管ç†ç”¨äºŽç¼–译构建的节点 |
| PUB-10 | SSL è¯ä¹¦ç®¡ç† | ç»Ÿä¸€ç®¡ç† SSL/TLS è¯ä¹¦ |
| PUB-11 | é™„ä»¶ç®¡ç† | éƒ¨ç½²åŒ…æ–‡ä»¶çš„ä¸Šä¼ ã€å˜å‚¨ã€åˆ†å‘ |
| PUB-12 | Webhook æ”¯æŒ | 部署事件触å‘çš„ Webhook 通知 |
| PUB-13 | 产å“ç‰ˆæœ¬ç®¡ç† | 管ç†äº§å“级版本å‘布计划 |
| PUB-14 | 产å“å‘布包 | 管ç†äº§å“çš„å‘布包文件 |
| PUB-15 | dotNet 安装包 | 管ç†å’Œåˆ†å‘ .NET è¿è¡Œæ—¶å®‰è£…包 |
| PUB-16 | 部署æœåŠ¡ | æœåŠ¡ç«¯ç‰ˆæœ¬åŒ¹é…ã€è¯ä¹¦åŒ¹é…ã€ä¾èµ–检查 |
| PUB-17 | 部署客户端 | StarAgent 端执行应用包的下载ã€è§£åŽ‹ã€å¯åœã€å®ˆæŠ¤ |
| PUB-18 | å¤šéƒ¨ç½²æ¨¡å¼ | Standard/Shadow/Hosted/Task å››ç§æ¨¡å¼ |
| PUB-19 | 应用包规范 | 应用包 zip æ ¼å¼å’Œ star.json é…ç½®è§„èŒƒï¼Œæ”¯æŒ star CLI å‘½ä»¤ç®¡ç† |
| PUB-20 | éƒ¨ç½²ä»£ç† | DeployAgent ç¼–è¯‘èŠ‚ç‚¹ï¼Œè‡ªåŠ¨å®Œæˆæ‹‰å–代ç ã€ç¼–è¯‘ã€æ‰“包ã€ä¸Šä¼ |
| PUB-21 | åˆ†å¸ƒå¼æ–‡ä»¶å˜å‚¨ | å†™æ‰©æ•£æž¶æž„ï¼Œè‡ªåŠ¨åŒæ¥é™„ä»¶æ–‡ä»¶åˆ°æ‰€æœ‰èŠ‚ç‚¹ï¼Œæ— éœ€ NAS/OSS |
| PUB-22 | Nginx ç«™ç‚¹ç®¡ç† | StarAgent 管ç†èŠ‚ç‚¹ä¸Š Nginx 站点é…置,支æŒç«™ç‚¹æ£€æµ‹ä¸Žè‡ªåЍå‘布 |
### 3.11 GW 网关管ç†
> 架构文档:[GW-网关架构](/NewLife/Stardust/Blob/master/Doc/GW-网关架构.md)
> 忍¡å—文档:[DOC-GW-7-网关竞å“分æž](/NewLife/Stardust/Blob/master/Doc/GW-7-网关竞å“分æž.md) | [DOC-GW-8-网关使用指å—](/NewLife/Stardust/Blob/master/Doc/GW-8-网关使用指å—.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| GW-1 | 网关é…ç½®ä¸‹å‘ | StarGateway 从 StarServer 拉å–路由é…ç½® |
| GW-2 | ç½‘å…³è·¯ç”±ç®¡ç† | StarWeb 上管ç†è·¯ç”±è§„则 |
| GW-3 | ç½‘å…³é›†ç¾¤ç®¡ç† | 管ç†ç½‘关实例集群 |
| GW-4 | ç½‘å…³èŠ‚ç‚¹ç®¡ç† | 管ç†å„网关节点的è¿è¡ŒçŠ¶æ€ |
| GW-5 | 网关è¯ä¹¦ç®¡ç† | 管ç†ç½‘å…³ SSL è¯ä¹¦ |
| GW-6 | StarGateway é›†æˆ | 作为 StarServer 客户端统一接入 |
| GW-7 | NAT 代ç†è½¬å‘ | 通用 TCP/UDP NAT 代ç†ï¼Œæ”¯æŒè·¨å议数æ®è½¬å‘ |
### 3.12 DBM Redis/MySQL 管ç†
> 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md)
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| DBM-1 | Redis èŠ‚ç‚¹ç®¡ç† | ç®¡ç† Redis æœåŠ¡å™¨èŠ‚ç‚¹ |
| DBM-2 | Redis æ•°æ®æµè§ˆ | æµè§ˆå’ŒæŸ¥è¯¢ Redis ç¼“å˜æ•°æ® |
| DBM-3 | Redis 消æ¯é˜Ÿåˆ— | ç®¡ç† Redis 消æ¯é˜Ÿåˆ—消费情况 |
| DBM-4 | MySQL èŠ‚ç‚¹ç®¡ç† | ç®¡ç† MySQL æœåŠ¡å™¨èŠ‚ç‚¹ |
| DBM-5 | MySQL æ•°æ®æµè§ˆ | æµè§ˆå’ŒæŸ¥è¯¢ MySQL æ•°æ® |
| DBM-6 | Redis/MySQL æœåŠ¡ | æœåŠ¡ç«¯ä»£ç†å’Œç®¡ç†è¿žæŽ¥ |
### 3.13 MCP 工具æœåŠ¡èƒ½åŠ›
> 架构文档:[MCP-MCP架构](/NewLife/Stardust/Blob/master/Doc/MCP-MCP架构.md)
> 忍¡å—文档:[MCP-1-token管ç†](/NewLife/Stardust/Blob/master/Doc/MCP-1-token管ç†.md) | [MCP-2-action扩展](/NewLife/Stardust/Blob/master/Doc/MCP-2-action扩展.md)
MCP(Model Context Protocol)是é¢å‘ LLM/æ™ºèƒ½ä½“çš„æ ‡å‡†å议。通过实现 MCP HTTP 端点,Stardust å¯å°†å…¨éƒ¨ç®¡ç†èƒ½åŠ›é€šè¿‡æ ‡å‡†å议暴露给 AI åŠ©æ‰‹ï¼Œæ— éœ€ä¸ºæ¯ä¸ª Agent 釿–°å¼€å‘适é…层。
| ç¼–ç | 功能 | 说明 |
|------|------|------|
| MCP-1 | MCP HTTP 端点 | `POST /mcp` 端点,JSON-RPC 2.0 åè®®ï¼Œæ”¯æŒ `initialize`/`tools.list`/`tools.call` |
| MCP-2 | MCP 5 个工具 | `list_authorized_resources` / `search_resources` / `get_resource` / `list_actions` / `invoke_action` |
| MCP-3 | MCP Token å‡è¯ç®¡ç† | 独立于 Web 登录æ€çš„ Token 鉴æƒä½“ç³»ï¼Œæ”¯æŒ Enable 开关和过期时间 |
| MCP-4 | MCP èµ„æºæŽˆæƒ | 三类资æºï¼ˆProject/Node/App)+ IsAll é€šé…æŽˆæƒï¼ŒOR å…³ç³»ç»„åˆ |
| MCP-5 | MCP 审计日志 | æ¯æ¬¡å·¥å…·è°ƒç”¨çš„审计记录,å«å…¥å‚脱æ•和耗时统计 |
| MCP-6 | èŠ‚ç‚¹ç®¡ç† Action(4 个) | `node_list_online` / `node_send_command` / `node_upgrade` / `node_search` |
| MCP-7 | åº”ç”¨ç®¡ç† Action(7 个) | 在线列表/命令下å‘/æœåŠ¡å‘现/生命周期(restart/stop/start) |
| MCP-8 | é…ç½®ä¸å¿ƒ Action(2 个) | `config_get` / `config_set` |
| MCP-9 | 远程å‘布 Action(9 个) | 部署集查询/编译/版本/历å²/部署 + æµæ°´çº¿è§¦å‘/查询/å–æ¶ˆ |
| MCP-10 | ç½‘å…³ç®¡ç† Action(2 个) | `gateway_list_routes` / `gateway_list_clusters` |
| MCP-11 | 监控ä¸å¿ƒ Action(2 个) | `monitor_trace_search` / `monitor_alarm_list` |
| MCP-12 | 系统 Action(1 个) | `get_audit_log`ï¼ˆæŸ¥è¯¢å½“å‰ Token 调用记录)|
---
## 4. 🧊 暂缓清å•
| 功能 | 暂缓ç†ç”± | è§£å†»å‰æ |
|------|----------|----------|
| é›†æˆæµ‹è¯•å…¨é¢è¦†ç›– | 项目规模大,测试基础设施未æå»º | 测试框架æå»ºå®Œæˆ |
| 多è¯è¨€ SDK 完善 | SDK 目录已有 Go/Python/JS 示例但未完整维护 | 社区贡献或商务需求 |
| 网关 Web UI é…ç½® | 网关基础能力稳定åŽå¯è§†åŒ–ç®¡ç† | StarGateway 基础能力完善 |
| 陿µ/ç†”æ– | 需è¦å®šä¹‰é…置模型和算法实现 | è´Ÿè½½å‡è¡¡å’Œå¥åº·æ£€æŸ¥å®Œå–„åŽ |
| HTTP/2 / HTTP/3 æ”¯æŒ | å½“å‰ HTTP/1.1 满足 MVP 需求 | 出现必须 HTTP/2 çš„åŽç«¯æˆ–客户端需求 |
## 5. ä¸åšä»€ä¹ˆ
- **䏿›¿ä»£ä¸“业日志分æžå¹³å°**(如 ELK)。日志ä¸å¿ƒå®šä½ä¸ºåº”用è¿è¡Œæ—¥å¿—集䏿Ÿ¥çœ‹ï¼Œä¸æä¾›å…¨æ–‡ç´¢å¼•ç‰é«˜çº§èƒ½åŠ›
- **䏿›¿ä»£ä¸“业 APM 系统**(如 SkyWalking/Pinpointï¼‰ã€‚é‡‡ç”¨å®¢æˆ·ç«¯é‡‡æ ·ç»Ÿè®¡æ¨¡å¼ï¼Œéžå…¨é‡é‡‡é›†
- **ä¸åš SaaS 化多租户**。定ä½ä¸ºä¼ä¸šå†…部部署
- **ä¸å¼ºåˆ¶ä¾èµ–外部ä¸é—´ä»¶**ã€‚æ ¸å¿ƒé“¾è·¯åªéœ€æ•°æ®åº“å³å¯è¿è¡Œï¼ŒRedis/消æ¯é˜Ÿåˆ—为å¯é€‰å¢žå¼º
|