KubeVision

核心功能

从自然语言调查到受控执行的完整 Kubernetes 工作流

AI 运维工作区

结合实时页面上下文调查资源和日志，并在明确批准后执行受 RBAC 控制的操作。

⚡

实时同步

Informer Watch → WebSocket 推送，亚秒级更新至所有客户端，零轮询开销。

🌐

多集群管理

在单一面板管理所有集群，并可即时切换上下文。

💻

终端 & 日志

完整的 Pod 终端，支持会话录制与回放。实时日志流，支持搜索和过滤。

🔒

企业级安全

五级 RBAC、TOTP 双因素认证、审计日志、Secrets 脱敏、即时 Token 吊销。

🗺️

资源拓扑

可视化所属关系图，展示 Deployment、ReplicaSet、Pod、Service 等资源间的关联。

架构设计

清晰分层设计，实时数据流

                    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。

人机协同

运维安全边界

使用 AI 的同时保留权限边界和操作责任

受控 AI 操作

AI 工具继承用户 RBAC，修改操作等待确认，执行时重新授权，并生成审计记录。

🔐

双因素认证 (TOTP)

二维码设置 + 恢复码，管理员可强制用户启用。

🔬

Dry-Run 变更预览

应用前预览每一处变更。API Server 校验 YAML 并展示并排 Diff。

🎬

终端录制

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

# Temporarily access the dashboard from this machine
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