1. Kuboard 是什么？为什么选择它？
Kuboard 是一款开源的 Kubernetes 多集群管理面板，专为简化 K8s 日常运维工作而设计。作为一个长期从事云原生开发的工程师，我最初接触 Kuboard 是因为团队需要同时管理多个测试和生产环境的 K8s 集群。传统命令行方式 kubectl 虽然强大，但在以下场景中显得力不从心：
- 新成员需要快速了解集群状态时
- 需要批量操作多个命名空间下的资源时
- 排查跨服务问题时需要直观的拓扑关系图
- 非运维人员也需要有限度的集群访问权限
Kuboard 的独特价值在于：
- 零侵入架构：不需要在集群中安装任何 Agent，通过 KubeConfig 直接连接
- 多集群同屏管理：单个界面可同时操作多个集群，这在管理测试/预发/生产环境时特别有用
- 可视化拓扑：自动生成应用依赖关系图，这在微服务架构下排查问题时节省了大量时间
- RBAC 集成：与 Kubernetes 原生权限系统无缝对接，可以精细控制每个用户的可见范围
提示：与 Rancher 等重量级平台相比，Kuboard 更适合中小团队快速上手，对资源占用极低（仅需 500MB 内存即可运行）
2. 安装前的环境准备
2.1 硬件与网络要求
虽然 Kuboard 本身很轻量，但为了获得流畅的操作体验，建议满足以下条件：
管理端机器：
- 最低配置：1核CPU / 1GB内存 / 20GB磁盘
- 推荐配置：2核CPU / 2GB内存（如果同时管理超过5个集群）
- 操作系统：Linux（CentOS 7+，Ubuntu 18.04+）或 Windows Server 2016+
网络要求：
- 管理机器需要能访问所有K8s集群的API Server
- 如果集群API Server有防火墙限制，需要放行管理机器的IP
- 浏览器到Kuboard服务的网络延迟应 < 100ms
2.2 获取必要的访问凭证
安装前请确保准备好：
- 至少一个K8s集群的kubeconfig文件（通常位于~/.kube/config）
- 集群管理员权限（至少需要cluster-admin角色）
- 如果使用HTTPS，需要准备好域名和SSL证书
3. 三种安装方式详解
3.1 最简Docker安装（适合快速体验）
docker run -d \ --restart=unless-stopped \ --name=kuboard \ -p 80:80/tcp \ -p 10081:10081/tcp \ -e KUBOARD_ENDPOINT="http://你的服务器IP:80" \ -e KUBOARD_AGENT_SERVER_TCP_PORT="10081" \ -v /root/kuboard-data:/data \ eipwork/kuboard:v3关键参数说明：
KUBOARD_ENDPOINT：浏览器访问的地址，如果是云服务器请用公网IP10081端口：用于Kuboard Agent的连接，确保防火墙放行/root/kuboard-data：持久化存储位置，建议改为合适的路径
安装后访问http://你的服务器IP，初始用户名/密码都是admin
3.2 Kubernetes集群内安装（生产推荐）
# kuboard.yaml apiVersion: apps/v1 kind: Deployment metadata: name: kuboard namespace: kube-system spec: replicas: 1 selector: matchLabels: app: kuboard template: metadata: labels: app: kuboard spec: containers: - name: kuboard image: eipwork/kuboard:v3 ports: - containerPort: 80 env: - name: KUBOARD_ENDPOINT value: "https://kuboard.yourdomain.com" volumeMounts: - mountPath: /data name: data volumes: - name: data persistentVolumeClaim: claimName: kuboard-data --- apiVersion: v1 kind: Service metadata: name: kuboard namespace: kube-system spec: ports: - port: 80 targetPort: 80 selector: app: kuboard应用配置：
kubectl apply -f kuboard.yaml注意：生产环境强烈建议配置Ingress和HTTPS，参考以下Nginx Ingress配置片段：
annotations: nginx.ingress.kubernetes.io/proxy-body-size: "512m" nginx.ingress.kubernetes.io/proxy-read-timeout: "3600" nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"
3.3 裸机安装（适合无Docker环境）
- 下载最新版本：
wget https://kuboard.cn/download/v3/linux -O kuboard chmod +x kuboard- 创建systemd服务：
# /etc/systemd/system/kuboard.service [Unit] Description=Kuboard Service After=network.target [Service] ExecStart=/usr/local/bin/kuboard \ --listen-port=80 \ --agent-server-port=10081 \ --data-dir=/var/lib/kuboard Restart=always User=root [Install] WantedBy=multi-user.target- 启动服务：
systemctl daemon-reload systemctl enable --now kuboard4. 关键配置详解
4.1 集群连接配置
首次登录后，按以下步骤添加集群：
- 点击左上角"集群" → "添加集群"
- 上传kubeconfig文件或直接粘贴内容
- 设置集群显示名称（如"生产集群-北京"）
- 高级选项中建议：
- 开启"自动缓存资源"加速加载
- 设置"刷新间隔"为300秒（生产环境不宜过频）
- 关闭"显示系统命名空间"（避免混乱）
4.2 权限配置最佳实践
基于角色的访问控制建议方案：
| 角色类型 | 权限范围 | 适用人员 | 配置方法 |
|---|---|---|---|
| 观察者 | 只读所有命名空间 | 测试人员 | 绑定cluster-reader ClusterRole |
| 开发者 | 读写特定命名空间 | 开发工程师 | 创建有限制的RoleBinding |
| 命名空间管理员 | 完全控制指定命名空间 | 团队负责人 | 绑定admin ClusterRole到命名空间 |
| 集群管理员 | 完全控制集群 | 运维工程师 | 使用cluster-admin |
配置示例（限制开发团队只能访问dev命名空间）：
kubectl create rolebinding dev-team \ --namespace=dev \ --clusterrole=edit \ --group=dev-team4.3 监控与告警集成
Kuboard 原生支持 Prometheus 指标展示：
- 确保集群已安装 Prometheus Operator
- 在集群设置 → 监控配置中：
- 填写Prometheus的Service地址（如：http://prometheus-operated.monitoring:9090）
- 设置CPU/内存的告警阈值（建议：CPU > 70%持续5分钟，内存 > 80%）
- 开启"节点监控"和"工作负载监控"
5. 日常使用技巧
5.1 快速故障排查三板斧
事件时间线：
- 进入问题Pod → "事件"标签页
- 重点关注"Warning"级别事件
- 时间排序快速定位最近变更
实时日志追踪：
# 在Pod页面点击"终端"按钮 # 快速执行以下命令： tail -n 100 /var/log/app/error.log kubectl describe pod <pod-name> | grep -A 10 Events资源拓扑图：
- 进入应用所在命名空间
- 点击"拓扑图"按钮
- 红色高亮表示异常服务节点
5.2 批量操作技巧
跨命名空间搜索：
- 顶部搜索栏输入
kind:pod status:running - 支持的类型：pod, deployment, service等
- 支持的状态：running, pending, failed
- 顶部搜索栏输入
YAML快速编辑：
- 在资源详情页点击"编辑YAML"
- 开启"差异对比"功能（右上角开关）
- 修改后会自动显示与当前版本的差异
资源快速克隆：
- 在Deployment列表页
- 右键点击目标Deployment → "克隆"
- 修改名称和镜像版本即可创建新版本
6. 常见问题解决方案
6.1 连接集群超时
现象：添加集群后显示"连接失败"
排查步骤：
- 检查kubeconfig是否正确：
kubectl --kubeconfig=/path/to/config get nodes - 验证网络连通性：
curl -k https://<api-server>:6443 - 如果是自签名证书，需要在Kuboard高级设置中：
- 关闭"验证TLS证书"
- 或上传CA证书
6.2 监控数据不显示
可能原因：
- Prometheus服务地址配置错误
- ServiceMonitor未正确配置
- 资源用量指标未启用
解决方案：
确认Prometheus可以访问：
kubectl port-forward svc/prometheus-operated 9090 -n monitoring然后访问 localhost:9090/targets 查看采集状态
为工作负载添加注解：
annotations: prometheus.io/scrape: "true" prometheus.io/port: "8080"
6.3 性能优化建议
症状：界面加载缓慢
优化方案：
调整缓存策略：
- 进入"系统设置" → "高级"
- 设置"资源缓存时间"为600秒
- 关闭不需要的实时刷新
数据库优化：
# 如果使用内置数据库 docker exec kuboard find /data/db -type f -name '*.wt' -exec ls -lh {} \; # 大于100MB的文件考虑清理历史数据前端优化：
- 禁用不需要的仪表盘小组件
- 减少同时打开的集群数量
