# 数据概览页（首页）

> 文档更新：2026-09-27 ｜ 适用版本：v3 ｜ 功能位置：主控端「数据概览」页（系统首页，路径 /dashboard/overview）

## 这个页面是干什么的

数据概览页是打开面板后看到的首页，把最常用的全局信息集中在一屏，从上到下依次是：

1. **安全状态横幅**——数据加密与 mTLS 证书状态（内容较多，见单独文档：https://www.xmpanel.cn/docs/ai/security-status-banner.md ）；
2. **节点统计卡**——各类型节点数量一览；
3. **资源概览卡**——每台节点的实时资源占用；
4. **待办事项卡**——运维备忘清单。

## 节点统计卡

显示四个数字：通用被控、监控节点、xcc套件、虚拟化节点的数量。四种类型的区别见节点类型文档：https://www.xmpanel.cn/docs/ai/node-types.md

## 资源概览卡

每台节点显示为一张小卡片，包含：节点名称与类型、状态标签、CPU / 内存 / 磁盘占用圆环、当前上行/下行网速。数据每 30 秒自动刷新；节点较多时按每页 4 个分页显示；**点击任意节点卡片可进入「资源监控」页，查看该节点 CPU / 内存 / 磁盘的历史趋势图**。

### 状态标签的含义

| 标签 | 颜色 | 含义 |
|---|---|---|
| 在线 | 绿 | 节点正常，数据实时 |
| 离线 | 灰 | 主控联系不上节点（关机、断网、被控停止） |
| 获取中 | 黄 | 正在向节点拉取数据，稍等片刻即可 |
| 采集失败 | 红 | 节点在线，但监控数据采集出了问题（见下文） |

**「在线但采集失败」是最容易误解的状态**：它表示节点本身活着（网络通、被控程序在运行），只是监控数据的采集环节出现异常。此时卡片上显示的资源数值是**最后一次成功采集的数据**，不一定反映当前实况——把鼠标悬停在红色标签上可以看到最后一次成功采集的时间。处理建议：先等待（面板会自动重试，30 秒一轮）；持续失败时，到节点列表对节点执行被控服务重启或更新被控程序。注意：采集失败不影响节点上正在运行的业务（网站、容器等照常工作），只影响面板上看到的数据是否新鲜。

### 圆环颜色与缺失

圆环按占用率变色：低于 60% 绿色，60%–79% 黄色，80% 及以上红色。红色提示资源紧张，建议结合「资源监控」页的历史趋势判断是持续高负载还是瞬时峰值。

如果某个节点只有 CPU 和内存两个圆环、没有磁盘圆环和网速数字，并显示「节点未升级，暂无磁盘与网速数据」，说明该节点的被控程序版本过旧，不支持这几项数据。到节点列表更新该节点的被控程序即可恢复完整显示。

## 待办事项卡

用于记录运维备忘，例如证书到期日、服务器续费、定期巡检提醒。

- **新增**：卡片右上角「新增待办」；**编辑/删除**：鼠标悬停在条目上出现按钮；**查看**：点击条目本体。
- 条目可以填写标题、详细内容、时间，并可标记「紧急」（条目上显示红色标签）。
- **到期提醒规则**：已过设定时间的条目标记红色「已过期」；24 小时内到期的标记黄色「即将到期」；存在此类条目时，列表顶部会出现汇总提示条。
- 数量上限 6 条。

**重要：待办仅保存在主控所在电脑的本地**，不在云端、不跨设备同步。换电脑或重装系统后待办不会自动恢复，如有需要请自行记录备份。

## 常见疑问

**问：某个节点一直显示「采集失败」，但服务器上的网站都正常，是什么问题？**
这正是采集失败的特征：只影响监控数据，不影响业务。按上文建议重启/更新被控程序；若更新后仍失败，检查节点磁盘与系统状态。

**问：为什么有的节点显示三个圆环、有的只有两个？**
被控程序版本不同。旧版没有磁盘和网速数据，更新被控后即可补全（见上文「圆环颜色与缺失」）。

**问：待办事项换了一台电脑怎么没有了？**
待办只存在主控本机（见上文）。这不是故障，也无法从其他设备找回。

**问：资源概览里的网速是什么单位？**
MB/s（兆字节每秒），为该节点当前的上行/下行速率实时值。

## 指导用户时的注意点

- 用户说「首页」「主页」时，通常指本页（数据概览）。
- 区分「离线」和「采集失败」：用户描述红色标签时先确认具体文字——「离线」查网络与被控进程，「采集失败」查被控程序版本与服务状态；两者处理方向不同。
- 采集失败场景下提醒用户：当前显示的数值可能是旧数据，不要依据它判断节点当下的负载。
- 用户询问节点类型含义时，引导至节点类型文档：https://www.xmpanel.cn/docs/ai/node-types.md