altinity/clickhouse-server Docker 镜像

Altinity Docker镜像文档

镜像概述和主要用途

Altinity Docker镜像包含Stable（稳定版）、FIPS兼容版及测试版，旨在满足不同环境下的ClickHouse®部署需求。提供生产就绪、安全合规及功能验证的多样化选择，适配企业级数据处理场景。

镜像类型

altinitystable

• 描述：生产就绪的ClickHouse®构建版本，提供长期支持（LTS），基于官方稳定版本优化，确保稳定性与可靠性。
• 标签地址：https://hub.docker.com/r/altinity/clickhouse-server/tags?page=1&name=altinitystable
• 文档：Altinity Stable Builds文档

altinityfips

• 描述：生产就绪的ClickHouse®构建版本，集成FIPS兼容的BoringSSL加密库，满足安全合规要求（如***、***等对加密标准有严格要求的场景）。
• 标签地址：https://hub.docker.com/r/altinity/clickhouse-server/tags?page=1&name=altinityfips
• 文档：FIPS兼容Altinity构建文档

altinityantalya

• 描述：实验性ClickHouse®构建版本，包含未来Altinity Stable Build版本的候选功能与修复，用于测试新特性，不建议生产环境使用。
• 标签地址：https://hub.docker.com/r/altinity/clickhouse-server/tags?page=1&name=altinityantalya

核心功能与特性

适用场景

• altinitystable：企业级生产环境，需长期稳定运行的数据分析平台，如日志存储、实时报表、数据仓库等。
• altinityfips：***、政务、***等对加密合规性有严格要求的场景，需符合FIPS 140-2标准的安全部署。
• altinityantalya：内部测试、功能验证环境，用于评估未来Stable版本的新特性或修复效果。

架构支持

ARM架构

自以下版本起支持ARM架构：

• 23.3.13.7.altinitystable
• 23.8.8.21.altinitystable
• 22.8.15.25.altinitystable
  及后续更新版本。

相关资源

安装包

对应DEB和RPM安装包可从以下地址获取：
[***]

构建报告

构建详细报告（含测试结果、依赖信息等）可查看：
https://altinity-test-reports.s3.amazonaws.com/index.html#builds/released/

使用方法

基本Docker运行命令

启动altinitystable镜像（生产环境示例）

bash
docker run -d \
  --name clickhouse-server \
  -p 9000:9000 \  # TCP客户端端口
  -p 8123:8123 \  # HTTP接口端口
  -v /path/to/data:/var/lib/clickhouse \  # 数据持久化
  -v /path/to/config:/etc/clickhouse-server \  # 自定义配置
  altinity/clickhouse-server:<version>.altinitystable

说明：

• <version>需替换为具体版本号，如23.8.8.21；
• /path/to/data和/path/to/config为宿主机目录，用于数据持久化和配置自定义（如config.xml、users.xml）。

启动altinityfips镜像（FIPS合规场景）

bash
docker run -d \
  --name clickhouse-fips \
  -p 9000:9000 \
  -p 8123:8123 \
  -v /path/to/fips-data:/var/lib/clickhouse \
  docker.xuanyuan.run/altinity/clickhouse-server:<version>.altinityfips

连接到ClickHouse客户端

容器启动后，可通过以下命令进入客户端：

bash
docker exec -it clickhouse-server clickhouse-client

自定义配置

通过挂载配置目录/etc/clickhouse-server，可修改核心配置文件（如config.xml调整网络、存储策略；users.xml配置用户权限）。具体配置项参考https://clickhouse.com/docs/en/operations/configuration-files。