模板管理（Templates）
模板页是 Web Dashboard 中最重要的管理入口之一。你可以在这里完成模板的查看、创建、进入详情、重建和删除。
如果你把模板理解为“沙箱的可复用运行环境快照”，那么模板页就是把这套运行环境从“准备好”讲到“可投产”的地方。
模板列表与状态含义
模板列表页通常会以卡片方式展示每个模板，并包含以下关键信息：
templateID- 模板状态
instanceType- 创建时间
- 版本号
- 镜像信息
其中最重要的是状态字段：
READY：模板已经可用，通常可以直接用于创建沙箱BUILDING/RUNNING：模板仍在构建或处理中，需要继续等待FAILED：模板构建失败，应进入详情页查看构建信息或考虑删除后重新创建
创建模板
Dashboard 支持直接通过图形界面创建模板。通常会弹出一个创建表单，要求你填写或确认以下字段：
如果你还没有现成模板、也不想手工填写所有参数，可以优先查看 模板商店（Template Store），直接从预置模板目录安装。
templateID- 镜像地址
image instanceType- 可写层大小
writable-layer-size - 暴露端口
exposedPorts - 探针端口
probePort - 探针路径
probePath - CPU（millicores）
- Memory（MiB）
- 环境变量
env - 是否允许访问外网
allow-internet-access
其中最常用、最关键的字段通常是：
镜像地址
用于指定模板构建的基础 OCI 镜像。这一项不能为空。
可写层大小
决定模板实例运行时的可写层空间大小。默认常见值为 1G。
暴露端口与探针
如果你的运行环境需要对外提供服务，通常需要设置暴露端口；探针端口和探针路径则用于判断服务是否已准备完成。
CPU / 内存
这些值会影响模板对应沙箱实例的资源规格，应与业务实际需求相匹配。
模板详情页看什么
点击某个模板后会进入模板详情页。详情页通常适合查看以下内容：
- 当前状态
- 版本号
- 创建时间
- 镜像摘要或镜像来源
- 副本分布
- 保存下来的创建请求
- 构建状态与构建日志
- 最近一次构建任务 ID
详情页是“模板是否真的能用”的最终判断页面。
副本与节点分发怎么看
模板详情中通常会展示副本信息，例如：
- 节点 ID / 节点 IP
- 当前副本状态或 phase
- 规格信息
- artifact ID
- 最近一次任务 ID
这部分最适合用来判断：
- 模板是否已经成功分发到需要承载沙箱的节点
- 是否存在某些节点始终没有拿到模板副本
- 是否出现部分节点 READY、部分节点 FAILED 的不一致情况
如果你需要从节点视角继续确认，可以再跳转到 节点与容量。
如果你需要从总览视角快速确认失败模板、构建状态和管理 API 连通性，也可以先查看 可观测性（Observability）。
什么时候重建模板
当出现下面这些情况时，可以考虑在模板详情页发起重建：
- 基础镜像已经更新
- 你修改了模板创建参数
- 构建过程曾经失败，但环境问题已排除
- 你怀疑当前模板副本或构建产物不一致
重建期间，Dashboard 通常会展示构建状态和日志轮询结果。若构建长期没有推进，建议结合 CLI 与运维日志继续排查。
什么时候删除模板
删除模板通常适用于以下场景：
- 模板构建失败，且已经确定不再继续修复
- 某个模板已经废弃，不再希望被用于创建新沙箱
- 你想清理测试模板，减少管理成本
删除前建议确认：
- 当前没有关键业务还依赖该模板创建新实例
- 你已经保留了必要的模板参数和镜像来源信息
与 CLI 模板文档的关系
Dashboard 适合图形化管理模板，但并不替代 CLI。
以下场景仍建议结合 CLI：
- 精确查看模板原始请求体
- 预览最终生效的创建请求
- 更细致地调试模板构建参数
相关文档：
常见操作建议
新装环境后的第一件事
先创建至少一个基础模板，并等待状态变为 READY。
如果你想尽量少填参数，推荐先从 模板商店（Template Store） 安装官方模板，再回到本页查看状态和详情。
模板很多时怎么排查
先关注 FAILED 或长期 BUILDING 的模板，再查看是否已有足够数量的 READY 模板支撑业务。
如果你想先看失败模板清单，再决定进入哪个模板详情页，可先从 可观测性（Observability） 开始。
如果你已经确认是模板构建链路异常（长期 BUILDING 或 FAILED），建议直接进入 模板构建排障。
如果模板本身已经 READY，但副本分发和节点本地状态不一致，建议继续查看 模板分发与副本一致性排障。
什么时候进入沙箱页
当模板已经 READY 后，就可以转到 沙箱管理 创建和验证第一个沙箱。
什么时候进入网络页
当模板本身没有问题，但你怀疑是出网策略、网络类型或节点配额影响了实例行为时，请查看 网络（Network）。
什么时候进入排障页
当你在模板详情页看到构建长期停滞、失败反复出现，且暂时无法从参数层面定位原因时，请查看 模板构建排障。
当你看到部分节点有副本、部分节点无副本，或实例只在个别节点能拉起时，请查看 模板分发与副本一致性排障。