Перейти к основному содержанию

Установка ClickHouse с помощью архивов tgz

Для всех дистрибутивов Linux, где невозможно установить пакеты deb или rpm, рекомендуется использовать официальные предварительно скомпилированные архивы tgz.
1

Ознакомьтесь с рекомендациями

Перед установкой ClickHouse ознакомьтесь со следующими рекомендациями:
  • Swap: В рабочей среде отключите файл подкачки операционной системы.
  • Disk space: Для установки бинарного файла ClickHouse требуется не менее 2,5 ГБ дискового пространства.
  • Network: Для распределённых развертываний (кластеризации) используйте сетевое подключение со скоростью не менее 10 Гбит/с. Пропускная способность сети критически важна для выполнения распределённых запросов с большими объёмами промежуточных данных, а также для репликации.
Оценка требований к хранилищуЧтобы оценить, сколько дискового пространства потребуется для ваших данных:
  1. Оцените объём данных: Возьмите выборку данных и вычислите средний размер строки, затем умножьте его на количество строк, которое вы планируете хранить.
  2. Примените коэффициент сжатия: Загрузите выборку в ClickHouse и сравните исходный размер данных с размером сохранённой таблицы. Например, clickstream-данные обычно сжимаются в 6–10 раз.
  3. Учтите реплики: Если вы планируете хранить данные в нескольких репликах, умножьте расчётный объём на количество реплик.
Более подробные требования к оборудованию см. в разделе “Рекомендации по выбору размера и оборудования”
2

Скачайте и установите последнюю стабильную версию

Нужную версию можно скачать с помощью curl или wget из репозитория https://packages.clickhouse.com/tgz/. После этого скачанные архивы нужно распаковать и установить с помощью установочных скриптов.Ниже приведен пример установки последней стабильной версии.
Для окружений продакшн рекомендуется использовать последнюю stable-версию. Номер релиза можно найти на этой странице GitHub с постфиксом -stable.
3

Получите последнюю версию ClickHouse

Получите последнюю версию ClickHouse из GitHub и сохраните ее в переменной LATEST_VERSION.
LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
    grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
export LATEST_VERSION
4

Определите архитектуру вашей системы

Определите архитектуру системы и задайте переменную ARCH соответствующим образом:
case $(uname -m) in
  x86_64) ARCH=amd64 ;;         # Для 64-битных процессоров Intel/AMD
  aarch64) ARCH=arm64 ;;        # Для 64-битных процессоров ARM
  *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # Выход, если архитектура не поддерживается
esac
5

Скачайте tar-архивы для каждого компонента ClickHouse

Скачайте tar-архивы для каждого компонента ClickHouse. Цикл сначала пытается скачать пакеты для конкретной архитектуры, а затем переключается на универсальные.
for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
do
  curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
    || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
done
6

Распакуйте и установите пакеты

Выполните приведенные ниже команды, чтобы распаковать и установить следующие пакеты:
  • clickhouse-common-static
# Распакуйте и установите пакет clickhouse-common-static
tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-common-static-dbg
# Распакуйте и установите пакет с символами отладки
tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-server
# Распакуйте и установите пакет сервера с конфигурацией
tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
sudo /etc/init.d/clickhouse-server start  # Запустите сервер
  • clickhouse-client
# Распакуйте и установите пакет клиента
tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"
Последнее изменение 10 июня 2026 г.