跳到主要内容

常见问题

本文收集安装与使用 SupKube 时最容易让人困惑的现象,多数是"功能确实存在,但边界与预期不一致",而不是故障。

新建备份/策略返回 HTTP 402,提示许可证相关错误?​

新安装的 SupKube 默认没有任何许可证(状态为 missing),此时创建备份、创建策略、手动触发一次策略都会被拒绝。这不影响查看数据、发起还原、使用一键快照。请参考安装许可证完成许可证安装。

创建存储位置时找不到 GCS(Google Cloud Storage)选项?​

当前版本的对象存储创建接口只接受 aws(S3 协议兼容,含 MinIO)与 azure 两种 provider;界面上会看到 GCP 选项但标记为规划中并禁用。卷快照位置(VSL)不受此限制,可以配置 gcp 作为快照 provider(前提是集群已安装对应 CSI 驱动)。

配置 Azure 存储位置时只能填 Storage Account Key,找不到"用服务主体登录"的选项?​

目前 Azure BSL 只支持 Storage Account Key 认证;基于 Azure AD 服务主体的认证方式尚未实现。

侧边栏里没有单独的"还原"菜单,还原功能是不是被删除了?​

没有被删除。/restores 这个路由目前会被重定向到 Observability 页面的活动标签,发起还原的入口在 Backups(备份)页面对某条记录的行操作菜单里,会打开一个还原抽屉。

把 SupKube 装到了 supkube 以外的命名空间,许可证/多集群/审计日志都不工作?​

许可证消费端、多集群注册表、基于 Kubernetes 事件的审计记录这三个子系统的命名空间在代码里是硬编码的字面量 supkube,不会跟随您实际选择的 Helm 发布命名空间变化。请始终使用 -n supkube 安装。详见核心组件。

跨存储位置复制(Backup Copy)预检通过了,点执行却报错?​

POST /api/v1/backup-copy 当前版本会直接返回 501 Not Implemented——真正"搬运字节"的执行逻辑尚未交付,只有预检(列出哪些备份可以复制)已经可用。详见备份与还原操作。

Backups 页面的"导出"批量操作点不动?​

这个按钮当前处于禁用状态,界面上标注为"即将推出",不是权限或数据问题。

日志查看器(Log Viewer)看起来不是实时滚动的?​

目前是客户端每 5 秒轮询刷新一次,不是服务端推送的流式 tail。网络较差或日志量大时会有明显延迟感,属已知限制。

Settings → 插件管理页面给出的 helm upgrade 命令执行后报错找不到 Release?​

该页面展示的命令里,Release 名称与命名空间当前是写死的 supkube/supkube,不会读取您实际使用的 Helm Release 名称。如果您安装时没有用 supkube 作为 Release 名,请自行把命令中的名称替换成实际值。

Dashboard 的 DR Topology 图看起来只有部分节点有数据?​

图上完整展示的是"本地 BSL / 云端 BSL 两类存储位置"以及一个 3-2-1-1-0 合规评分;更细粒度的分层节点仍在完善中,暂时不代表独立的实时数据管道。

默认演示登录账号

内置 Dex 默认附带一个演示账号(admin@supkube.local / admin)。生产环境部署后请务必接入真实身份提供方并清空/更换该账号,否则任何知道这个默认凭据的人都能以管理员身份登录。详见认证配置。

验证方法​

以上每一条现象都附带了对应的确认命令或界面路径;按对应小节操作后如果现象仍未消失,请参考故障排查生成诊断包再联系支持。

相关文档​