clickhouse docker部署核心是选稳定版官方镜像、挂载数据与配置目录、开放必要端口；必须设置--ulimit nofile和--restart unless-stopped，启动后需验证服务就绪而非仅容器状态。
ClickHouse用Docker部署，核心就三点：选对镜像、挂对数据目录、开对端口。它不是装完就能高可用，关键在启动时就把持久化和网络打通，否则容器一重启数据就丢、服务就连不上。
选稳定版官方镜像，别直接拉 latest
官方推荐使用 clickhouse/clickhouse-server（非已停更的 yandex/ 命名空间）。生产环境务必指定小版本号，比如：
docker pull clickhouse/clickhouse-server:23.8.12.1
不写版本默认拉 latest，可能带未验证变更；也不建议用 nightly 或 test 版本进测试环境以外的场景。
必须挂载数据与配置目录，否则容器删了数据全没
ClickHouse 默认把数据存在 /var/lib/clickhouse，日志和配置在 /etc/clickhouse-server。启动时要用 -v 映射到宿主机：
- 创建宿主机目录：
mkdir -p /data/clickhouse/{data,logs,config.d} - 启动命令示例（含基础安全与资源限制）：
docker run -d \ --name clickhouse-prod \ --ulimit nofile=262144:262144 \ --restart unless-stopped \ -p 8123:8123 \ # HTTP 接口（如 Grafana、curl） -p 9000:9000 \ # Native TCP 接口（如 DBeaver、客户端） -p 9009:9009 \ # Interserver HTTP（集群内通信，可选） -v /data/clickhouse/data:/var/lib/clickhouse \ -v /data/clickhouse/logs:/var/log/clickhouse-server \ -v /data/clickhouse/config.d:/etc/clickhouse-server/config.d \ -e CLICKHOUSE_USER=admin \ -e CLICKHOUSE_PASSWORD=your_secure_pass \ clickhouse/clickhouse-server:23.8.12.1
⚠️ 注意：
--ulimit nofile是必须项，ClickHouse 高并发依赖大量文件句柄；--restart unless-stopped保证系统重启后自动恢复服务。
验证是否真跑起来了，别只看容器状态
容器 Up 不等于 ClickHouse 就绪。执行：
# 看日志末尾有没有 "Ready for connections" docker logs clickhouse-prod | tail -20 # 用 curl 测试 HTTP 接口（返回版本号即通） curl "http://localhost:8123/?user=admin&password=your_secure_pass" -d "SELECT version()" # 用 clickhouse-client 进容器查（需先安装 client 或进容器） docker exec -it clickhouse-prod clickhouse-client -u admin --password your_secure_pass -q "SELECT now()"
后续要调优或加功能？优先改 config.d 下的配置文件
比如想开启 ZooKeeper 支持（为集群准备），就在宿主机 /data/clickhouse/config.d/zookeeper.xml 里写：
<yandex><zookeeper><node index="1"><host>zoo1</host><port>2181</port></node></zookeeper></yandex>
再重启容器即可生效——所有自定义配置都走 config.d/ 挂载，不用重建镜像。
不复杂但容易忽略
