Skip to content

快速开始

本节带你在 5 分钟内把 CKMAN 跑起来,并导入第一个 ClickHouse 集群。

前置准备

  • 一台 Linux 服务器(CentOS 7+ / Ubuntu 18+ / RHEL 8+)
  • 已有一套可访问的 ClickHouse 集群(IP 可达、知道 default 用户密码)
  • 可选:ZooKeeper 集群(如果你要用分布式表)

安装 CKMAN

安装方式

CKMAN 提供 tar.gzrpmdeb 三种发行包,根据你的系统选一种。

使用 tar.gz

bash
wget https://github.com/housepower/ckman/releases/download/v3.x.x/ckman-3.x.x.Linux.x86_64.tar.gz
tar -xzvf ckman-3.x.x.Linux.x86_64.tar.gz
cd ckman-3.x.x.Linux.x86_64
./bin/start

使用 RPM

bash
sudo rpm -ivh ckman-3.x.x.x86_64.rpm
sudo systemctl start ckman
sudo systemctl enable ckman

使用 DEB

bash
sudo dpkg -i ckman_3.x.x_amd64.deb
sudo systemctl start ckman

访问 Web 界面

打开浏览器访问 http://<ckman-host>:8808,使用默认账号登录:

字段默认值
用户名ckman
密码Ckman123456!

首次登录后请修改密码

登录后请在「用户管理 → 修改密码」中立刻替换默认密码。

导入第一个集群

如果你已经有一套运行中的 ClickHouse 集群,使用导入集群最快:

  1. 顶部导航点击「集群列表」→「导入集群」
  2. 填写集群信息:
    • 集群名称:在 CKMAN 中唯一标识
    • CK 用户名 / 密码:default 用户或自定义用户
    • TCP 端口:默认 9000
    • 节点 IP:每个 shard 的副本列表
    • ZooKeeper 节点:如使用分布式表
  3. 点击「确定」,CKMAN 会试连每个节点,全部连通即导入成功

下一步

集群导入后,你可以:

  • 在「监控管理」查看集群整体健康度
  • 在「表管理」创建分布式表
  • 在「Query 管理」执行在线 SQL
  • 在「用户权限管理」给团队成员分配只读 / 普通 / 管理员账号

更多细节参考功能介绍章节。

基于 Apache 2.0 协议发布