本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

ClickHouse Inc.
Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow
最新稳定版:latest、jammy、25.9、25.9-jammy、25.9.3、25.9.3-jammy、25.9.3.48、25.9.3.48-jammy
Dockerfile 链接
LTS 版:lts、lts-jammy、25.8、25.8-jammy、25.8.10、25.8.10-jammy、25.8.10.7、25.8.10.7-jammy
Dockerfile 链接
其他版本:
25.7 系列:Dockerfile 链接25.3 系列:Dockerfile 链接amd64:镜像链接arm64v8:镜像链接repo-info 仓库的 repos/clickhouse/ 目录(含镜像元数据、传输大小等,历史记录)
library/clickhouse 标签library/clickhouse 文件(历史记录)docs 仓库的 clickhouse/ 目录(历史记录)
!logo
ClickHouse 是开源的列式数据库管理系统(DBMS),专为联机分析处理(OLAP)设计,支持通过 SQL 实时生成分析报告。其处理速度比传统数据库快 100-1000 倍,单服务器每秒可处理数亿至数十亿行数据、数十 GB 数据,具有高可靠性、易用性和容错能力,用户群体遍布全球。
详细文档见:[***]
latest:指向最新稳定分支的最新版本。22.2):指向对应分支的最新版本。22.2.3、22.2.3.5):指向具体版本。ubuntu:22.04,需 Docker 版本 >=20.10.10(含 补丁)。若版本不足,可使用 docker run --security-opt seccomp=unconfined 作为临时方案(注意安全风险)。docker run -d --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse
default 用户启动,无密码。# 方式一:通过容器网络连接 docker run -it --rm --network=container:some-clickhouse-server --entrypoint clickhouse-client clickhouse # 方式二:直接在容器内执行客户端 docker exec -it some-clickhouse-server clickhouse-client
客户端详情:ClickHouse 客户端文档
echo "SELECT 'Hello, ClickHouse!'" | docker run -i --rm --network=container:some-clickhouse-server buildpack-deps:curl curl '[***]' -s --data-binary @-
HTTP 接口详情:ClickHouse HTTP 接口文档
docker stop some-clickhouse-server # 停止 docker rm some-clickhouse-server # 删除
⚠️ 注意:默认
default用户无密码时,不允许网络访问(见下文“用户管理”)。
如需外部访问,可通过以下方式暴露端口:
方式一:端口映射
docker run -d -p 18123:8123 -p 19000:9000 -e CLICKHOUSE_PASSWORD=changeme --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse # 测试连接 echo 'SELECT version()' | curl '[***]' --data-binary @-
方式二:使用主机网络(性能更佳)
docker run -d --network=host --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse # 测试连接 echo 'SELECT version()' | curl '[***]' --data-binary @-
建议挂载以下目录以确保数据/配置持久化:
/var/lib/clickhouse/:数据存储目录/var/log/clickhouse-server/:日志目录/etc/clickhouse-server/config.d/:配置文件目录(可选)docker run -d \ -v "$PWD/ch_data:/var/lib/clickhouse/" \ -v "$PWD/ch_logs:/var/log/clickhouse-server/" \ --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse
部分高级功能需启用特定 Linux 能力(可选):
docker run -d \ --cap-add=SYS_NICE --cap-add=NET_ADMIN --cap-add=IPC_LOCK \ --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse
详情:配置 Docker 能力文档
docker run -d --name some-clickhouse-server --ulimit nofile=262144:262144 -v /本地配置路径/config.xml:/etc/clickhouse-server/config.xml clickhouse
配置文件详情:ClickHouse 配置文档
# 确保本地目录存在且属当前用户 docker run --rm --user "${UID}:${GID}" --name some-clickhouse-server \ -v "$PWD/logs/clickhouse:/var/log/clickhouse-server" \ -v "$PWD/data/clickhouse:/var/lib/clickhouse" \ --ulimit nofile=262144:262144 clickhouse
挂载本地目录时,需通过 --user 指定用户,确保文件权限正确。
docker run --rm -e CLICKHOUSE_RUN_AS_ROOT=1 --name clickhouse-server-userns \ -v "$PWD/logs/clickhouse:/var/log/clickhouse-server" \ -v "$PWD/data/clickhouse:/var/lib/clickhouse" \ clickhouse
可通过环境变量在启动时创建默认数据库和用户:
docker run --rm -e CLICKHOUSE_DB=my_database -e CLICKHOUSE_USER=username -e CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT=1 -e CLICKHOUSE_PASSWORD=password -p 9000:9000/tcp clickhouse
CLICKHOUSE_DB:创建默认数据库CLICKHOUSE_USER/CLICKHOUSE_PASSWORD:创建用户及密码CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT:启用访问控制默认 default 用户无密码时,禁止网络访问。如需开放(仅测试用,不安全):
docker run --rm -e CLICKHOUSE_SKIP_USER_SETUP=1 -p 9000:9000/tcp clickhouse
如需自定义初始化(如创建表、用户),可在 /docker-entrypoint-initdb.d 目录下添加 *.sql、*.sql.gz 或 *.sh 脚本。容器启动时会自动执行这些脚本。
示例:创建数据库和表(保存为 /docker-entrypoint-initdb.d/init-db.sh)
#!/bin/bash set -e clickhouse client -n <<-EOSQL CREATE DATABASE docker; CREATE TABLE docker.docker (x Int32) ENGINE = Log; EOSQL
可通过 CLICKHOUSE_USER 和 CLICKHOUSE_PASSWORD 环境变量指定脚本执行时的客户端凭证。
clickhouse/ 目录。使用前请确保遵守所有软件的许可协议。


免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429