核心功能
大规模管理 Kubernetes 集群所需的一切
实时同步
Informer Watch → WebSocket 推送，亚秒级更新至所有客户端，零轮询开销。
多集群管理
在单一面板管理所有集群。即时切换上下文，跨环境对比资源。
终端 & 日志
完整的 Pod 终端，支持会话录制与回放。实时日志流，支持搜索和过滤。
企业级安全
五级 RBAC、TOTP 双因素认证、审计日志、Secrets 脱敏、即时 Token 吊销。
资源拓扑
可视化所属关系图，展示 Deployment、ReplicaSet、Pod、Service 等资源间的关联。
全局搜索
Cmd+K 模糊搜索，横跨所有集群、命名空间和资源类型，毫秒级响应。
架构设计
清晰分层设计，实时数据流
Browser
┌────────┴────────┐
REST WebSocket
│ │
┌───────────▼─────────────────▼──────────────┐
│ Middleware: RequestID → Logger → Auth │
│ │
│ Handler ──→ Service ──→ K8sRepo │
│ │ │
│ ┌──────────┴──────────┐ │
│ │ │ │
│ Informer Cache API Server │
│ │ │
│ Informer Watch ──→ EventListener │
│ │ │
│ WS Hub ──→ Browser │
│ │
│ DB: SQLite (dev) / PostgreSQL (prod) │
└─────────────────────────────────────────────┘
📖 读取路径
Informer 缓存优先，亚毫秒响应。缓存未命中时自动降级到 API Server。8 种核心资源缓存，18+ 种按需查询。
✏️ 写入路径
API Server 校验 → Informer 检测变更 → EventListener 触发 → WS Hub 广播 → 所有浏览器即时更新。
🔌 可扩展性
新增资源类型只需后端注册表 1 行 Go + 前端 1 段配置。CRD 运行时自动发现。插件系统支持 Prometheus、Grafana、ArgoCD。
独特功能
其他 Kubernetes 面板均未提供的功能
双因素认证 (TOTP)
二维码设置 + 恢复码，管理员可强制全员启用。所有竞品均不支持。
Dry-Run 变更预览
应用前预览每一处变更。API Server 校验 YAML 并展示并排 Diff。
跨集群对比
在不同集群或环境间对比同一资源，使用 Monaco Diff Editor 即时发现配置漂移。
终端录制
Pod/Node 终端操作全程以 asciinema 格式录制，管理员可回放审查与培训。
kubectl 命令提示
每个 UI 操作都显示等效的 kubectl 命令。边用面板边学 Kubernetes CLI。
Secrets 脱敏
所有视图中 Secrets 默认脱敏，需主动操作才能显示明文，杜绝意外泄露。
快速开始
5 分钟内完成部署
- Helm
- Docker
- Development
# Add the KubeVision Helm repository
helm repo add kubevision https://kubevision.github.io/charts
helm repo update
# Install KubeVision
helm install kubevision gocronx/kubevision
# Access the dashboard
kubectl port-forward svc/kubevision 8080:8080
open http://localhost:8080
# Build and run with Docker
docker build -f deploy/Dockerfile -t kubevision:latest .
docker run -p 8080:8080 \
-v ~/.kube/config:/root/.kube/config:ro \
kubevision:latest
# Open http://localhost:8080
# Default login: admin / admin123
git clone https://github.com/gocronx/kubevision.git
cd kubevision
# Backend — starts on :8080
go mod tidy && make dev
# Frontend — starts on :5173, proxies /api → :8080
cd web && pnpm install && pnpm dev
对比一览
KubeVision 与主流 Kubernetes 面板对比
| 功能 | KubeVision | Headlamp | K9s | Kuboard |
|---|---|---|---|---|
| Multi-cluster | ✓ | ✓ | ✓ | ✓ |
| 2FA (TOTP) | ✓ | — | — | — |
| Dry-Run Diff | ✓ | — | — | — |
| Cross-cluster Diff | ✓ | — | — | — |
| Terminal Recording | ✓ | — | — | — |
| Secrets Masking | ✓ | — | — | — |
| kubectl Hints | ✓ | — | — | — |
| Audit Logging | ✓ | — | — | ✓ |
| Resource Topology | ✓ | ✓ | ✓ | ✓ |
| Real-time WebSocket | ✓ | ✓ | ✓ | ✓ |
| Global Search | ✓ | ✓ | ✓ | — |
| Plugin System | ✓ | ✓ | ✓ | — |
| Dark Mode | ✓ | ✓ | ✓ | — |
| i18n | ✓ | ✓ | — | ✓ |