跳到主要内容
跳到主要内容

在 Debian/Ubuntu 上安装 ClickHouse

建议在 Debian 或 Ubuntu 上使用官方预编译的 deb 安装包。

配置 Debian 软件源​

要安装 ClickHouse，请运行以下命令：

# 安装先决条件软件包 \{#install-prerequisite-packages}
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# 下载 ClickHouse 的 GPG 密钥并将其存储到密钥环中 \{#download-the-clickhouse-gpg-key-and-store-it-in-the-keyring}
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

# 获取系统架构 \{#get-the-system-architecture}
ARCH=$(dpkg --print-architecture)

# 将 ClickHouse 仓库添加到 APT 软件源列表 \{#add-the-clickhouse-repository-to-apt-sources}
echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list

# 更新 apt 软件包列表 \{#update-apt-package-lists}
sudo apt-get update

用于安装 deb 软件包的旧分发方式
# 安装前置依赖包 \{#install-prerequisite-packages}
sudo apt-get install apt-transport-https ca-certificates dirmngr

# 添加 ClickHouse GPG 密钥用于验证软件包 \{#add-the-clickhouse-gpg-key-to-authenticate-packages}
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

# 将 ClickHouse 软件仓库添加到 apt 源列表 \{#add-the-clickhouse-repository-to-apt-sources}
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
    /etc/apt/sources.list.d/clickhouse.list

# 更新 apt 软件包列表 \{#update-apt-package-lists}
sudo apt-get update

# 安装 ClickHouse 服务端和客户端软件包 \{#install-clickhouse-server-and-client-packages}
sudo apt-get install -y clickhouse-server clickhouse-client

# 启动 ClickHouse 服务 \{#start-the-clickhouse-server-service}
sudo service clickhouse-server start

# 启动 ClickHouse 命令行客户端 \{#launch-the-clickhouse-command-line-client}
clickhouse-client # 如果已设置密码,请使用 "clickhouse-client --password"。

安装 ClickHouse 服务端和客户端​

sudo apt-get install -y clickhouse-server clickhouse-client

启动 ClickHouse​

要启动 ClickHouse 服务器，请运行：

sudo service clickhouse-server start

要启动 ClickHouse 客户端，请运行：

clickhouse-client

如果已为服务器设置密码，则需要运行：

clickhouse-client --password

安装独立的 ClickHouse Keeper​

提示

在生产环境中，我们强烈建议在专用节点上运行 ClickHouse Keeper。 在测试环境中，如果你决定在同一台服务器上同时运行 ClickHouse Server 和 ClickHouse Keeper， 则无需单独安装 ClickHouse Keeper，因为它已包含在 ClickHouse Server 中。

要在独立的 ClickHouse Keeper 服务器上安装 clickhouse-keeper，请运行：

sudo apt-get install -y clickhouse-keeper

启用并启动 ClickHouse Keeper​

sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper

软件包​

可用的各种 deb 软件包如下所示：

PackageDescription
clickhouse-common-static安装 ClickHouse 已编译的二进制可执行文件。
clickhouse-server为 clickhouse-server 创建符号链接，并安装默认的服务器配置。
clickhouse-client为 clickhouse-client 和其他客户端相关工具创建符号链接，并安装客户端配置文件。
clickhouse-common-static-dbg安装带有调试信息的 ClickHouse 已编译二进制可执行文件。
clickhouse-keeper用于在专用的 ClickHouse Keeper 节点上安装 ClickHouse Keeper。如果您在与 ClickHouse server 同一台服务器上运行 ClickHouse Keeper，则无需安装此软件包。本软件包会安装 ClickHouse Keeper 以及默认的 ClickHouse Keeper 配置文件。

参考资料

如果需要安装特定版本的 ClickHouse，必须为所有软件包安装相同版本： sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7