mysticaltech/terraform-hcloud-kube-hetzner

这是什么？

核心功能

• 01在 openSUSE Leap Micro 节点上部署 k3s 或 RKE2 集群。
• 02支持高可用控制平面和跨多个机房的节点池。
• 03集成私有网络、防火墙、CSI 存储和 Ingress。
• 04提供 Flannel、Calico 或 Cilium 网络方案，支持纯私网 NAT 部署。
• 05支持 Cluster Autoscaler 节点池和升级流程。

适用场景

• 在 Hetzner Cloud 上以较低成本运行类生产环境的 Kubernetes 集群。
• 搭建仅含单个控制平面的小型开发集群。
• 以可审查的 Terraform 或 OpenTofu 代码管理集群基础设施。

快速上手

1. 1

   用 Homebrew 安装 OpenTofu、kubectl 和 hcloud

   brew install opentofu kubectl hcloud
2. 2

   创建 Hetzner Cloud 项目、读写权限的 API 令牌和无密码短语的 SSH 密钥

3. 3

   运行 README 中的 create 脚本，生成项目文件夹、kube.tf 和 Leap Micro 镜像

4. 4

   编辑 kube.tf，然后在项目文件夹中初始化项目

   tofu init --upgrade

使用前须知

• !仅适用于 Hetzner Cloud，部署会创建需要付费的云资源。
• !需要 Terraform 或 OpenTofu、Packer 以及带 API 令牌的 Hetzner Cloud 账户。

标签

常见问题

terraform-hcloud-kube-hetzner 是什么？

基于 Terraform/OpenTofu 的模块，在 Hetzner Cloud 上通过一份配置部署 k3s 或 RKE2 Kubernetes 集群。 Kube-Hetzner 是一个 Terraform 与 OpenTofu 模块，用于在 Hetzner Cloud 上创建 Kubernetes 集群。默认使用 k3s，也可选择 RKE2，节点运行在 openSUSE Leap Micro 系统上。部署过程中会自动配置私有网络、防火墙、CSI 存储、Ingress、证书管理、系统更新和 Kubernetes 升级。

terraform-hcloud-kube-hetzner 可以免费使用吗？用的什么许可证？

terraform-hcloud-kube-hetzner 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

terraform-hcloud-kube-hetzner 还在维护吗？

活跃维护中。terraform-hcloud-kube-hetzner 最近一次提交是在 2026年10月30日。

terraform-hcloud-kube-hetzner 适合用来做什么？

在 Hetzner Cloud 上以较低成本运行类生产环境的 Kubernetes 集群。 搭建仅含单个控制平面的小型开发集群。 以可审查的 Terraform 或 OpenTofu 代码管理集群基础设施。

terraform-hcloud-kube-hetzner 怎么安装和运行？

用 Homebrew 安装 OpenTofu、kubectl 和 hcloud: brew install opentofu kubectl hcloud 创建 Hetzner Cloud 项目、读写权限的 API 令牌和无密码短语的 SSH 密钥 运行 README 中的 create 脚本，生成项目文件夹、kube.tf 和 Leap Micro 镜像 编辑 kube.tf，然后在项目文件夹中初始化项目: tofu init --upgrade

在哪里获取 terraform-hcloud-kube-hetzner？

源代码和安装说明在 GitHub 上：https://github.com/mysticaltech/terraform-hcloud-kube-hetzner