Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Установка ClickHouse в Debian/Ubuntu

View as MarkdownEdit this pageReport an issueSet up docs MCP

Рекомендуется использовать официальные предварительно собранные deb-пакеты для Debian или Ubuntu.

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

Перед установкой ClickHouse ознакомьтесь со следующими рекомендациями:

  • Swap: В рабочей среде отключите файл подкачки операционной системы.
  • Disk space: Для установки бинарного файла ClickHouse требуется не менее 2,5 ГБ дискового пространства.
  • Network: Для распределённых развертываний (кластеризации) используйте сетевое подключение со скоростью не менее 10 Гбит/с. Пропускная способность сети критически важна для выполнения распределённых запросов с большими объёмами промежуточных данных, а также для репликации.

Оценка требований к хранилищу

Чтобы оценить, сколько дискового пространства потребуется для ваших данных:

  1. Оцените объём данных: Возьмите выборку данных и вычислите средний размер строки, затем умножьте его на количество строк, которое вы планируете хранить.
  2. Примените коэффициент сжатия: Загрузите выборку в ClickHouse и сравните исходный размер данных с размером сохранённой таблицы. Например, clickstream-данные обычно сжимаются в 6–10 раз.
  3. Учтите реплики: Если вы планируете хранить данные в нескольких репликах, умножьте расчётный объём на количество реплик.

Более подробные требования к оборудованию см. в разделе "Рекомендации по выбору размера и оборудования"

Настройте репозиторий Debian

Чтобы установить ClickHouse, выполните следующие команды:

# Установите необходимые пакеты
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# Загрузите GPG-ключ ClickHouse и сохраните его в keyring
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, чтобы использовать разные типы релизов в зависимости от ваших задач.
  • Вы можете скачать и установить пакеты вручную с packages.clickhouse.com.

Старый способ установки deb-пакетов для старых дистрибутивов
# Установите необходимые пакеты
sudo apt-get install apt-transport-https ca-certificates dirmngr

# Добавьте GPG-ключ ClickHouse для проверки подлинности пакетов
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 и client
sudo apt-get install -y clickhouse-server clickhouse-client

# Запустите сервис сервера ClickHouse
sudo service clickhouse-server start

# Запустите клиент командной строки ClickHouse
clickhouse-client # или "clickhouse-client --password", если вы настроили пароль.

Установите сервер ClickHouse и client

sudo apt-get install -y clickhouse-server clickhouse-client

Запустите ClickHouse

Чтобы запустить сервер ClickHouse, выполните:

sudo service clickhouse-server start

Чтобы запустить клиент ClickHouse, выполните:

clickhouse-client

Если для сервера настроен пароль, выполните:

clickhouse-client --password

Установите автономный ClickHouse Keeper

Чтобы установить clickhouse-keeper на серверах с автономным ClickHouse Keeper, выполните:

sudo apt-get install -y clickhouse-keeper

Включите и запустите ClickHouse Keeper

sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper

Пакеты

Ниже приведено описание доступных 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, устанавливать этот пакет не нужно. Устанавливает ClickHouse Keeper и файлы конфигурации ClickHouse Keeper по умолчанию.

Navigation