版本兼容矩阵（Version Compatibility Matrix）
本页回答两个问题：你的 Kubernetes 版本是否在 Kuboard 支持范围内？在该版本下，哪些能力与界面行为与其它版本不同？
支持范围总览
| 项目 | 数值 | 说明 |
|---|---|---|
| 最低支持版本 | v1.15 | 低于该版本不保证各能力判定正确 |
| 当前覆盖到 | v1.34 | 最新一条能力分界在 v1.34（ReadWriteOncePod） |
| 版本判定粒度 | 主版本号.次版本号 | 如 v1.31.2 按 1.31 判定，patch 版本不影响能力分界 |
| 持续支持 | 版本只增不减 | 无版本上限，各能力只在自己引入/移除的分界上变化 |
安装前确认版本
安装 Kuboard 前请确认集群版本不低于 v1.15，安装步骤见 安装 Kuboard。接入集群后，集群列表页可看到 Kuboard 探测到的 Kubernetes 版本。
能力 × 版本矩阵
接入集群时，Kuboard 读取集群的 Kubernetes 版本号，只比较主版本号与次版本号，据此在下表中查找各能力的取值；集群版本高于 v1.34 时按最新一列（≥1.34）处理。单元格含义：
v1/v1beta1/websocket等 → 该能力在此版本段使用的 API 版本或取值✓/✗→ 可用 / 不可用- 单元格内如「自 1.23 起」表示该列内部还有更细的分界
| 能力（capability） | <1.16 | 1.16–1.20 | 1.21–1.24 | 1.25–1.29 | 1.30–1.31 | 1.32–1.33 | ≥1.34 | 影响 Kuboard 的哪个界面/功能 |
|---|---|---|---|---|---|---|---|---|
驱逐 Eviction（policy.eviction） | v1beta1 | v1beta1 | v1beta1 | v1 | v1 | v1 | v1 | 节点排空（Drain）、Pod 驱逐操作；<1.25 时驱逐请求走 v1beta1 |
调试容器（pod.ephemeralContainer） | ✗ | ✗ | 自 1.23 起 ✓ | ✓ | ✓ | ✓ | ✓ | 向运行中的 Pod 注入调试容器（Debug Container） |
服务端点 EndpointSlice（discovery.k8s.io.endpointslice） | 无，降级 v1/endpoints | 无，降级 v1/endpoints | discovery.k8s.io/v1 | discovery.k8s.io/v1 | discovery.k8s.io/v1 | discovery.k8s.io/v1 | discovery.k8s.io/v1 | 服务/端点列表的数据来源；<1.21 回退到 v1/endpoints |
节点/Pod 指标（metrics.k8s.io.node / .pod） | v1beta1 | v1beta1 | v1beta1 | v1beta1 | v1beta1 | v1beta1 | v1beta1 | 节点/Pod 指标曲线、HPA 指标源；metrics.k8s.io 至今未 GA，全版本走 v1beta1 |
FlowControl 限流（flowcontrol.flowschemas） | v1beta2 | v1beta2 | v1beta2 | v1beta2 | v1 | v1 | v1 | FlowSchema / PriorityLevelConfiguration 资源页的创建与展示；<1.30 的老集群中该 API 可能不存在，以集群探测为准 |
端口转发协议（portforward.protocol） | spdy | spdy | spdy | spdy | spdy | websocket | websocket | 终端 / 端口转发通道使用的协议；≥1.32 为 websocket（依赖 PortForwardWebsockets FeatureGate，最终以探测为准） |
内置 Helm 版本（helm.binary） | helm-3.13 | helm-3.13 | helm-3.13 | helm-3.16 | helm-3.18 | helm-3.18 | helm-3.18 | 应用商店 / Helm 安装、升级、回滚时实际调用的 helm 客户端二进制版本 |
DRA 动态资源分配（dra.enabled） | ✗ | ✗ | ✗ | 自 1.28 起 ✓ | ✓ | ✓ | ✓ | ResourceClaim / ResourceClaimTemplate / ResourceSlice 等 DRA 资源入口与编辑 |
PodSchedulingReadiness（scheduling.podschedulingreadiness） | ✗ | ✗ | ✗ | 自 1.26 起 ✓ | ✗ | ✗ | ✗ | PodSchedulingReadiness 资源页（需同时满足 DRA 能力才显示）；K8s 上游 1.26 引入、1.30 移除，本表与其一致 |
ValidatingAdmissionPolicy（admission.vap.enabled） | ✗ | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ValidatingAdmissionPolicy 及其绑定资源页 |
RuntimeClass 调度（runtimeclass.scheduling.ga） | ✗ | ✗ | ✗ | 自 1.27 起 ✓ | ✓ | ✓ | ✓ | RuntimeClass 资源页中的调度相关字段/能力 |
PVC 访问模式 ReadWriteOncePod（storage.readWriteOncePod） | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ | PVC / PV 编辑中的访问模式选项 |
Pod 安全准入 PSA（admission.psa） | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | Pod 安全策略相关界面（PSA/PSS 标签配置等） |
CRD API 版本（apiextensions.crd.v1） | v1beta1 | v1 | v1 | v1 | v1 | v1 | v1 | Kuboard 内置/插件 CRD 的创建与自定义资源表单使用的 apiVersion |
Service appProtocol（service.appProtocol） | ✗ | 自 1.20 起 ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Service 编辑中的 appProtocol（应用层协议）字段 |
metrics-server 版本（metrics.serverVersion） | v1beta1 | v1beta1 | v1beta1 | v1beta1 | v1beta1 | v1beta1 | v1beta1 | 节点 / Pod 实时用量指标的数据源版本，始终为 metrics.k8s.io/v1beta1 |
NetworkPolicy ipBlock except（networkpolicy.ipBlockExceptCidrs） | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | NetworkPolicy 规则编辑中的 ipBlock except CIDR 列表 |
终端关闭帧协议（terminal.protocol.closeFrame） | ✗ | ✗ | ✗ | 自 1.29 起 ✓ | ✓ | ✓ | ✓ | Web 终端断开时的 WebSocket 关闭帧行为：<1.29 由 Kuboard 主动发关闭帧，≥1.29 由 K8s 主动发关闭帧 |
Prometheus 工具（prometheus.installed） | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | MCP Prometheus 工具（prometheus_query 等）的可见性；任何版本均视为可安装，是否真的可用以服务发现探测为准 |
与 PSP（PodSecurityPolicy）的关系
PSP 自 Kubernetes 1.25 起被上游移除，由 Pod 安全准入（PSA）替代。因此 PSA 能力（矩阵中 admission.psa 一行）自 1.25 起才可用。
拿不准时的判断依据
矩阵给出的是按版本号的默认判定。以下情况请以 集群能力探测 的实际结果为准：
- 老版本集群上某些 API 组可能整体不存在（如 1.15 上没有 FlowControl），此时能力按矩阵中对应的旧值处理
- 依赖 FeatureGate 的能力（如端口转发 websocket/spdy）在集群未启用对应 FeatureGate 时，可能与表内默认值不同
- 依赖集群外部组件的「能力」（如 Prometheus 是否安装）需通过服务发现确认，而不是看版本号
旧版本缺失能力提示
按版本段归纳，便于排障时快速定位「哪个界面功能在当前版本下不可用」：
- < 1.16：CRD 仅
apiextensions.k8s.io/v1beta1；无调试容器；无 EndpointSlice（服务端点走v1/endpoints）；无 Service appProtocol 字段。 - < 1.21：无 EndpointSlice，服务/端点列表降级到
v1/endpoints。 - < 1.23：无调试容器注入。
- < 1.25：驱逐走
policy/v1beta1；无 PSA（Pod 安全准入）；NetworkPolicy 无ipBlock.except；内置 Helm 为 3.13。 - < 1.27：RuntimeClass 调度相关能力不可用。
- < 1.28：DRA 相关资源入口隐藏。
- < 1.29：终端关闭帧由 Kuboard 主动发送（与 ≥1.29 集群的交互行为有差异）。
- < 1.30：FlowControl 走
v1beta2；ValidatingAdmissionPolicy 不可用；PodSchedulingReadiness 自 1.30 起变为不可用（K8s 上游移除）。 - < 1.32：端口转发/终端走 SPDY 协议。
- < 1.34：PVC 访问模式无 ReadWriteOncePod 选项。