故障分流图与排查路径总览
这页不替代专题 runbook，只负责帮你先选对第一跳。
当你症状还不明确、第一次接班、或者在多篇文档之间来回跳时，建议先看这里。
如果你更需要“最短答案”或“术语解释”，也可以先看：
先做 60 秒分流
先判断问题更像哪一类：
- 安装期失败
- 控制面异常
- Dashboard 可见但操作异常
- 模板链路异常
- 沙箱运行期异常
- 节点与容量异常
- 网络与访问策略异常
症状速查表
| 症状 | 第一观察点 | 下一页 |
|---|---|---|
install.sh / smoke.sh 失败 | 健康检查、socket、KVM | 部署排障 |
| Dashboard 打不开或按钮总报错 | 12088、3000、鉴权 | Dashboard / 代理入口排障 |
401/403 或切环境后 key 异常 | API Key、鉴权回调 | 鉴权与 API Key 排障 |
模板长期 BUILDING / FAILED | 模板详情与构建日志 | 模板构建排障 |
模板 READY 但副本不一致 | 模板副本、节点 Local Templates | 模板分发与副本一致性排障 |
| 沙箱无日志、guest 登录失败 | 沙箱状态、日志、cube-runtime login | 沙箱日志与 Guest 登录排障 |
节点未注册或 degraded | 节点页、资源和 /internal/meta | 节点注册与资源排障 |
| 出网异常、域名不通 | networkType、DNS、TLS、入口 | 网络出网与访问策略排障实操 |
CubeMaster / cube-api 不健康 | 8089、3000、支撑层 | 控制面恢复与元数据排障 |
路径一：安装与首次验收异常
常见表现：
install.sh跑完但smoke.sh失败/dev/kvm不存在- 关键端口或 socket 不通
建议先看：
路径二：Dashboard 入口异常
常见表现：
- 页面打不开
- 页面能开，但操作全失败
- 切域名或入口后开始异常
建议先看：
路径三：模板链路异常
常见表现：
- 长期
BUILDING FAILEDREADY但不能起实例- 商店状态与模板页不一致
建议先看：
路径四：沙箱运行期异常
常见表现：
- 无日志
pause / resume异常- guest 无法登录
- 很快退出
建议先看：
路径五：节点、网络与控制面异常
如果症状更像资源、出网、域名、控制面或元数据问题，建议继续看：
不要先做什么
还没确认故障层级前，不建议：
- 先整组重启
- 先执行高危命令
- 先清理元数据或镜像
先看：