Kubernetes 环境下 ClickHouse Keeper 安全加固指南
在默认配置下,独立部署的 ClickHouse Keeper(端口 9181)采用免密信任模式。在多租户或混布的 Kubernetes 集群中,其他命名空间的任意 Pod 均可通过内网域名直接连接并操作 Keeper 元数据(存在误删或覆盖分片、副本状态的风险)。
本文档提供网络层隔离(NetworkPolicy)与应用层鉴权(Digest ACL)两道生产级安全防线,可单独或叠加使用。
一、 双重安全防线对比
| 防护维度 | 实现方案 | 核心作用 | 性能损耗 | 生效时机 |
|---|---|---|---|---|
| 第一道:网络层隔离 (强烈推荐) |
Kubernetes NetworkPolicy |
从网络底层白名单锁死 9181 和 9444 端口,阻断非授权 Pod 的 TCP 连接请求。 |
零损耗 | kubectl apply 后秒级生效,无需重启任何 Pod。 |
| 第二道:应用层鉴权 (合规双保险) |
ZooKeeper Digest ACL 账号密码 |
为 ClickHouse Server 创建的元数据目录绑定专属账密锁,无匹配凭证无法修改或删除。 | 极低(仅建连与写节点时校验) | 仅对开启后新建的元数据路径生效(建议在建业务表前配置)。 |
二、 防线一:配置 K8s 网络策略隔离 (keeper-networkpolicy.yaml)
通过以下网络策略,精确限制只有同命名空间下带有 app: clickhouse 标签的计算节点才能访问 Keeper 的 9181 客户端端口,且仅允许 Keeper 集群内部节点互连 9444 Raft 端口。
(注:需确保集群 CNI 网络插件支持 NetworkPolicy,如 Cilium、Calico 等。)
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
name: restrict-clickhouse-keeper
namespace: test-clickhouse
spec:
podSelector:
matchLabels:
app: clickhouse-keeper
policyTypes:
- Ingress
ingress:
# 1. 仅放行同命名空间下的 ClickHouse Server 访问 9181 客户端端口
- from:
- podSelector:
matchLabels:
app: clickhouse
ports:
- protocol: TCP
port: 9181
# 2. 仅放行 Keeper 集群内部节点之间互连 9444 Raft 同步端口
- from:
- podSelector:
matchLabels:
app: clickhouse-keeper
ports:
- protocol: TCP
port: 9444
执行生效命令:
kubectl apply -f keeper-networkpolicy.yaml
三、 防线二:开启 Keeper 账号密码鉴权 (clickhouse-cm-keeper.yaml)
ClickHouse Keeper 原生支持 ZooKeeper 的 digest 认证协议。只需在 ClickHouse Server 的连接配置中添加 ` 标签(格式为用户名:密码`),服务端无需修改任何配置。
apiVersion: v1
kind: ConfigMap
metadata:
name: clickhouse-keeper
namespace: test-clickhouse
labels:
app: test-clickhouse
data:
zookeeper.xml: |-
<yandex>
<zookeeper>
<!-- 开启 Digest 鉴权:Server 创建表结构与副本路径时自动锁定访问权限 -->
clickhouse_admin:KeeperPass@2026
<node index="1">
<host>clickhouse-keeper-0.clickhouse-keeper</host>
<port>9181</port>
</node>
<node index="2">
<host>clickhouse-keeper-1.clickhouse-keeper</host>
<port>9181</port>
</node>
<node index="3">
<host>clickhouse-keeper-2.clickhouse-keeper</host>
<port>9181</port>
</node>
</zookeeper>
</yandex>
四、 生产环境最佳实践与避坑提示
- 严禁对外暴露控制面端口:确保
clickhouse-keeper的 Service 始终保持为clusterIP: None(Headless),切勿通过NodePort或LoadBalancer将9181和9444暴露到集群外部。 - 存量路径权限说明:“ 配置仅对启用后新创建的 ZNode 目录(如后续新建的正式日志表路径)添加访问控制列表(ACL)。若需为旧表补充权限锁,需在测试阶段重建测试表即可。
- 测试隔离效果:应用
NetworkPolicy后,可在其他命名空间(如default)的任意 Pod 中执行nc -zv -w 3 clickhouse-keeper.test-clickhouse 9181,若返回连接超时(Timeout),即证明网络层隔离已成功拦截非授权访问。
🔒 原创版权声明
本文标题:Kubernetes 环境下 ClickHouse Keeper 安全加固指南
版权来源:Infraservicenow
⚠️ 重要声明:本站所有文章均为原创技术文档,未经作者书面正式授权,严禁任何形式转载、复制、摘抄、二次发布。
如需转载、引用、整理发布,请务必提前联系作者获得授权,违者将依法追究侵权责任。
© 2026 Infraservicenow All Rights Reserved. 保留所有权利。