메인 콘텐츠로 건너뛰기

소스 코드에서 빌드

ClickHouse를 수동으로 빌드하려면 Linux 또는 macOS용 지침을 따르십시오. 패키지를 빌드한 뒤 설치할 수도 있고, 패키지를 설치하지 않고 프로그램만 사용할 수도 있습니다.
Client: <build_directory>/programs/clickhouse-client
Server: <build_directory>/programs/clickhouse-server
데이터 및 메타데이터 폴더는 수동으로 생성한 뒤, 원하는 사용자 소유로 chown해야 합니다. 경로는 server config (src/programs/server/config.xml)에서 변경할 수 있으며, 기본값은 다음과 같습니다:
/var/lib/clickhouse/data/default/
/var/lib/clickhouse/metadata/default/
Gentoo에서는 emerge clickhouse만 실행하면 ClickHouse를 소스에서 설치할 수 있습니다.

CI가 생성한 바이너리 설치

ClickHouse의 지속적 통합(CI) 인프라는 ClickHouse 리포지토리의 각 커밋에 대해 특수한 빌드를 생성합니다. 예를 들어 sanitized 빌드, 최적화되지 않은(Debug) 빌드, 크로스 컴파일 빌드 등이 있습니다. 이러한 빌드는 일반적으로 개발 중에만 유용하지만, 특정 상황에서는 활용할 만한 경우도 있습니다.
ClickHouse의 CI는 시간이 지나면서 계속 변경되므로, CI가 생성한 빌드를 다운로드하는 정확한 절차는 달라질 수 있습니다. 또한 CI에서 오래된 빌드 아티팩트를 삭제하여 다운로드할 수 없게 될 수도 있습니다.
예를 들어 ClickHouse v23.4용 aarch64 바이너리를 다운로드하려면 다음 단계를 따르세요.
  • v23.4 릴리스의 GitHub pull request를 찾으세요: 브랜치 23.4용 릴리스 pull request
  • “Commits”를 클릭한 다음, 설치하려는 특정 버전에 해당하는 “Update autogenerated version to 23.4.2.1 and contributors”와 비슷한 커밋을 클릭하세요.
  • 초록색 체크 표시 / 노란색 점 / 빨간색 X를 클릭해 CI 검사 목록을 여세요.
  • 목록에서 “Builds” 옆의 “Details”를 클릭하세요. 그러면 이 페이지와 비슷한 페이지가 열립니다.
  • compiler = “clang-*-aarch64”인 행을 찾으세요. 이런 행이 여러 개 있습니다.
  • 해당 빌드의 아티팩트를 다운로드하세요.
마지막 수정일 2026년 6월 10일