1. 背景业务项目引入ClickHouse作为高性能数据分析、海量数据存储查询组件需完成服务器单节点离线部署。本文档完整记录Ubuntu24系统下tgz二进制包部署全流程标准化实操步骤可为后续同环境、同版本集群/单节点部署提供复用指导。2. 环境信息本次部署硬件、软件环境固定参数如下配置项配置参数服务器操作系统Ubuntu 24Clickhouse版本25.3.2.39Java版本OpenJDK 21系统总内存125GCPU核数72核3. 下载安装包Ubuntu系统部署Clickhouse采用tgz二进制包方式需依次下载以下四个安装包clickhouse-common-static-25.3.2.39-amd64.tgz --核心运行依赖包 clickhouse-common-static-dbg-25.3.2.39-amd64.tgz --调试日志依赖包 clickhouse-server-25.3.2.39-amd64.tgz --服务端主程序包 clickhouse-client-25.3.2.39-amd64.tgz --本地命令行客户端包4. 安装与启动4.1 解压安装包将四个安装包依次解压至指定目录/usr/local执行全局解压命令sudo tar -xvf clickhouse-common-static-25.3.2.39-amd64.tgz -C /usr/local sudo tar -xvf clickhouse-common-static-dbg-25.3.2.39-amd64.tgz -C /usr/local sudo tar -xvf clickhouse-server-25.3.2.39-amd64.tgz -C /usr/local sudo tar -xvf clickhouse-client-25.3.2.39-amd64.tgz -C /usr/local4.2 执行安装操作进入各解压后的目录依次执行安装脚本命令如下cd /usr/local/clickhouse-common-static-25.3.2.39 sudo ./install/doinst.sh cd /usr/local/clickhouse-common-static-dbg-25.3.2.39 sudo ./install/doinst.sh cd /usr/local/clickhouse-server-25.3.2.39 sudo ./install/doinst.sh cd /usr/local/clickhouse-client-25.3.2.39 sudo ./install/doinst.sh4.3 启动ClickHouse服务安装脚本已自动注册systemd系统服务直接执行命令启停服务sudo systemctl start clickhouse-server5. 常见问题与解决办法5.1 目录找不到或权限访问失败问题现象服务启动报错提示/var/lib/clickhouse/、/var/log/clickhouse-server/目录不存在、用户无读写权限。问题根因安装脚本自动创建系统clickhouse运行用户但Ubuntu24默认目录权限收紧内置脚本无法自动创建数据、日志目录目录初始化失败。解决方案手动创建目录、归属修改为clickhouse用户组、赋权读写权限执行以下命令sudo mkdir -p /var/lib/ clickhousesudo sudo chown -R clickhouse:clickhouse /var/lib/clickhouse sudo chmod -R 777 /var/lib/clickhouse5.2 启动报错“Failed to find user name for 750”问题现象服务启动失败日志抛出Failed to find user name for 750问题根因ClickHouse服务配置默认运行UID为750当前系统clickhouse用户UID与750不匹配服务无法识别运行用户。解决方案修改系统clickhouse用户UID为标准750适配服务配置sudo usermod -u 750 clickhouse6. 部署验证6.1 验证服务端状态通过systemctl查看服务常驻状态确认服务正常运行sudo systemctl status clickhouse-server通过systemctl查看服务常驻状态确认服务正常运行6.2 验证Clickhouse-client功能调用内置clickhouse-client进入交互式命令行执行建表、查询基础SQL校验读写语法、本地连通性clickhouse-client6.3 校验业务C客户端连通能力业务说明业务底层通过C客户端SDK对接ClickHouse写入业务数据需提前部署C依赖库、编译客户端组件保障业务程序正常连通写入完整适配步骤如下部署clickhouse-cpp客户端库源码地址GitHub - ClickHouse/clickhouse-cpp: C client library for ClickHouse下载clickhouse-cpp-master源码包解压后执行编译安装命令# 生成Release编译配置 cmake -B build -S . -DCMAKE_BUILD_TYPERelease # 编译并安装组件 make --build build --target install部署abseil-cpp依赖库Github下载abseil-cpp-master源码包进入目录执行编译安装mkdir build cd build cmake .. make --build build --target install适配系统zstd开发依赖包系统内置libzstd 1.5.5运行库需配套安装开发包 离线安装包libzstd-dev_1.5.5dfsg2-2build1.1_amd64.deb编译运行业务C读写示例代码验证远端读写、连接鉴权全部功能正常。