K8s系列四：安装 Kuboard – 国产可视化运维工具

🗺️ 系列目录：

K8s系列一：Ubuntu 22.04 从零搭建集群（Flannel + Containerd）
K8s系列二：安装 Dashboard – 原生 Web 控制台配置
K8s系列三：安装 Rancher – 企业级多集群管理平台
K8s系列四：安装 Kuboard – 国产可视化运维工具 👈 当前篇章

📋 文档概述

Kuboard 是一款基于 Kubernetes 的免费、开源图形化管理平台，相较于 Kubernetes Dashboard，它具有以下优势：

界面更友好：中文界面，布局清晰，更符合国内用户习惯
功能更丰富：内置资源监控、日志查看、终端访问等功能
部署更简单：通过 Docker Compose 一键安装，独立于 K8s 集群运行

本文档将使用 Kuboard v4 版本，以独立容器方式部署在您的 Master 节点上。

✅ 适用条件

已有一个正常运行的 K8s 集群（参考本系列第一篇文档）
Master 节点已安装 Docker 和 Docker Compose
所有节点状态为 Ready

kubectl get nodes # 检查所有节点状态

NAME         STATUS   ROLES           AGE   VERSION
k8s-master   Ready    control-plane   5h    v1.28.15
k8s-node1    Ready    <none>          5h    v1.28.15
k8s-node2    Ready    <none>          5h    v1.28.15

一、安装原理说明

Kuboard v4 采用独立部署模式，与 K8s 集群本身集成：

数据库容器：使用 MariaDB 存储 Kuboard 的配置数据
Kuboard 容器：主程序容器，通过 8000 端口提供 Web 服务
网络：两个容器通过内部网络通信

这种架构的好处是：即使 K8s 集群出现故障，管理平台依然可用。

二、安装 Kuboard v4

2.1 创建安装目录并进入

mkdir -p ~/kuboard-v4 && cd ~/kuboard-v4

2.2 创建 docker-compose.yaml 配置文件

cat > docker-compose.yaml << 'EOF'
services:
  db:
    image: swr.cn-east-2.myhuaweicloud.com/kuboard/mariadb:11.3.2-jammy
    environment:
      MARIADB_ROOT_PASSWORD: kuboardpwd
      MARIADB_DATABASE: kuboard
      MARIADB_USER: kuboard
      MARIADB_PASSWORD: kuboardpwd
      TZ: Asia/Shanghai
    volumes:
      - ./kuboard-mariadb-data:/var/lib/mysql
    networks:
      - kuboard_v4_dev
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      timeout: 10s
      retries: 10

  kuboard:
    image: swr.cn-east-2.myhuaweicloud.com/kuboard/kuboard:v4
    environment:
      - DB_DRIVER=org.mariadb.jdbc.Driver
      - DB_URL=jdbc:mariadb://db:3306/kuboard?serverTimezone=Asia/Shanghai
      - DB_USERNAME=kuboard
      - DB_PASSWORD=kuboardpwd
    ports:
      - "8000:80"
    volumes:
      - ./kuboard-log:/app/logs
    depends_on:
      db:
        condition: service_healthy
    networks:
      - kuboard_v4_dev

networks:
  kuboard_v4_dev:
    driver: bridge
EOF

2.3 启动服务

# 启动所有容器（后台运行）
docker compose up -d

# 查看启动日志（按 Ctrl+C 退出日志查看，容器继续运行）
docker compose logs -f

# 查看容器运行状态
docker compose ps

预期输出：两个容器状态均为 Up

三、访问 Kuboard 控制台

3.1 浏览器访问

http://<服务器IP>:8000

#初始账号和密码
用户名：admin
密码：Kuboard123

3.2 首次登录操作

修改密码：首次登录后请立即修改 admin 密码
创建普通用户（可选）：根据需要创建其他用户并授权
导入 K8s 集群：按照界面指引导入 K8s 集群

四、导入 Kubernetes 集群

4.1 获取集群访问凭证

在 Kuboard 界面中添加集群时，需要提供 K8s 的访问凭证。在 Master 节点执行：

# 查看当前集群的 kubeconfig，需要复制config的所有内容
cat ~/.kube/config

4.2 在 Kuboard 中添加集群

点击左上角菜单 → 集群管理
点击 “添加集群” 按钮
填写集群名称（如 k8s-master）
选择 “kubeconfig” 方式
将 ~/.kube/config 的内容粘贴进去
点击 “保存”

等待几秒钟，集群状态变为 “健康” 即可开始管理。

五、Kuboard 常用功能导览

5.1 工作负载管理

Deployment：查看、创建、扩缩容
StatefulSet：有状态应用管理
DaemonSet：守护进程集管理
Pod：查看日志、进入容器终端

5.2 网络管理

Service：服务暴露配置
Ingress：域名访问配置

5.3 配置管理

ConfigMap：配置信息管理
Secret：敏感信息管理

5.4 存储管理

PVC：持久卷声明
StorageClass：存储类配置