Web Dashboard 快速上手
Web Dashboard 是 Cube Sandbox 的管理控制台，适合在部署完成后查看集群状态、管理模板、创建沙箱，以及从节点视角做基础运维巡检。
如果你已经完成安装，建议按照下面的顺序阅读：
- 先看 概览，确认集群资源和健康状态是否正常。
- 再看 模板管理，确保至少有一个
READY模板可用。 - 然后看 沙箱管理，完成创建、查看详情、暂停、恢复和终止等常见操作。
- 最后根据需要查看 节点与容量，从集群视角排查容量、健康度和副本分布。
适用范围
本页面向已经完成 Cube Sandbox 安装的用户，尤其适合：
- 想通过图形界面而不是 CLI 完成日常管理的运维或平台同学
- 想快速确认模板、沙箱、节点状态是否正常的值班同学
- 想把 Dashboard 作为日常入口，而把 CLI 作为补充工具的使用者
如何打开 Dashboard
默认情况下，Web UI 会随控制面一起部署。完成安装后，可以通过浏览器访问 Web Dashboard。
如果你使用的是一键安装或离线部署，请优先参考部署文档中关于 Web UI 端口、反向代理和域名访问的说明：
左侧导航一览
当前 Dashboard 的主要页面包括：
- 概览（Overview）：查看集群 KPI、最近沙箱和模板流水线
- 沙箱（Sandboxes）：查看沙箱列表、筛选、进入详情、执行暂停/恢复/终止
- 模板（Templates）：查看模板列表、创建模板、进入模板详情、发起重建或删除
- 模板商店（Template Store）：从预置目录快速安装官方模板，减少首次配置成本
- 节点（Nodes）：查看节点健康、资源占用、本地模板和节点上的运行中沙箱
- 可观测性（Observability）：查看沙箱分布、节点健康、API 连通性与失败模板清单
- 网络（Network）：查看入口配置、模板出网策略、节点配额与并发限制
- API Keys：管理 Dashboard 与管理 API 的访问凭证
- 设置（Settings）：查看站点级连接、入口和本地配置
- 模板商店：从预置目录快速安装官方模板，减少首次配置成本
数据来源与刷新节奏
Dashboard 的前端请求会访问同源的 /cubeapi/v1 管理接口，并在本地自动读取已保存的 API Key，使用 X-API-Key 头发起请求。
在 UI 中，多数列表和状态卡片会自动刷新：
- 概览页中的沙箱列表约每 5 秒刷新一次
- 概览页中的集群资源约每 10 秒刷新一次
- 节点信息约每 15 秒刷新一次
- 模板与构建日志会根据状态定期轮询
因此，Dashboard 适合做“近实时观察”和“日常操作入口”，但不适合替代更细粒度的监控系统。
推荐操作路径
对第一次使用 Dashboard 的用户，建议采用下面的路径：
1. 先确认集群可用
打开 概览，先看：
- 当前运行中的沙箱数量
- CPU / 内存利用率是否过高
- 健康节点数量是否异常
- 是否已经存在可用模板
2. 再准备模板
进入 模板管理，确认至少有一个状态为 READY 的模板。
如果当前还没有模板，可以直接在 Dashboard 创建，也可以继续使用 CLI：
如果你在配置访问凭证或环境连接，建议同时查看：
3. 然后创建与管理沙箱
进入 沙箱管理，从可用模板创建沙箱，并在详情页查看：
- 资源规格
- 运行状态
- Metadata
- 实时日志
4. 最后从节点视角做容量与健康检查
如果你需要确认：
- 模板副本是否已经分发到目标节点
- 某个节点是否资源紧张
- 某个节点上当前承载了哪些沙箱
请查看 节点与容量。
5. 日常值班时用可观测性页做总览
如果你已经进入日常值班或巡检阶段，建议补充查看：
- 可观测性（Observability） — 从沙箱、节点、管理 API 与失败模板四个维度看异常
- 网络（Network） — 查看入口配置、模板出网策略与节点配额
- 对象速查：模板、沙箱、节点、网络 — 已知异常落在对象层时快速选页
- API Keys 管理 — 管理浏览器和自动化脚本使用的访问凭证
- 设置（Settings） — 查看站点级连接与基础配置
与 CLI / API 的边界
Dashboard 更适合以下场景：
- 日常巡检和状态查看
- 模板、沙箱、节点的图形化管理
- 面向值班或平台运维的快速操作
CLI 和 API 更适合以下场景：
- 自动化脚本与批量操作
- 精细化参数控制
- 模板请求预览、构建流程排查、集成到现有运维系统
你可以把它们理解为：
- Dashboard：操作与巡检入口
- CLI：高级控制与排障工具
- API：系统集成入口