Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

在 NixOS 上安装 ClickHouse

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

查看建议

在安装 ClickHouse 之前,请先查看以下建议:

  • Swap: 在生产环境中禁用操作系统的交换分区或交换文件。
  • Disk space: 安装 ClickHouse 二进制文件至少需要 2.5 GB 磁盘空间。
  • Network: 对于分布式部署 (集群) ,建议至少使用 10 Gbit 网络连接。处理包含大量中间数据的分布式查询以及进行复制时,网络带宽至关重要。

估算存储需求

如需估算数据所需的磁盘空间:

  1. 估算数据量: 抽取一部分数据作为样本,计算平均每行大小,然后乘以计划存储的总行数。
  2. 应用压缩系数: 将样本加载到 ClickHouse 中,比较原始数据大小与存储后表的大小。例如,点击流数据通常可压缩 6–10 倍。
  3. 考虑副本: 如果计划将数据存储在多个副本中,请将估算容量乘以副本数量。

如需了解更详细的硬件要求,请参阅 "容量规划与硬件建议"

使用 Nix 安装 ClickHouse

您可以使用 Nix 安装 ClickHouse,而无需将其永久添加到系统中:

# 安装最新稳定版本
nix shell nixpkgs#clickhouse

# 或安装 LTS 版本
nix shell nixpkgs#clickhouse-lts

这会让 clickhouse 可执行文件在您当前的 shell 会话中可用。

  • nixpkgs#clickhouse 软件包提供最新稳定版本。
  • nixpkgs#clickhouse-lts 软件包提供长期支持版本。
  • 这两个软件包都可在 Linux 和 macOS 上使用。

永久安装

要将 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

启动 ClickHouse 服务器

安装完成后,您可以启动 ClickHouse 服务器:

clickhouse-server

默认情况下,服务器将使用基本配置启动,并监听 localhost:9000

如果要在 NixOS 上用于生产环境,您可能需要将 ClickHouse 配置为系统服务。有关可用配置选项,请参阅 NixOS 手册

启动 ClickHouse 客户端

要连接到 ClickHouse 服务器,请打开一个新的终端并运行:

clickhouse-client

关于 Nix 包

Nixpkgs 中的 ClickHouse 包包含:

  • clickhouse-server - ClickHouse 数据库服务器
  • clickhouse-client - 用于连接 ClickHouse 的命令行客户端
  • clickhouse-local - 用于在本地文件上运行 SQL 查询的工具
  • 其他 ClickHouse 实用工具

有关 Nixpkgs 中 ClickHouse 包的更多信息,请访问:

Navigation