Dashboard / 代理入口排障

本页用于处理以下问题：

• Dashboard 完全打不开
• Dashboard 能打开，但按钮操作持续报错
• cube.app 域名不通或入口不稳定
• Web 页面和 API 健康检查表现不一致

先看总入口：

• 故障排障总览

先做最小入口检查

# Web 入口
curl -I http://127.0.0.1:12088/

# 通过 Web 反代访问管理 API
curl -fsS http://127.0.0.1:12088/cubeapi/v1/health

# 直接访问 API 本体
curl -fsS http://127.0.0.1:3000/health

快速判断：

• 3000 正常、12088 异常：优先排查 WebUI / 反代配置
• 两者都异常：先排查基础服务状态
• 两者都正常但前端操作报错：优先排查鉴权、限流与域名配置

症状一：Dashboard 打不开

优先检查：

1. 12088 端口是否监听
2. Web 相关配置文件是否生成
3. Web 静态资源是否存在

建议参考：

• 日志、健康检查与排障
• 服务管理与日志

症状二：页面可打开，但操作接口报错

常见方向：

• 鉴权配置不匹配
• 网关限流触发
• 域名与入口配置不一致

建议先从 Dashboard 网络与可观测页面做图形化确认，再进入日志：

• 网络（Network）
• 可观测性（Observability）
• 鉴权

症状三：cube.app 域名不通或解析异常

优先检查：

1. CoreDNS 配置是否渲染为当前节点 IP
2. DNS 接管模式与网卡记录是否一致
3. 相关容器是否仍在运行

建议参考：

• HTTPS 证书与域名解析
• 日志、健康检查与排障

症状四：入口间歇性抖动

常见方向：

• 节点资源临界导致代理或控制面响应波动
• API Gateway 限流或并发上限被打满

建议联动查看：

• 网络（Network）
• 节点与容量（Nodes）
• 可观测性（Observability）

推荐排障顺序（入口问题）

1. 先对比 3000 与 12088 的健康表现
2. 再确认鉴权/限流/域名配置
3. 再看服务日志与代理日志
4. 最后再做重启类操作

相关文档

• 故障排障总览
• 部署排障
• Web Dashboard 快速上手
• 网络（Network）
• 可观测性（Observability）
• 鉴权
• HTTPS 证书与域名解析
• 日志、健康检查与排障