utopiaplanitia/flarectl

utopiaplanitia/flarectl镜像说明

镜像概述

utopiaplanitia/flarectl镜像集成了Cloudflare官方的flarectl命令行工具及自定义脚本，旨在根据Kubernetes Pod的生命周期事件（创建、删除）动态管理节点IP，实现IP的自动添加、移除与清理，适用于需要与Cloudflare服务联动的集群场景。

核心功能

1. 生命周期联动：根据Pod的创建/删除事件触发flarectl命令，更新节点IP列表；
2. IP管理：支持节点IP的添加、删除操作；
3. 清理机制：定期清理无效或过期的节点IP，保障IP列表的准确性。

使用场景

• Kubernetes集群中需动态更新Cloudflare IP白名单的场景；
• 集群节点与Cloudflare服务通信时的IP动态管理需求；
• 需要自动化维护节点IP的云原生环境。

配置说明

需配置以下环境变量以授权flarectl访问Cloudflare服务：

• CF_API_TOKEN：Cloudflare API令牌（需具备IP管理权限）；
• CF_ACCOUNT_ID：Cloudflare账户ID；
• CF_ZONE_ID（可选）：目标Zone ID（若需针对特定域名操作）。

部署示例

Docker Run命令

bash
docker run -d \
  -e CF_API_TOKEN="your_cloudflare_api_token" \
  -e CF_ACCOUNT_ID="your_cloudflare_account_id" \
  utopiaplanitia/flarectl

Docker Compose示例

yaml
version: "3"
services:
  flarectl:
    image: utopiaplanitia/flarectl
    environment:
      - CF_API_TOKEN=your_cloudflare_api_token
      - CF_ACCOUNT_ID=your_cloudflare_account_id
    restart: always