跳至正文

ClickHouse Keeper 认证机制与安全配置指南

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),其他未携带相同账号密码的客户端无法修改或删除这些元数据。
  • TLS 双向证书认证(mTLS)

    • 原理:同时为 ClickHouse Keeper(开启 tcp_port_secure)和 ClickHouse Server 配置 SSL/TLS 证书及私钥路径。
    • 效果:不仅加密传输过程中的所有元数据流量,还会通过校验证书合法性来双向验证节点身份,彻底杜绝未授权节点接入。

🔒 原创版权声明

本文标题:ClickHouse Keeper 认证机制与安全配置指南

原文链接:https://www.infraserviceonline.com/clickhouse-keeper-%e8%ae%a4%e8%af%81%e6%9c%ba%e5%88%b6%e4%b8%8e%e5%ae%89%e5%85%a8%e9%85%8d%e7%bd%ae%e6%8c%87%e5%8d%97/

版权来源:Infraservicenow

⚠️ 重要声明:本站所有文章均为原创技术文档,未经作者书面正式授权,严禁任何形式转载、复制、摘抄、二次发布。

如需转载、引用、整理发布,请务必提前联系作者获得授权,违者将依法追究侵权责任。

© 2026 Infraservicenow All Rights Reserved. 保留所有权利。


发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

错误: Content is protected !!