> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 在 Debian/Ubuntu Linux 上安装 ClickHouse

# 在 Debian/Ubuntu 上安装 ClickHouse

<div id="install-from-deb-packages">
  # 在 Debian/Ubuntu 上安装 ClickHouse
</div>

> 建议在 **Debian** 或 **Ubuntu** 上使用官方预编译的 `deb` 软件包。

<Steps>
  <Step>
    ## 查看建议

    在安装 ClickHouse 之前，请先查看以下建议：

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

    **估算存储需求**

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

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

    如需了解更详细的硬件要求，请参阅 ["容量规划与硬件建议"](/zh/guides/oss/best-practices/sizing-and-hardware-recommendations)
  </Step>

  <Step>
    ## 设置 Debian 仓库

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

    ```bash theme={null}
    # 安装前置软件包
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

    # 下载 ClickHouse GPG 密钥并将其保存到密钥环中
    curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

    # 获取系统架构
    ARCH=$(dpkg --print-architecture)

    # 将 ClickHouse 仓库添加到 apt 软件源
    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 软件包列表
    sudo apt-get update
    ```

    * 你可以将 `stable` 替换为 `lts`，根据需要使用不同的[发布类型](/zh/resources/support-center/knowledge-base/setup-installation/production)。
    * 你也可以从 [packages.clickhouse.com](https://packages.clickhouse.com/deb/pool/main/c/) 手动下载并安装软件包。

    <br />

    <Accordion title="旧版发行版安装 deb 软件包的方法">
      ```bash theme={null}
      # 安装前置软件包
      sudo apt-get install apt-transport-https ca-certificates dirmngr

      # 添加 ClickHouse GPG 密钥以验证软件包
      sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

      # 将 ClickHouse 仓库添加到 apt 软件源
      echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
          /etc/apt/sources.list.d/clickhouse.list
          
      # 更新 apt 软件包列表
      sudo apt-get update

      # 安装 ClickHouse server 和客户端软件包
      sudo apt-get install -y clickhouse-server clickhouse-client

      # 启动 ClickHouse server 服务
      sudo service clickhouse-server start

      # 启动 ClickHouse 命令行客户端
      clickhouse-client # 或者，如果你设置了密码，请使用 "clickhouse-client --password"。
      ```
    </Accordion>
  </Step>

  <Step>
    ## 安装 ClickHouse server 和客户端

    ```bash theme={null}
    sudo apt-get install -y clickhouse-server clickhouse-client
    ```
  </Step>

  <Step>
    ## 启动 ClickHouse

    要启动 ClickHouse server，请运行：

    ```bash theme={null}
    sudo service clickhouse-server start
    ```

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

    ```bash theme={null}
    clickhouse-client
    ```

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

    ```bash theme={null}
    clickhouse-client --password
    ```
  </Step>

  <Step>
    ## 安装独立运行的 ClickHouse Keeper

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

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

    ```bash theme={null}
    sudo apt-get install -y clickhouse-keeper
    ```
  </Step>

  <Step>
    ## 启用并启动 ClickHouse Keeper

    ```bash theme={null}
    sudo systemctl enable clickhouse-keeper
    sudo systemctl start clickhouse-keeper
    sudo systemctl status clickhouse-keeper
    ```
  </Step>
</Steps>

<div id="packages">
  ## 软件包
</div>

下面列出了可用的各个 deb 软件包及其说明：

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

<br />

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