ClickHouse Keeper 认证机制与安全配置指南
在绝大多数 Kubernetes 内部部署场景下,保持默认免密(配合 K8s 内部网络隔离,不对外暴露 9181 端口)是最高效且最标准的做法。如果未来出于严格的安全合规要求需要开启鉴权,ClickHouse Keeper 也支持以下原生认证机制。
一、 认证模式对比总览
| 认证模式 | 适用场景 | 核心配置位置 | 安全级别与特性 |
|---|---|---|---|
| 默认免密模式 (内网信任) |
绝大多数 K8s 内部专网部署。 | 无需配置认证参数(默认开启)。 | 性能最高;依赖内网隔离,严禁暴露端口至集群外。 |
| Digest 账号密码鉴权 (ACL 访问控制) |
安全合规要求对元数据操作进行身份校验。 | Client 端 zookeeper.xml 添加 “。 |
沿用 ZooKeeper 协议,为新建元数据目录锁定专属账密。 |
| TLS 双向证书认证 (mTLS 加密) |
金融级或跨不可信网络的高安全合规环境。 | Keeper 端配置 tcp_port_secure 与双方证书。 |
全链路传输加密,并通过校验证书合法性双向验证节点身份。 |
二、 详细配置与机制说明
1. 默认状态(内网免密信任)
- 表现:只要 ClickHouse Server 在
zookeeper.xml中配置了正确的 Keeper 域名和9181端口,建立 TCP 连接后即可直接读写元数据路径,无需传递任何用户名或密码。 - 安全前提:确保只创建了
clusterIP: None的内部 Headless Service,切勿通过NodePort或LoadBalancer将9181(客户端端口)和9444(Raft 内部同步端口)暴露到 K8s 集群外部。
2. 可选开启的两种鉴权方式(高安全合规场景)
如果安全规范强制要求对协调组件进行身份认证,可通过修改配置开启:
-
Digest 账号密码鉴权(ACL)
- 原理:沿用 ZooKeeper 的
digest认证协议,在 ClickHouse Server 的zookeeper.xml中添加用户名:密码(例如clickhouse_admin:KeeperPass@2026)。 - 效果:Server 在创建节点元数据(如
/clickhouse目录)时会自动加上访问控制列表(ACL),其他未携带相同账号密码的客户端无法修改或删除这些元数据。
- 原理:沿用 ZooKeeper 的
-
TLS 双向证书认证(mTLS)
- 原理:同时为 ClickHouse Keeper(开启
tcp_port_secure)和 ClickHouse Server 配置 SSL/TLS 证书及私钥路径。 - 效果:不仅加密传输过程中的所有元数据流量,还会通过校验证书合法性来双向验证节点身份,彻底杜绝未授权节点接入。
- 原理:同时为 ClickHouse Keeper(开启
🔒 原创版权声明
本文标题:ClickHouse Keeper 认证机制与安全配置指南
版权来源:Infraservicenow
⚠️ 重要声明:本站所有文章均为原创技术文档,未经作者书面正式授权,严禁任何形式转载、复制、摘抄、二次发布。
如需转载、引用、整理发布,请务必提前联系作者获得授权,违者将依法追究侵权责任。
© 2026 Infraservicenow All Rights Reserved. 保留所有权利。