clickhouse可在linux通过五种方式部署:一、官方脚本快速安装;二、apt包管理器(ubuntu/debian);三、rpm离线安装(centos/rhel);四、tgz手动安装(高兼容性);五、docker容器化部署。

如果您需要在 Linux 系统上部署 ClickHouse 数据库,但尚未完成安装与基础配置,则可能是由于缺少依赖、安装包选择不当或服务未正确初始化所致。以下是多种可直接执行的安装与配置方法:
一、使用官方一键脚本安装(推荐快速验证)
该方式通过官方提供的 shell 脚本自动下载并安装最新稳定版二进制文件,适用于 Ubuntu/Debian/CentOS 等主流发行版,无需手动处理依赖。
1、在终端中执行官方安装命令:curl https://clickhouse.com/ | sh
2、进入脚本输出的目录(通常为当前目录),运行安装脚本:./clickhouse install
3、按提示设置 default 用户密码(直接回车表示空密码)
4、启动服务:clickhouse start
5、连接客户端验证:clickhouse-client -m
二、使用 APT 包管理器安装(Ubuntu/Debian)
此方式利用系统包管理器统一维护版本与依赖,适合生产环境长期运维,安装后服务自动注册为 systemd 单元。
1、添加 ClickHouse 官方 APT 仓库:sudo apt-get install apt-transport-https && sudo wget -q "https://packagecloud.io/clickhouse/release/script.deb.sh" -O - | sudo bash
2、更新软件包索引:sudo apt update
3、安装服务端与客户端:sudo apt -y install clickhouse-server clickhouse-client
4、启动服务并启用开机自启:sudo service clickhouse-server start && sudo systemctl enable clickhouse-server
5、连接本地实例:clickhouse-client --password
三、使用 RPM 包离线安装(CentOS/RHEL)
适用于无外网访问权限的内网服务器,需预先下载四个核心 RPM 包并按依赖顺序安装,确保组件完整性。
1、创建安装目录并进入:mkdir -p /opt/clickhouse && cd /opt/clickhouse
2、下载四个必需 RPM 包(以 24.12.1.1614 版本为例):wget https://packages.clickhouse.com/rpm/stable/clickhouse-common-static-24.12.1.1614-1.el7.x86_64.rpm
3、依次安装(注意顺序):sudo rpm -ivh clickhouse-common-static-24.12.1.1614-1.el7.x86_64.rpm
4、安装 server-common 包:sudo rpm -ivh clickhouse-server-common-24.12.1.1614-1.el7.x86_64.rpm
5、安装 server 主程序:sudo rpm -ivh clickhouse-server-24.12.1.1614-1.el7.x86_64.rpm
6、安装 client 工具:sudo rpm -ivh clickhouse-client-24.12.1.1614-1.el7.x86_64.rpm
7、初始化配置并启动:sudo clickhouse-server --config-file=/etc/clickhouse-server/config.xml &
四、使用 TGZ 压缩包手动安装(兼容性最强)
该方式完全脱离包管理器,所有文件解压至指定路径,便于多版本共存及定制化部署,适用于对文件路径有严格控制的场景。
1、下载 stable 目录下的四个 tgz 包:clickhouse-common-static-21.1.9.41.tgz、clickhouse-common-static-dbg-21.1.9.41.tgz、clickhouse-server-21.1.9.41.tgz、clickhouse-client-21.1.9.41.tgz
2、上传至目标服务器(如 /export/software/)
3、依次解压并执行安装脚本:tar -zxvf clickhouse-common-static-21.1.9.41.tgz && ./clickhouse-common-static-21.1.9.41/install/doinst.sh
4、重复步骤 3,依次处理 dbg、client、server 包(server 必须最后安装)
5、确认用户创建:id clickhouse 应返回有效用户信息
6、启动服务:sudo service clickhouse-server start
五、Docker 容器化部署(隔离性强、启动快)
适用于开发测试、CI/CD 流水线或资源受限环境,所有依赖封装在镜像中,避免系统级冲突。
1、拉取官方镜像:docker pull clickhouse/clickhouse-server
2、运行容器并映射端口:docker run -d --name clickhouse-server -p 8123:8123 -p 9000:9000 -p 9009:9009 --ulimit nofile=262144:262144 clickhouse/clickhouse-server
3、进入容器执行客户端:docker exec -it clickhouse-server clickhouse-client -m
4、如需持久化数据,添加卷映射参数:-v /data/clickhouse:/var/lib/clickhouse










