noenv/clickhouse-server

ClickHouse Server Docker 镜像

https://github.com/NoEnv/docker-clickhouse-server/actions/workflows/build.yml/badge.svg](https://github.com/NoEnv/docker-clickhouse-server/actions/workflows/build.yml)

镜像概述和主要用途

该镜像提供了一个预配置的ClickHouse Server环境，ClickHouse是一个用于联机分析处理(OLAP)的列式数据库管理系统，由Yandex开发。本镜像旨在简化ClickHouse Server的部署和运行过程，适用于开发、测试和生产环境。

核心功能和特性

• 基于官方ClickHouse Server构建，保持与上游版本同步
• 轻量级设计，优化镜像大小
• 支持多种架构（amd64, arm64等）
• 预配置合理的默认参数，可通过环境变量或配置文件自定义
• 支持数据持久化存储
• 包含健康检查机制，确保服务可用性
• 支持自定义初始化脚本

使用场景和适用范围

• 数据分析和报表系统
• 实时数据处理平台
• 日志和事件数据存储
• 数据仓库建设
• 开发和测试环境
• 微服务架构中的数据存储组件
• 需要快速部署ClickHouse的场景

使用方法和配置说明

基本使用

使用docker run命令启动

bash
docker run -d \
  --name clickhouse-server \
  -p 8123:8123 \
  -p 9000:9000 \
  noenv/clickhouse-server

使用Docker Compose启动

创建docker-compose.yml文件：

yaml
version: '3'
services:
  clickhouse-server:
    image: noenv/clickhouse-server
    container_name: clickhouse-server
    ports:
      - "8123:8123"  # HTTP接口
      - "9000:9000"  # TCP接口
    volumes:
      - clickhouse_data:/var/lib/clickhouse
    environment:
      - CLICKHOUSE_USER=default
      - CLICKHOUSE_PASSWORD=your_password
    restart: unless-stopped

volumes:
  clickhouse_data:

启动服务：

bash
docker-compose up -d

数据持久化

为避免容器重启后数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name clickhouse-server \
  -p 8123:8123 \
  -p 9000:9000 \
  -v /path/to/local/data:/var/lib/clickhouse \
  noenv/clickhouse-server

自定义配置

通过环境变量配置

支持以下环境变量进行基本配置：

示例：

bash
docker run -d \
  --name clickhouse-server \
  -p 8123:8123 \
  -p 9000:9000 \
  -e CLICKHOUSE_PASSWORD=mysecretpassword \
  -e CLICKHOUSE_MAX_MEMORY_USAGE=20000000000 \
  noenv/clickhouse-server

通过配置文件自定义

挂载自定义配置文件覆盖默认配置：

bash
docker run -d \
  --name clickhouse-server \
  -p 8123:8123 \
  -p 9000:9000 \
  -v /path/to/your/config.xml:/etc/clickhouse-server/config.xml \
  -v /path/to/your/users.xml:/etc/clickhouse-server/users.xml \
  noenv/clickhouse-server

初始化脚本

可以通过挂载包含SQL脚本的目录，在容器启动时自动执行初始化操作：

bash
docker run -d \
  --name clickhouse-server \
  -p 8123:8123 \
  -p 9000:9000 \
  -v /path/to/init-scripts:/docker-entrypoint-initdb.d \
  noenv/clickhouse-server

所有.sql文件将按字母顺序执行。

连接到ClickHouse

使用HTTP接口

bash
curl "http://localhost:8123/?user=default&password=your_password" -d "SELECT 1"

使用clickhouse-client

bash
docker exec -it clickhouse-server clickhouse-client -u default --password your_password

或者从宿主机连接：

bash
clickhouse-client --host localhost --port 9000 -u default --password your_password

健康检查

该镜像包含内置健康检查，可通过Docker的健康检查机制监控服务状态：

bash
docker inspect --format='{{.State.Health.Status}}' clickhouse-server

日志查看

查看容器日志：

bash
docker logs -f clickhouse-server

停止和删除容器

bash
# 停止容器
docker stop clickhouse-server

# 删除容器
docker rm clickhouse-server

# 如果使用Docker Compose
docker-compose down

升级镜像

bash
# 拉取最新镜像
docker pull noenv/clickhouse-server

# 停止并删除旧容器
docker stop clickhouse-server && docker rm clickhouse-server

# 使用新镜像启动
docker run -d --name clickhouse-server -p 8123:8123 -p 9000:9000 -v clickhouse_data:/var/lib/clickhouse noenv/clickhouse-server