常见问题速查（FAQ）
这页只做一件事：用最短路径回答高频问题，并把你送到更深入的页面。
我该走哪条安装路径？
如果你的机器有 /dev/kvm，优先看：
如果没有 /dev/kvm，优先看：
如果 install.sh 成功但 smoke.sh 失败，优先看：
Dashboard 能打开，为什么点按钮就失败？
最常见原因是：
- 鉴权异常
- WebUI 反代入口异常
cube-api后端不健康
优先看：
模板为什么一直不 READY？
先区分：
- 长期
BUILDING / FAILED→ 构建链路问题 - 已经
READY但副本不一致 → 分发链路问题
优先看：
模板商店显示已安装 / 未安装，为什么和我理解的不一样？
模板商店通常只把 READY 模板视为“已安装”。
优先看：
沙箱创建出来了，但为什么还是不可用？
优先分三类：
- 无日志或很快退出
pause / resume异常- guest 无法登录
优先看：
节点在线，为什么业务还是跑不起来？
最常见方向：
- 节点注册异常
- 节点容量不足
- 模板副本没有覆盖到目标节点
优先看：
域名、入口和外网访问问题怎么快速分流？
先区分：
- Dashboard 入口异常
cube.app/ 自定义域名解析异常- 沙箱访问外网失败
优先看：
API 和运维入口应该怎么选？
- 要接入 Dashboard 背后的管理面：看 API 总览
- 要判断状态码：看 管理 API 错误码与排障矩阵
- 要看服务状态和日志：看 服务管理与日志