跳至正文

Kubernetes 环境下 ClickHouse Keeper 安全加固指南

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>

四、 生产环境最佳实践与避坑提示

  1. 严禁对外暴露控制面端口:确保 clickhouse-keeper 的 Service 始终保持为 clusterIP: None(Headless),切勿通过 NodePort 或 LoadBalancer 将 9181 和 9444 暴露到集群外部。
  2. 存量路径权限说明:“ 配置仅对启用后新创建的 ZNode 目录(如后续新建的正式日志表路径)添加访问控制列表(ACL)。若需为旧表补充权限锁,需在测试阶段重建测试表即可。
  3. 测试隔离效果:应用 NetworkPolicy 后,可在其他命名空间(如 default)的任意 Pod 中执行 nc -zv -w 3 clickhouse-keeper.test-clickhouse 9181,若返回连接超时(Timeout),即证明网络层隔离已成功拦截非授权访问。

🔒 原创版权声明

本文标题:Kubernetes 环境下 ClickHouse Keeper 安全加固指南

原文链接:https://www.infraserviceonline.com/kubernetes-%e7%8e%af%e5%a2%83%e4%b8%8b-clickhouse-keeper-%e5%ae%89%e5%85%a8%e5%8a%a0%e5%9b%ba%e6%8c%87%e5%8d%97/

版权来源:Infraservicenow

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

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

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


发表回复

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

错误: Content is protected !!