跳转到主要内容

在 NixOS 上安装 ClickHouse

ClickHouse 可从 Nixpkgs 仓库获取,并可使用 Nix 安装在 LinuxmacOS 上。
1

查看建议

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

使用 Nix 安装 ClickHouse

你可以使用 Nix 安装 ClickHouse,而无需将其永久添加到系统中:
# 安装最新稳定版本
nix shell nixpkgs#clickhouse

# 或安装 LTS 版本
nix shell nixpkgs#clickhouse-lts
这样,clickhouse 可执行文件就会在当前 shell 会话中可用。
  • nixpkgs#clickhouse 包提供最新稳定版本。
  • nixpkgs#clickhouse-lts 包提供长期支持版本。
  • 这两个包都可在 Linux 和 macOS 上使用。
3

永久安装

要在系统上永久安装 ClickHouse:对于 NixOS 用户,请将以下内容添加到 configuration.nix 中:
environment.systemPackages = with pkgs; [
  clickhouse
];
然后重建系统:
sudo nixos-rebuild switch
对于非 NixOS 用户,请使用 Nix profile 安装:
# 安装最新稳定版本
nix profile install nixpkgs#clickhouse

# 或安装 LTS 版本
nix profile install nixpkgs#clickhouse-lts
4

启动 ClickHouse server

安装完成后,你可以启动 ClickHouse server:
clickhouse-server
默认情况下,server 会使用基础配置启动,并监听 localhost:9000如果要在 NixOS 上用于生产环境,你可能需要将 ClickHouse 配置为系统服务。有关可用配置选项,请参阅 NixOS manual
5

启动 ClickHouse 客户端

要连接到 ClickHouse server,请打开一个新的终端并运行:
clickhouse-client

关于 Nix 软件包

Nixpkgs 中的 ClickHouse 软件包包含:
  • clickhouse-server - ClickHouse 数据库服务器
  • clickhouse-client - 用于连接 ClickHouse 的命令行客户端
  • clickhouse-local - 用于在本地文件上执行 SQL 查询的工具
  • 其他 ClickHouse 实用程序
有关 Nixpkgs 中 ClickHouse 软件包的更多信息,请参阅:
最后修改于 2026年6月10日