快速开始
本指南将帮助你在 5 分钟内快速体验 KubePolaris 的核心功能。
前置要求
- Docker 20.10+ 和 Docker Compose 2.0+
- 至少一个可用的 Kubernetes 集群（用于导入管理）
- 8GB+ 可用内存
第一步：启动 KubePolaris
使用 Docker Compose 是最快速的体验方式：
# 克隆仓库
git clone https://github.com/clay-wangzhi/KubePolaris.git
cd kubepolaris
# 启动所有服务
docker-compose up -d
等待约 1-2 分钟，所有服务启动完成后，访问：
- Web 界面: http://localhost:8080
- API 文档: http://localhost:8080/api/docs
第二步：登录系统
使用默认管理员账号登录：
| 项目 | 值 |
|---|---|
| 用户名 | admin |
| 密码 | admin123 |
安全提示
首次登录后请立即修改默认密码！
第三步：导入集群
- 点击左侧菜单 集群管理 → 添加集群
- 填写集群信息：
- 集群名称: 为集群起一个易识别的名称
- API Server: Kubernetes API 服务器地址，如
https://192.168.1.100:6443 - 认证方式: 选择
kubeconfig或Token
- 上传 kubeconfig 文件或填写 Token
- 点击 测试连接 验证配置
- 确认无误后点击 保存
示例: kubeconfig 文件
apiVersion: v1
kind: Config
clusters:
- cluster:
certificate-authority-data: <base64-encoded-ca-cert>
server: https://192.168.1.100:6443
name: my-cluster
contexts:
- context:
cluster: my-cluster
user: admin
name: my-cluster
current-context: my-cluster
users:
- name: admin
user:
token: <your-token>
第四步：浏览集群资源
成功导入集群后，你可以：
查看集群总览
在 总览 页面查看：
- 集群资源使用情况（CPU/内存/存储）
- 节点状态分布
- 工作负载概览
- 近期事件
管理工作负载
在 工作负载 页面：
- 查看 Deployment、StatefulSet、DaemonSet 等
- 执行扩缩容操作
- 查看 Pod 状态和日志
- 编辑 YAML 配置
使用 Web 终端
- 进入任意 Pod 详情页
- 点击 终端 按钮
- 选择容器（多容器 Pod）
- 开始在浏览器中操作容器
第五步：配置监控（可选）
KubePolaris 支持集成 Prometheus 和 Grafana：
- 进入 系统设置 → 监控配置
- 填写 Prometheus 地址，如
http://prometheus:9090 - 填写 Grafana 地址，如
http://grafana:3000 - 配置 Grafana API Key（用于嵌入面板）
- 保存配置
配置完成后，你可以在各个资源详情页查看监控图表。
下一步
恭喜你完成了快速开始！接下来你可以：
常见问题
Docker Compose 启动失败
检查端口是否被占用：
# 检查 8080 端口
lsof -i :8080
# 如果被占用，修改 docker-compose.yml 中的端口映射
无法连接到集群
- 确认 API Server 地址可从 KubePolaris 容器访问
- 检查防火墙设置
- 验证 kubeconfig/Token 是否有效
# 在容器内测试连接
docker exec -it kubepolaris-backend curl -k https://your-api-server:6443/healthz
登录后页面空白
清除浏览器缓存后重试：
# 或者使用无痕模式访问
如果问题持续，请查看 故障排查指南 或在 GitHub Issues 提问。