在Kube-Hetzner项目中创建纯私有集群的注意事项

Kube-Hetzner是一个基于Terraform的Hetzner云Kubernetes集群部署工具，近期有用户反馈在创建纯私有集群时遇到了节点仍然分配公网IP的问题。本文将深入分析这一现象的原因和解决方案。

问题现象

当用户尝试在Kube-Hetzner项目中创建纯私有集群时，即使设置了disable_ipv4 = true和disable_ipv6 = true参数，节点仍然会被分配公网IP地址。这种情况发生在使用2.17.0版本时，而切换到主分支代码则可以正常工作。

技术分析

版本差异

问题的核心在于不同版本对Hetzner云服务器公网接口配置的处理方式不同：

• 2.17.0版本：生成的Terraform资源定义中缺少public_net配置块，导致Hetzner云默认分配公网IP
• 主分支版本：正确生成了public_net配置块，并明确设置了ipv4_enabled = false和ipv6_enabled = false

底层机制

在Hetzner云平台中，创建服务器时可以显式控制是否启用公网IP。Terraform的Hetzner Provider通过public_net块来实现这一控制：

public_net {
  ipv4_enabled = false
  ipv6_enabled = false
}

当这个配置块缺失时，Hetzner云会默认分配公网IP地址，即使节点只需要在私有网络内通信。

解决方案

临时解决方案

对于急需部署的用户，可以采用以下方法之一：

1. 使用项目的主分支代码而非发布版本
2. 手动修改生成的Terraform配置，添加public_net块

长期解决方案

项目已在v2.17.1版本中修复了这一问题。建议用户升级到最新稳定版本以获得完整功能支持。

最佳实践

在Kube-Hetzner中创建纯私有集群时，应注意以下几点：

1. 版本选择：确保使用v2.17.1或更高版本
2. 网络规划：合理设置network_ipv4_cidr确保有足够的IP空间
3. 网络访问配置：虽然节点不需要公网IP，但通常需要配置网络网关或专用通道实现出站访问
4. 负载均衡器：设置control_plane_lb_enable_public_interface = false确保负载均衡器也是纯私有的

总结

Kube-Hetzner项目在v2.17.1版本中完善了对纯私有集群的支持。通过正确配置disable_ipv4和disable_ipv6参数，用户可以创建完全隔离在私有网络中的Kubernetes集群，既提高了安全性，又能节省公网IP资源成本。对于生产环境部署，建议始终使用最新的稳定版本以获得最佳的功能支持和稳定性。