csmax/ddns

镜像概述

本镜像为Cloudflare DNS更新工具，可根据Docker容器的公网IP地址自动更新Cloudflare平台上的DNS记录，适用于IP地址动态变化的场景。

核心功能

• 自动检测容器所在环境的公网IP地址
• 定期同步公网IP至指定的Cloudflare DNS记录
• 轻量容器化部署，资源占用低

使用场景

• 家庭服务器或小型服务需要动态DNS解析的场景
• 依赖Cloudflare DNS服务且IP地址频繁变化的个人/小型项目
• 需要自动化维护DNS记录的环境

配置说明

需通过环境变量配置Cloudflare相关参数（示例中为常见配置项）：

• CF_API_TOKEN: Cloudflare API令牌（需具备DNS编辑权限）
• DOMAIN: 目标域名（如example.com）
• RECORD_TYPE: DNS记录类型（如A/AAAA）
• RECORD_NAME: 子域名记录（如sub.example.com）

部署示例

Docker Run命令

bash
docker run -d \
  --name cloudflare-ddns \
  -e CF_API_TOKEN="your_cloudflare_api_token" \
  -e DOMAIN="example.com" \
  -e RECORD_TYPE="A" \
  -e RECORD_NAME="home.example.com" \
  csmax/ddns

Docker Compose配置

yaml
version: '3'
services:
  ddns:
    image: csmax/ddns
    environment:
      - CF_API_TOKEN=your_cloudflare_api_token
      - DOMAIN=example.com
      - RECORD_TYPE=A
      - RECORD_NAME=home.example.com
    restart: always