terraform-hcloud-kubernetes安全架构深度解析:防火墙、LUKS磁盘加密、NetworkPolicy与mTLS
terraform-hcloud-kubernetes安全架构深度解析:防火墙、LUKS磁盘加密、NetworkPolicy与mTLS
terraform-hcloud-kubernetes 是一个 Terraform 模块,用于在 Hetzner Cloud 上一键部署高可用、生产级且安全加固的 Talos Linux Kubernetes 集群。它的最大特点之一,就是把安全做成了"开箱即用"的默认配置:Hetzner Cloud 防火墙白名单访问、LUKS2 磁盘静态加密、Cilium NetworkPolicy 细粒度流量管控,以及基于 mTLS 的双向证书认证。本文带你从新手视角,逐层看懂这 4 道安全防线是如何协同工作的。
🛡️ 四层安全防线总览
在展开细节前,先建立整体认知。该模块的安全设计可以概括为"由外到内"的四层纵深防御:
| 层级 | 防护机制 | 保护对象 | 核心文件 |
|---|---|---|---|
| 1️⃣ 边界层 | Hetzner Cloud 防火墙 | 集群节点的所有外部端口 | firewall.tf |
| 2️⃣ 存储层 | LUKS2 磁盘加密 | 节点本地磁盘数据(静态数据) | talos_config_base.tf |
| 3️⃣ 网络层 | Cilium NetworkPolicy + WireGuard 加密 | Pod 间流量(传输中数据) | cilium.tf |
| 4️⃣ 认证层 | mTLS 双向证书认证 | Talos API / Kubernetes API 管理通道 | client.tf |
此外,节点操作系统本身采用不可变的 Talos Linux,没有 SSH 和 Shell,从根本上减少了攻击面。官方对安全设计的完整说明可参考 README.md。
🚧 防火墙:只放行指定来源的 Kube API 与 Talos API
默认行为:白名单式暴露
模块默认只向指定来源 IP 开放两个关键端口:
- Kubernetes API(端口 6443):
kubectl操作集群的入口 - Talos API(端口 50000):
talosctl管理节点系统的入口,见 talos.tf
关键逻辑在 firewall.tf 中:模块会把 firewall_kube_api_source / firewall_talos_api_source 变量定义的来源网段写入 Hetzner 防火墙规则。当这两个变量未设置且集群为 public 访问模式时,会自动查询你当前的公网 IPv4/IPv6 地址并加入白名单(firewall.tf),相当于"只允许我自己的机器访问管理端口"。
快速收紧访问来源
常用变量组合如下(定义于 variables.tf):
cluster_access:public(默认)或private,控制通过公网还是私网访问集群firewall_api_source:一次性为 Kube API 和 Talos API 指定来源网段,如你的办公网 CIDRfirewall_kube_api_source/firewall_talos_api_source:分别精细控制两个 API 的来源firewall_extra_rules:追加自定义防火墙规则,方向必须为in或out,协议支持tcp、udp、icmp、gre、esp,且内置了完善的参数校验
如果企业已有集中管理的防火墙,还可以通过 firewall_id 直接复用外部防火墙,模块只负责挂载到服务器(挂载逻辑见 server.tf)。
裸金属服务器:Robot 防火墙自动编排
当集群混入 Hetzner 裸金属节点时,由于裸金属不走 Cloud Firewall,模块会额外调用 Hetzner Robot API 逐台下发防火墙规则(firewall.tf),并自动处理规则数量上限(每个方向最多 10 条)、冲突重试(409 状态码轮询等待)与激活状态确认,确保裸金属节点同样只暴露 Talos API 端口并放行内网流量。
💽 LUKS 磁盘加密:节点数据默认静态加密
加密范围与默认开启
Talos 的 STATE 分区(保存集群证书、证书密钥等核心状态)和 EPHEMERAL 分区(运行时的临时数据)默认都启用 LUKS2 加密,对应变量 talos_state_partition_encryption_enabled 和 talos_ephemeral_partition_encryption_enabled,二者默认值均为 true(variables.tf)。
加密配置补丁在 talos_config_base.tf 中生成:指定加密提供方为 luks2,密钥使用 nodeID 派生——每个节点从自身唯一的 nodeID 派生出独立的加密密钥,这意味着即使 A 节点的磁盘被物理挪到 B 节点上,也无法解开数据。
为什么这很重要
- 防物理接触:磁盘被直接读出时,内容仍是密文
- 密钥隔离:密钥由节点身份派生,不依赖集中保管的密码
- 注意:对已有集群切换该开关需要按 Talos 官方文档手动操作密钥迁移,否则会破坏集群(变量描述中有明确警告)
🔐 mTLS:用双向证书代替密码和密钥文件
管理通道全部走双向 TLS
模块通过 talos_machine_secrets 资源生成整套集群密钥材料(talos.tf),包含 CA、客户端证书与私钥。talosctl 使用的 talosconfig 由 client.tf 自动组装:CA 证书 + 客户端证书 + 客户端私钥三要素齐备。
mTLS 与单向 TLS 的区别在于:服务器不仅验证客户端出示证书,客户端也会验证服务器证书。这带来两个直接收益:
- 杜绝中间人:你无法伪造一个假集群骗走证书
- 无需密码:没有 SSH 口令、没有长期 token 需要保管,证书即身份
访问控制链路
talosctl ──(mTLS, 50000)──▶ Talos API ──▶ 节点系统
kubectl ──(双向证书, 6443)──▶ kube-apiserver ──▶ 集群资源
kubeconfig 同样由 talos_cluster_kubeconfig 资源自动签发(client.tf),并支持通过 cluster_kubeconfig_path 和 cluster_talosconfig_path 直接导出到本地文件,配合前文的防火墙白名单,形成"网络层 + 认证层"的双重把关。
🚦 NetworkPolicy 与 Pod 流量加密:内网同样不放水
Cilium 作为网络策略执行引擎
集群使用 Cilium 作为 CNI,由 cilium.tf 通过 Helm 统一配置。Kubernetes NetworkPolicy 由 Cilium 在 eBPF 层面高效执行,可以对 Pod 之间的出入流量做命名空间、标签级的细粒度管控——比如默认只允许前端访问后端,后端访问数据库。
传输中加密默认开启
cilium_encryption_enabled 默认为 true(variables.tf),Pod 间流量默认使用 WireGuard 透明加密;如偏好 IPsec,可将 cilium_encryption_type 设为 ipsec,模块会随集群自动生成随机 IPSec 密钥并注入 cilium-ipsec-keys Secret(cilium.tf)。
一个小而实用的技巧
如果你希望用 NetworkPolicy 直接针对节点(例如锁定 kube-apiserver 所在节点),需要把 cilium_policy_cidr_match_mode 设为 "nodes"(variables.tf),这样 Cilium 才允许用 CIDR 段匹配节点实体。
🧱 其他值得了解的安全默认值
- 不可变 OS:Talos Linux 无 SSH、无 Shell,配置即代码,杜绝配置漂移
- Seccomp 默认启用:kubelet 为所有容器默认启用 seccomp 安全配置(talos_config_base.tf)
- 控制面高可用约束:控制面节点数量强制为奇数且不超过 9,保证 quorum 可用性(variables.tf)
- 删除保护:
cluster_delete_protection默认为true,防止误删核心资源 - 合规基线:Talos 遵循 NIST 容器安全指南与 CIS Kubernetes 基准加固标准
📋 常用安全变量速查清单
| 变量 | 默认值 | 作用 |
|---|---|---|
cluster_access |
public |
公网 / 内网访问模式 |
firewall_api_source |
自动探测本机 IP | Kube + Talos API 白名单来源 |
talos_state_partition_encryption_enabled |
true |
STATE 分区 LUKS2 加密 |
talos_ephemeral_partition_encryption_enabled |
true |
EPHEMERAL 分区 LUKS2 加密 |
cilium_encryption_enabled |
true |
Pod 流量透明加密 |
cilium_encryption_type |
wireguard |
加密协议,可选 ipsec |
cluster_delete_protection |
true |
资源删除保护 |
🎯 总结
terraform-hcloud-kubernetes 的安全架构可以一句话概括:防火墙管边界、LUKS 管磁盘、Cilium 管内网、mTLS 管身份。四条防线全部默认开启、无需额外配置,同时又通过变量暴露了足够的调节空间。对于新手而言,这意味着你不需要成为安全专家,也能在 Hetzner Cloud 上获得一个生产级安全基线的 Kubernetes 集群;对于进阶用户,前文列出的变量和源码位置(firewall.tf、talos_config_base.tf、cilium.tf、client.tf)则是深入定制与审计的最佳起点。