ClickHouse + CH-UI 部署指南

ClickHouse + CH-UI 部署指南（Ubuntu Server 24.04）

本文详细介绍如何在 Ubuntu Server 24.04 上部署 ClickHouse 数据库及 CH-UI 可视化管理界面。

环境信息

项目	说明
操作系统	Ubuntu Server 24.04
数据库	ClickHouse
管理工具	CH-UI（基于 Go 的轻量级 Web 管理界面）

一、ClickHouse 部署

1. 环境准备

首先更新系统并安装必要的基础依赖：

sudo apt update
sudo apt install -y curl apt-transport-https ca-certificates dirmngr

2. 添加 GPG 公钥

导入 ClickHouse 官方 GPG 签名密钥，用于验证软件包的完整性：

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

3. 添加仓库源

将 ClickHouse 官方 APT 仓库添加到系统中：

echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list

4. 更新包列表

添加新仓库后，更新 APT 包索引：

sudo apt update

5. 安装 ClickHouse

安装 ClickHouse 服务端和客户端：

sudo apt install -y clickhouse-server clickhouse-client

6. 启动服务并设置开机自启

sudo systemctl start clickhouse-server    # 启动服务
sudo systemctl enable clickhouse-server   # 设置开机自启
sudo systemctl status clickhouse-server   # 查看运行状态

7. 配置远程访问

编辑 ClickHouse 配置文件，允许外部 IP 访问：

sudo nano /etc/clickhouse-server/config.xml

找到 <listen_host> 配置项，修改为：

<listen_host>0.0.0.0</listen_host>

将监听地址设为 0.0.0.0 表示允许所有 IP 地址访问。生产环境中建议根据实际需求进行限制。

修改完成后重启服务：

sudo systemctl restart clickhouse-server.service

8. 配置用户与权限

编辑用户配置文件：

sudo nano /etc/clickhouse-server/users.xml

在 <users> 节点中添加新用户。以下为配置示例：

<users>
    <default>
        <!-- 数据库默认用户，此处按需配置 -->
    </default>

    <!-- 在 default 用户下方添加自定义用户 -->
    <your_username>
        <password>your_password</password>
        <networks incl="networks" replace="replace">
            <ip>::/0</ip>
        </networks>
        <profile>default</profile>
        <quota>default</quota>
        <access_management>1</access_management>
    </your_username>
</users>

提示：

<password> 支持明文或 SHA256 加密（使用 sha256 标签）

<ip>::/0</ip> 表示允许任意 IPv6/IPv4 地址连接

<access_management>1</access_management> 开启 SQL 驱动的访问控制功能

9. 重启服务使配置生效

sudo systemctl restart clickhouse-server.service

到这一步，ClickHouse 数据库已部署完成，下面开始部署可视化管理工具 CH-UI。

二、CH-UI 部署

CH-UI 是一款轻量级、跨平台的 ClickHouse 数据库 Web 管理工具，使用 Go 语言编写，部署简单，资源占用低。

1. 下载 CH-UI

由于网络环境限制，推荐使用国内镜像源下载：

curl -L -o ch-ui "https://gitcode.com/gh_mirrors/ch/ch-ui/releases/download/latest/ch-ui-linux-amd64"

赋予执行权限并安装到系统路径：

chmod +x ch-ui
sudo install -m 755 ch-ui /usr/local/bin/ch-ui

验证安装是否成功：

ch-ui version

2. 启动 CH-UI 服务

以后台模式启动 CH-UI 服务：

ch-ui server start --detach

验证服务运行状态：

ch-ui server status

3. 验证端口监听

CH-UI 默认监听端口为 3488。确认服务已在预期端口上监听：

ss -tlnp | grep 3488
# 或
netstat -tlnp | grep 3488

如果使用防火墙（如 ufw），请确保放行 3488 端口：
sudo ufw allow 3488

4. 浏览器访问

在浏览器中访问以下地址即可进入 CH-UI 管理界面：

http://你的服务器IP:3488

5. 登录

使用前面在 ClickHouse 中配置的用户名和密码登录即可。

三、总结

通过以上步骤，你已经成功在 Ubuntu Server 24.04 上完成了 ClickHouse + CH-UI 的部署。整体流程回顾如下：

ClickHouse 部署：添加官方仓库 → 安装 server/client → 配置远程访问 → 创建用户 → 启动服务
CH-UI 部署：下载二进制文件 → 安装到系统路径 → 后台启动 → 浏览器登录

这套组合为你提供了一个开箱即用的 ClickHouse 数据分析环境：ClickHouse 提供高性能的列式存储与查询能力，CH-UI 则提供了直观的 Web 界面，方便进行 SQL 查询、数据浏览和服务器管理。

本文基于 Ubuntu Server 24.04 环境编写，其他 Linux 发行版的部署流程基本类似，仅包管理命令可能存在差异。

posted @ 2026-06-19 16:10 crikee 阅读(39) 评论(0) 收藏举报

刷新页面返回顶部