本文共 3590 字，大约阅读时间需要 11 分钟。

ClickHouse 集群安装指南（完整版）

前期准备

在开始 ClickHouse 集群安装之前，需要为每台服务器进行一系列配置和准备工作。以下是一些关键步骤和注意事项：

yum install yum-utils rpm

2. Repository 配置：访问 ClickHouse 的官方 YUM 存储库，确保 repository 正确配置。执行以下命令：

rpm --import https://repo.clickhouse.tech/CLICKHOUSE-KEY.GPG

3. 选择安装源：根据具体需求选择稳定版本或最新版本的 ClickHouse。默认情况下，可以使用 stable 版本。

4. 安装工具：确认 wget 和 rpm 已安装，用于后续步骤。

集群步骤

一、安装单机 ClickHouse（四台机器操作，以 CentOS 为例）

每台服务器都需要安装并配置单机 ClickHouse 服务。

1.1 在线安装

yum-config-manager --add-repo https://repo.clickhouse.tech/rpm/stable/x86_64
yum install clickhouse-server clickhouse-client

1.2 离线安装

对于网络不通或需要本地安装的情况，可以使用离线安装方法： 下载所需的 RPM 软件包并安装：

wget https://repo.yandex.ru/clickhouse/rpm/stable/x86_64/clickhouse-common-static-20.12.5.14-2.x86_64.rpm
wget https://repo.yandex.ru/clickhouse/rpm/stable/x86_64/clickhouse-server-20.12.5.14-2.noarch.rpm
wget https://repo.yandex.ru/clickhouse/rpm/stable/x86_64/clickhouse-client-20.12.5.14-2.noarch.rpm
rpm -ivh clickhouse-common-static-20.12.5.14-2.x86_64.rpm
rpm -ivh clickhouse-server-20.12.5.14-2.noarch.rpm
rpm -ivh clickhouse-client-20.12.5.14-2.noarch.rpm

1.3 配置参数

默认配置可能不符合生产环境需求，需要根据实际情况进行调整。以下是一些常用的配置参数：

5. 修改配置文件权限：

chmod -R 755 /etc/clickhouse-server/

2. 编辑 config.xml：

vim /etc/clickhouse-server/config.xml

默认设置：

      
       0.0.0.0
      

3.编辑 users.xml，添加用户权限：

vim /etc/clickhouse-server/users.xml

默认设置：

      
       123456
      

二、生成 /etc/metrika.xml 配置文件

集群配置文件中包含分片和副本的信息。对于四台机器，以下是生成两分片两副本集群的示例配置：

      
      
  
       
    
        
      
         
      
         
        
          
           1
          
        
          
           true
          
        
          
          
           
            yc-nsg-h20
           
          
           
            9000
           
          
           
            default
           
          
           
            123456
           
        
          
        
          
          
           
            yc-nsg-h21
           
          
           
            9000
           
          
           
            default
           
          
           
            123456
           
        
          
      
         
      
         
      
         
        
          
           1
          
        
          
           true
          
        
          
          
           
            yc-nsg-h22
           
          
           
            9000
           
          
           
            default
           
          
           
            123456
           
        
          
        
          
          
           
            yc-nsg-h3
           
          
           
            9000
           
          
           
            default
           
          
           
            123456
           
        
          
      
         
    
        
  
       
  
       
    
        
      
         
          yc-nsg-h20
         
      
         
          2181
         
    
        
    
        
      
         
          yc-nsg-h21
         
      
         
          2181
         
    
        
    
        
      
         
          yc-nsg-h22
         
      
         
          2181
         
    
        
  
       
  
       
    
        
         01
        
    
        
         02
        
    
        
         yc-nsg-h22-01-02
        
    
        
         ::/0
        
  
       
      

三、启动和验证

在所有服务器上启动 ClickHouse 服务，并验证其运行状态：

3. 启动服务：

systemctl start clickhouse-server

2. 连接客户端验证：

clickhouse-client -u default --password 123456 --port 9000 -h yc-nsg-h21 --multiquery

3. 运行查询验证集群状态：

select * from system.clusters;

卸载及资源清理

在完成集群安装后，建议清理旧的安装文件和相关日志：

yum list installed | grep clickhouse
yum remove -y clickhouse-common-static
yum remove -y clickhouse-server-common
rm -rf /var/lib/clickhouse
rm -rf /etc/clickhouse-*
rm -rf /var/log/clickhouse-server

注意事项

4. 数据迁移：在进行 ClickHouse 集群安装和配置更改时，务必进行数据迁移，并暂停写入新数据，以避免数据丢失。

5. 性能优化：根据具体的硬件资源和数据量，调整分片大小和副本数量，以获得最佳性能。

6. 高可用性：确保集群中有足够的备用节点，以应对故障情况。

7. 权限管理：定期审查并调整用户和组的权限，确保系统安全。

通过以上步骤，可以实现一个稳定高效的 ClickHouse 集群运行环境。如果在安装或配置过程中遇到问题，请务必查阅 ClickHouse 官方文档或联系技术支持团队进行详细排查。