gperiard/cloudflare-ddns

Cloudflare DDNS镜像

镜像概述

本镜像为Cloudflare动态DNS（DDNS）工具，支持通过自定义域名远程访问家庭网络，无需静态IP。镜像体积小巧、注重隐私保护且运行高效，适用于多架构环境（如树莓派），助力去中心化互联网部署。

核心功能

1. 每5分钟自动获取公网IPv4和IPv6地址，并更新Cloudflare DNS记录；
2. 自动清理过时、重复的DNS记录；
3. 支持API令牌或传统API密钥两种认证方式；
4. 可灵活启用/禁用IPv4（A记录）或IPv6（AAAA记录）；
5. 基于Alpine Linux，使用HTTPS通信，开源可审计。

使用场景

• 家庭网络远程访问：通过自定义域名访问家中NAS、服务器等设备；
• 多子域名管理：为多个子域名自动更新DNS记录；
• 多域名（Zone）支持：同一容器处理多个Cloudflare域名的DDNS更新；
• 低功耗设备部署：轻量镜像适合树莓派等资源有限的环境。

配置说明

认证方式

API令牌（推荐）

前往https://dash.cloudflare.com/profile/api-tokens创建具备**Edit DNS**权限的令牌，填入config.json：

json
"authentication": {
  "api_token": "你的Cloudflare API令牌（需含Edit DNS权限）"
}

传统API密钥

设置API密钥和账户***：

json
"authentication": {
  "api_key": {
    "api_key": "你的Cloudflare API密钥",
    "account_email": "Cloudflare登录邮箱"
  }
}

IPv4/IPv6设置

根据ISP支持情况启用/禁用：

json
"a": true,  // 启用IPv4记录
"aaaa": true // 启用IPv6记录

其他配置项

json
"zone_id": "域名Zone ID（Cloudflare控制台域名概览页右侧获取）",
"subdomains": ["", "sub1", "sub2"], // 子域名列表（空字符串表示主域名）
"proxied": false // 是否启用Cloudflare代理（启用则可能无法使用SSH）

Docker部署示例

Docker Compose配置

yaml
version: "3.7"
services:
  cloudflare-ddns:
    image: docker.xuanyuan.run/gperiard/cloudflare-ddns:latest
    container_name: cloudflare-ddns
    security_opt:
      - no-new-privileges:true
    network_mode: "host"
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - /你的路径/config.json:/config.json
    restart: unless-stopped

运行命令

bash
docker-compose up -d

注意：若需支持IPv6，需将network_mode设为host。