adyanth/cloudflare-operator

Cloudflare Operator

概述

Cloudflare Operator是一个Kubernetes Operator，旨在通过自定义资源(CR/CRD)创建和管理Cloudflare Tunnels及DNS记录，支持HTTP/TCP/UDP（UDP处于早期访问阶段）服务资源。它自动化了***部署、配置管理和DNS条目维护，简化了在Kubernetes环境中通过Cloudflare暴露服务的流程。

核心功能与特性

Tunnel资源管理

• 通过自定义资源创建和使用Cloudflare Tunnels（适用于Cloudflare for Teams）
  • 接受Cloudflare API令牌和密钥的Secret
  • 运行可配置规模的*** Deployment
  • 管理*** Deployment的ConfigMap
  • 支持集群作用域和命名空间作用域的Tunnels

TunnelBinding控制器

• 自动更新*** ConfigMap以包含新服务
• 重启*** Deployment使配置变更生效
• 在Cloudflare中添加DNS条目（代理模式CNAME指向Tunnel）
• 使用Finalizers在TunnelBinding删除时自动清理配置和DNS记录

使用场景与适用范围

• 需要在Kubernetes集群中通过Cloudflare Tunnel安全暴露HTTP/TCP/UDP服务
• 动态管理服务暴露，实现服务部署/删除时自动更新Cloudflare配置
• 集中管理多服务的Cloudflare Tunnel和DNS设置
• 简化***部署和配置的维护流程，减少手动操作

架构概述

Cloudflare Operator通过以下组件协同工作：

• Tunnel控制器：管理Tunnel资源，负责创建*** Deployment、ConfigMap及Secret引用
• TunnelBinding控制器：监控TunnelBinding资源，更新配置并管理DNS记录
• ***** Deployment**：运行***代理，根据ConfigMap配置路由流量

operator与Tunnel资源的部署架构可参考官方架构图，核心流程为：通过Tunnel资源定义Tunnel基本配置，TunnelBinding资源关联Kubernetes Service与Tunnel，触发自动配置更新和DNS创建。

使用方法与配置说明

前置要求

• Kubernetes集群（支持CRD）
• Cloudflare API令牌（需具备Tunnel和DNS管理权限）
• kubectl工具

基本使用流程

1. 部署Operator

参考https://github.com/adyanth/cloudflare-operator/blob/main/docs/getting-started.md部署Operator组件。

2. 创建Cloudflare API Secret

yaml
apiVersion: v1
kind: Secret
metadata:
  name: cloudflare-api-credentials
  namespace: cloudflare-operator
type: Opaque
data:
  api-token: <base64编码的Cloudflare API令牌>

3. 创建Tunnel自定义资源

yaml
apiVersion: cloudflare.adyanth.site/v1alpha1
kind: Tunnel
metadata:
  name: example-tunnel
  namespace: default
spec:
  cloudflare:
    apiTokenSecret:
      name: cloudflare-api-credentials
      key: api-token
  replicas: 2  # 配置cloudflared部署副本数
  scope: Namespace  # 可选Cluster或Namespace

4. 创建TunnelBinding关联服务

yaml
apiVersion: cloudflare.adyanth.site/v1alpha1
kind: TunnelBinding
metadata:
  name: example-service-binding
  namespace: default
spec:
  tunnelRef:
    name: example-tunnel
  service:
    name: example-service  # 目标Kubernetes服务名称
    port: 80  # 服务端口
  dns:
    domain: app.example.com  # 要创建的Cloudflare DNS域名

注意事项

• 项目目前处于Alpha阶段，生产环境使用需谨慎
• UDP支持依赖Cloudflare Tunnel的https://blog.cloudflare.com/extending-cloudflares-zero-trust-platform-to-support-udp-and-internal-dns/
• 非Cloudflare官方产品，基于Cloudflare v4 API和***实现功能

相关资源

• https://github.com/adyanth/cloudflare-operator
• https://github.com/adyanth/cloudflare-operator/issues
• 架构详解博客