메인 콘텐츠로 건너뛰기

rpm 기반 배포판에 ClickHouse 설치

CentOS, RedHat 및 기타 모든 rpm 기반 Linux 배포판에서는 공식 사전 컴파일 rpm 패키지 사용을 권장합니다.
1

권장 사항 검토

ClickHouse를 설치하기 전에 다음 권장 사항을 확인하십시오:
  • 스왑: 운영 환경에서는 운영 체제의 스왑 파일을 비활성화하십시오.
  • 디스크 공간: ClickHouse 바이너리를 설치하려면 최소 2.5 GB의 디스크 공간이 필요합니다.
  • 네트워크: 분산 배포(클러스터링)에서는 최소 10 Gbit 네트워크 연결을 사용하십시오. 대량의 중간 데이터를 포함하는 분산 쿼리를 처리할 때와 복제 시에는 네트워크 대역폭이 매우 중요합니다.
스토리지 요구 사항 추정데이터에 필요한 디스크 공간을 추정하려면 다음 단계를 따르십시오:
  1. 데이터 양 추정: 데이터 샘플을 가져와 평균 행 크기를 계산한 다음, 저장할 행 수를 곱합니다.
  2. 압축 계수 적용: 샘플을 ClickHouse에 로드한 뒤 원본 데이터 크기와 저장된 테이블 크기를 비교합니다. 예를 들어 클릭스트림 데이터는 일반적으로 6~10배 압축됩니다.
  3. 레플리카 고려: 여러 레플리카에 데이터를 저장할 계획이라면 추정 용량에 레플리카 수를 곱합니다.
더 자세한 하드웨어 요구 사항은 “사이징 및 하드웨어 권장 사항”을 참조하십시오.
2

RPM 리포지토리 설정

다음 명령을 실행하여 공식 리포지토리를 추가합니다.
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://packages.clickhouse.com/rpm/clickhouse.repo
zypper 패키지 관리자(openSUSE, SLES)를 사용하는 시스템에서는 다음 명령을 실행합니다.
sudo zypper addrepo -r https://packages.clickhouse.com/rpm/clickhouse.repo -g
sudo zypper --gpg-auto-import-keys refresh clickhouse-stable
아래 단계에서는 사용 중인 패키지 관리자에 따라 yum install 대신 zypper install을 사용할 수 있습니다.
3

ClickHouse 서버 및 clickhouse client 설치

ClickHouse를 설치하려면 다음 명령을 실행합니다.
sudo yum install -y clickhouse-server clickhouse-client
  • 필요에 따라 다른 릴리스 유형을 사용하려면 stable 대신 lts를 사용할 수 있습니다.
  • packages.clickhouse.com/rpm에서 패키지를 수동으로 다운로드하여 설치할 수도 있습니다.
  • 특정 버전을 지정하려면 패키지 이름 끝에 -$version을 추가합니다. 예시는 다음과 같습니다.
sudo yum install clickhouse-server-22.8.7.34
4

ClickHouse 서버 시작

ClickHouse 서버를 시작하려면 다음 명령을 실행합니다.
sudo systemctl enable clickhouse-server
sudo systemctl start clickhouse-server
sudo systemctl status clickhouse-server
clickhouse client를 시작하려면 다음 명령을 실행합니다.
clickhouse-client
서버에 비밀번호를 설정한 경우에는 다음 명령을 실행해야 합니다.
clickhouse-client --password
5

standalone ClickHouse Keeper 설치

프로덕션 환경에서는 전용 노드에서 ClickHouse Keeper를 실행할 것을 강력히 권장합니다. 테스트 환경에서 ClickHouse 서버와 ClickHouse Keeper를 동일한 서버에서 실행하는 경우, ClickHouse 서버에 ClickHouse Keeper가 포함되어 있으므로 별도로 설치할 필요가 없습니다.
standalone ClickHouse Keeper 서버에 clickhouse-keeper를 설치하려면 다음 명령을 실행합니다.
sudo yum install -y clickhouse-keeper
6

ClickHouse Keeper 활성화 및 시작

sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper
마지막 수정일 2026년 6월 10일