// DOCS · 集群控制 ▍

集群控制

基于 L2 辅助主控的集群管控：汇聚节点数据、分发配置、管理云端证书，统一驱动 XCC 边缘节点。

前置条件：L2 已配置且在线 ——以下所有功能都建立在它之上。

辅助主控（L2）

L2 是集群管控核心，负责汇聚节点数据、分发配置、管理云端证书。

配置：L2 服务地址、主控端口（ mtlsPort ）、上报端口（ agentPort ）。
安装 / 更新 / 卸载 ：生成证书 → 提供安装命令（复制或 SSH 执行）。
告警：SMTP 发件设置 + 告警策略（启用开关、收件邮箱、冷却、每日上限）。
Agent 密钥 ：授权节点列表，绑定 IP。
L2 凭证 ：查看推送到 L2 的 DNS API 凭证（云端证书 / DNS 调度使用，密钥在 L2 侧加密存储），可删除；主控侧删除凭证不会自动同步，需在此手动清理。

批量为节点重新生成并下发 L2 凭证：

节点表格多选二次确认批量下发

支持按类型快选：被控 / 监控 / XCC。

L2 级 SSL 证书管理（区别于证书中心的本地证书）。

ACME 申请 ：通过 Let's Encrypt DNS-01，由 L2 自动完成（选 DNS 服务商与凭证，凭证会自动同步到 L2；凭证配置见云端资源）。
上传证书 ：手动粘贴 PEM / KEY，或从主控证书导入。
自动续期 ：ACME 证书可开启自动续期（L2 定时任务），手动上传证书不可续期。
与站点联动 ：XCC 站点绑定 L2 证书后，续期自动同步到站点，无需手动处理。

XCC 边缘集群的自动容灾调度：L2 每 2 分钟探测边缘节点 IP（TCP 探测 2 次、单次超时 5s，全失败才判定异常），健康节点自动进入「调度域名」的解析，故障节点自动摘除。

L2 探测节点健康入解析 · 故障即摘除业务域名 CNAME 调度域名

边缘节点的 IP 与上下线对业务方完全透明，节点维护也无需通知业务方修改解析。

调度配置 ：功能开关（默认关闭）+ 雨云凭证 + 域名 + 主机记录，调度域名实时预览与一键复制，保存并启用即触发一轮调和；支持清空配置（回到未配置状态，已添加的解析记录保持不变）。
探测记录 ：最多 20 条、IP 全局唯一；状态三态（待检测 / 正常 / 异常）+ 最近消息；停用移出解析、删除自动清理。
调度事件 ：解析添加 / 移除与异常事件流，稳态无事件属正常；页面内置教程（场景 / 方法 / 限制）。

关键限制

XCC（XMP Cloud CDN）是集群 CDN 站点管理，配置经 L2 自动同步到所有 XCC 套件边缘节点。

管理边缘节点分发的静态网站内容，两种方式：

上传 ZIP 到 L2 → 分发到边缘节点。

边缘节点直接从该 URL 拉取。

SSL 证书差异：XCC 站点仅用 L2 云端证书（无自动 Let's Encrypt、无上传、无主控证书）。