跳转到主要内容

使用 tgz 归档包安装 ClickHouse

对于无法安装 debrpm 软件包的 Linux 发行版,建议使用官方预编译的 tgz 归档包。
1

查看建议

在安装 ClickHouse 之前,请先查看以下建议:
  • Swap: 在生产环境中禁用操作系统的交换分区或交换文件。
  • Disk space: 安装 ClickHouse 二进制文件至少需要 2.5 GB 磁盘空间。
  • Network: 对于分布式部署 (集群) ,建议至少使用 10 Gbit 网络连接。处理包含大量中间数据的分布式查询以及进行复制时,网络带宽至关重要。
估算存储需求如需估算数据所需的磁盘空间:
  1. 估算数据量: 抽取一部分数据作为样本,计算平均每行大小,然后乘以计划存储的总行数。
  2. 应用压缩系数: 将样本加载到 ClickHouse 中,比较原始数据大小与存储后表的大小。例如,点击流数据通常可压缩 6–10 倍。
  3. 考虑副本: 如果计划将数据存储在多个副本中,请将估算容量乘以副本数量。
如需了解更详细的硬件要求,请参阅 “容量规划与硬件建议”
2

下载并安装最新稳定版本

可使用 curlwget 从仓库 https://packages.clickhouse.com/tgz/ 下载所需版本。 下载完成后,解压归档包并运行安装脚本进行安装。下面示例演示了如何安装最新稳定版本。
对于生产环境,建议使用最新的 stable 版本。 你可以在此 GitHub 页面 查看带有 -stable 后缀的发布版本号。
3

获取最新的 ClickHouse 版本

从 GitHub 获取最新的 ClickHouse 版本,并将其保存到 LATEST_VERSION 变量中。
LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
    grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
export LATEST_VERSION
4

检测系统架构

检测系统架构并相应设置 ARCH 变量:
case $(uname -m) in
  x86_64) ARCH=amd64 ;;         # 适用于 Intel/AMD 64 位处理器
  aarch64) ARCH=arm64 ;;        # 适用于 ARM 64 位处理器
  *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # 如果架构不受支持则退出
esac
5

下载各个 ClickHouse 组件的 tar 包

下载各个 ClickHouse 组件的 tar 包。循环会先尝试下载特定架构的 软件包,若失败则回退到通用软件包。
for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
do
  curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
    || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
done
6

解压并安装软件包

运行以下命令,解压并安装下列软件包:
  • clickhouse-common-static
# 解压并安装 clickhouse-common-static 软件包
tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-common-static-dbg
# 解压并安装调试符号软件包
tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-server
# 解压并安装包含配置的服务器软件包
tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
sudo /etc/init.d/clickhouse-server start  # 启动服务器
  • clickhouse-client
# 解压并安装客户端软件包
tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"
最后修改于 2026年6月10日