欢迎使用 KubePolaris

KubePolaris（北辰）是一个开源的企业级 Kubernetes 多集群管理平台，致力于简化 Kubernetes 的日常运维和管理工作，让团队能够更专注于业务创新。

「北辰」取自《论语》：「为政以德，譬如北辰，居其所而众星共之。」寓意 KubePolaris 作为 Kubernetes 集群管理的核心枢纽，统一管理、协调各个集群。

✨ 核心特性

🌐 多集群统一管理

• 集中管理 - 一个控制台管理所有 Kubernetes 集群
• 跨云支持 - 支持公有云、私有云、混合云、边缘集群
• 统一视图 - 跨集群的资源搜索和查看

📊 可视化工作负载管理

• 直观界面 - 可视化展示 Deployment、StatefulSet、DaemonSet 等
• YAML 编辑 - 内置 Monaco Editor，支持语法高亮和自动补全
• 表单编辑 - 无需编写 YAML，通过表单完成配置

📈 实时监控与告警

• Prometheus 集成 - 实时采集集群和应用指标
• Grafana 面板 - 内嵌监控大盘，无需切换
• 智能告警 - AlertManager 集成，多渠道告警通知

💻 Web 终端

• Pod 终端 - 直接在浏览器中连接 Pod 容器
• SSH 终端 - 无需本地工具，直接 SSH 到节点
• Kubectl 终端 - 在线执行 kubectl 命令

🔐 细粒度权限控制

• RBAC 管理 - 基于角色的访问控制
• 自定义角色 - 支持创建自定义权限角色
• 资源级控制 - 精确到集群、命名空间、资源类型

🔄 GitOps 集成

• ArgoCD 集成 - 支持 GitOps 工作流
• 应用管理 - 可视化管理 ArgoCD Applications
• 同步状态 - 实时查看同步状态和健康状态

📝 日志中心

• 实时日志 - Pod 日志实时查看
• 日志聚合 - 多 Pod 日志聚合展示
• 日志下载 - 支持日志导出下载

🔍 全局搜索

• 跨集群搜索 - 一键搜索所有集群资源
• 智能过滤 - 支持按资源类型、命名空间过滤
• 快捷跳转 - 搜索结果直达详情页

🏗️ 技术架构

┌─────────────────────────────────────────────────────────────┐
│                        Web Browser                          │
│                    (React + TypeScript)                     │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                     KubePolaris Backend                      │
│                      (Go + Gin + GORM)                       │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────────────┐ │
│  │  Auth   │  │  API    │  │ WebSock │  │    Services     │ │
│  │ Handler │  │ Handler │  │ Handler │  │ (K8s/Prom/Git)  │ │
│  └─────────┘  └─────────┘  └─────────┘  └─────────────────┘ │
└────────────────────────────────┬────────────────────────────┘
                                 │
          ┌──────────────────────┼──────────────────────┐
          ▼                      ▼                      ▼
   ┌────────────┐         ┌────────────┐         ┌────────────┐
   │   MySQL    │         │ Kubernetes │         │ Prometheus │
   │  Database  │         │  Clusters  │         │  / Grafana │
   └────────────┘         └────────────┘         └────────────┘

🚀 快速开始

使用 Docker Compose

# 克隆仓库
git clone https://github.com/clay-wangzhi/KubePolaris.git
cd kubepolaris

# 启动服务
docker-compose up -d

# 访问 http://localhost:8080

使用 Helm

# 添加 Helm 仓库
helm repo add kubepolaris https://kubepolaris.github.io/charts

# 安装
helm install kubepolaris kubepolaris/kubepolaris \
  -n kubepolaris --create-namespace

详细安装说明请查看 安装指南。

📖 文档导航

文档	说明
快速开始	5 分钟快速体验
安装指南	详细安装部署说明
用户指南	功能使用说明
管理员指南	运维管理指南
常见问题	FAQ 解答

🤝 参与贡献

我们欢迎所有形式的贡献，包括但不限于：

• 🐛 提交 Bug 报告
• 💡 提出新功能建议
• 📝 完善文档
• 🔧 提交代码 PR

请查看 贡献指南 了解详情。

📄 开源协议

KubePolaris 采用 Apache License 2.0 开源协议。

🌟 Star History

如果 KubePolaris 对你有帮助，请给我们一个 Star ⭐️