tcousin/cloudflare-ddns

Cloudflare动态DNS Docker镜像文档

镜像概述

本Docker镜像提供Cloudflare动态DNS（DDNS）解决方案，通过定期检测本地公网IP地址变化，自动调用Cloudflare API更新指定域名的DNS记录（A/AAAA），适用于无固定公网IP环境下的域名解析管理，确保外部访问始终指向当前有效IP。

核心功能和特性

• IP自动检测：支持IPv4（A记录）和IPv6（AAAA记录）地址自动检测
• Cloudflare API集成：基于Cloudflare API v4实现安全可靠的DNS记录更新
• 灵活配置：可自定义更新频率、记录类型、检测超时等参数
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低
• 多记录支持：支持同一Zone下多个域名记录的批量更新
• 日志监控：详细日志输出，便于问题排查和运行状态监控

使用场景和适用范围

• 家庭网络服务：NAS、家庭服务器、智能家居设备的域名访问
• 动态IP环境：宽带网络无固定公网IP时，确保域名解析持续有效
• 开发者测试：本地开发环境通过域名对外暴露服务
• 远程访问：远程桌面、文件共享等服务的域名访问保障

使用方法和配置说明

前置条件

1. 拥有Cloudflare账号及托管在Cloudflare的域名
2. 获取Cloudflare API令牌（需包含Zone.DNS编辑权限）
3. 获取目标域名的Zone ID（在Cloudflare域名管理页面"概述"中查看）

Docker Run 命令示例

bash
docker run -d \
  --name cloudflare-ddns \
  --restart unless-stopped \
  -e CF_API_TOKEN="your_cloudflare_api_token" \
  -e CF_ZONE_ID="your_cloudflare_zone_id" \
  -e CF_RECORD_NAME="example.com,sub.example.com" \
  -e CF_RECORD_TYPE="A" \
  -e UPDATE_INTERVAL="300" \
  cloudflare-ddns

Docker Compose 配置示例

yaml
version: '3'
services:
  cloudflare-ddns:
    image: cloudflare-ddns
    container_name: cloudflare-ddns
    restart: unless-stopped
    environment:
      - CF_API_TOKEN=your_cloudflare_api_token
      - CF_ZONE_ID=your_cloudflare_zone_id
      - CF_RECORD_NAME=example.com,sub.example.com  # 多个记录用逗号分隔
      - CF_RECORD_TYPE=A  # A(IPv4)或AAAA(IPv6)
      - UPDATE_INTERVAL=300  # 更新间隔（秒），默认300
      - IP_DETECT_URL=https://api.ipify.org  # 自定义IP检测接口（可选）
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error（可选，默认info）

配置参数说明

注意：CF_API_TOKEN需通过Cloudflare控制台创建，路径：个人资料 > API令牌 > 创建令牌 > 选择"编辑DNS"模板，指定目标Zone权限。