# 节点类型（通用被控 / 监控节点 / xcc套件 / 虚拟化节点）

> 文档更新：2026-09-27 ｜ 适用版本：v3 ｜ 功能位置：节点列表页（添加节点、节点设置弹窗）

## 节点是什么

星梦面板采用「主控—被控」架构：主控是用户日常操作的面板程序，被控是安装在各个服务器上的代理程序。服务器安装被控并接入主控后，就成为一个可管理的「节点」，面板里对网站、容器、数据库、虚拟机等的操作都会通过被控下发到对应服务器执行。

节点分为四种类型，类型决定了这台服务器在面板中承担的角色。

## 四种类型

| 类型 | 作用 | 适用场景 |
|---|---|---|
| 通用被控 | 全功能节点：部署网站、容器、数据库、运行环境，使用文件管理、定时备份等系统功能 | 承载实际业务的主力服务器 |
| 监控节点 | 仅采集并上报监控数据（CPU、内存、磁盘、流量等），不提供部署类功能 | 只想被「看」不被「用」的机器，如专门跑监控的设备 |
| xcc套件 | 作为集群 CDN 的边缘节点对外提供分发服务，配合「集群控制」模块使用 | 加入 XCC 集群、承担 CDN 边缘分发的服务器 |
| 虚拟化节点 | 基于 Incus 实现的虚拟化管理，支持 LXD 和 KVM 两种虚拟化方案，创建和管理虚拟机 | 需要开虚拟机的物理机或配置较高的服务器 |

补充说明：

- **xcc套件即「边缘节点」**：早期版本中该类型曾被称作「边缘节点」，现统一称为「xcc套件」。在集群控制（XCC 站点、DNS 调度）等语境下提到的「边缘节点」，指的就是这种类型。
- 数据概览页顶部的节点统计、资源概览会显示所有四种类型的节点；各类型节点的专属功能入口不同：通用被控的业务功能分布在网站管理、数据库、应用商店等模块，xcc套件的功能在「集群控制」模块，虚拟化节点的虚拟机管理在「虚拟化」模块。

## 如何添加节点

入口：侧边栏底部「节点列表」→「添加节点」。需要填写节点 ID、被控地址（服务器 IP 和被控端口）、备注（可选）和节点类型，然后按安装引导在目标服务器上安装对应类型的被控程序。

## 类型可以修改吗

可以。节点列表 → 选中节点 →「设置」→ 节点类型，改后保存即可，修改的是主控侧的角色标签，不会自动重装被控程序。

需要注意的是，四种类型对应的被控端程序并不相同。修改类型后如果节点功能表现不正常（例如改为通用被控后看不到部署功能），需要按新类型的安装方式更新节点上的被控程序。各类型均已支持在线更新：通用被控直接在线拉取新版本；监控节点、xcc套件等在「安装」抽屉中会自动检测当前版本是否满足在线更新条件，老版本先手动执行一次更新命令，之后即可全部走在线更新。

## 常见疑问

**问：监控节点和通用被控都能看监控数据，为什么要区分？**
通用被控是全功能节点，监控只附带在其中；监控节点则只做数据采集，不开放部署类功能。给一台只用来采集数据的机器装通用被控是浪费，装监控节点即可。

**问：添加节点时类型选错了怎么办？**
在节点设置里改成正确类型即可（见上节）。如果改后功能不正常，按新类型更新被控程序。

**问：删除节点会删掉服务器上的数据吗？**
不会。删除节点只是移除面板中的管理记录，服务器系统和其上的业务数据不受影响；如需彻底移除被控程序，走节点列表「安装」中的卸载流程。

**问：节点名称后面括号里的数字是什么？**
是节点 ID。节点在列表中显示为「备注 (ID)」，没有设置备注时显示为「节点 ID」。

## 指导用户时的注意点

- 指导部署类操作前，先确认目标节点是通用被控；指导集群 CDN 操作前，确认节点是 xcc套件且集群控制已配置。
- 用户提到「边缘节点」时按「xcc套件」理解，反之亦然。
- 修改类型 ≠ 重装被控，两类操作不要混为一谈；改类型后功能异常的补救手段是按新类型更新被控程序。