【亲测免费】 DdnsOnCloudFlare 使用教程

本教程旨在指导您如何高效地使用 DdnsOnCloudFlare 这一开源项目，以实现基于CloudFlare的动态DNS更新。此项目简化了将个人域名与动态IP地址绑定的过程，适合家庭服务器或个人项目中保持访问地址的稳定性。以下是核心内容概览：

1. 项目目录结构及介绍

DdnsOnCloudFlare/
├── README.md          # 项目说明文件，包含基本的安装和使用步骤。
├── ddns.py            # 主程序文件，执行动态DNS更新的核心逻辑。
├── config.example.yaml # 配置模板文件，用于自定义CloudFlare API信息和其他设置。
├── requirements.txt   # Python依赖文件，列出运行项目所需的库。
└── utils/             # 辅助脚本或工具模块，可能包括一些通用函数或类。

• README.md 文件提供了快速入门指南，是了解项目如何工作的起点。
• ddns.py 是项目的启动文件，包含了与CloudFlare API交互并更新DNS记录的主要逻辑。
• config.example.yaml 提供了一个配置文件模板，用户应复制该文件并命名为config.yaml，然后根据自己的需求进行编辑。

2. 项目的启动文件介绍

• ddns.py

  启动文件负责整个动态DNS更新的流程。它通过读取配置文件来获取必要的认证信息（如CloudFlare的API Token）以及要更新的域名和记录类型。之后，程序会检查本地IP与CloudFlare上记录的IP是否一致，如果不一致，则自动更新域名指向的新IP地址。该脚本设计为可定期执行，例如通过CRON作业在后台自动化运行。

3. 项目的配置文件介绍

• config.example.yaml

  配置文件是项目个性化设置的关键，以下为一个简化的示例结构：

  cloudflare:
    token: 'YOUR_API_TOKEN_HERE'
    zone: 'example.com' # 您的域名
    record: 'subdomain.example.com' # 要更新的子域或主域
    record_type: 'A' # 或者'CNAME'，取决于您的需求
  
  ip_provider: 'default' # 可选，默认使用内置的IP解析方式
  
  update_interval_minutes: 5 # 更新检查间隔，单位为分钟
  

  • cloudflare.token: CloudFlare API令牌，确保具有足够的权限去修改DNS记录。
  • zone: 要操作的顶级域名。
  • record: 要更新的具体DNS记录名称，比如是“www”、“@”(代表根域名)，或其他子域名。
  • record_type: 记录类型，通常对于动态DNS，“A”是最常见的选择。
  • ip_provider: 用于获取当前公网IP的提供商，这里默认使用内部方法。
  • update_interval_minutes: 设置多长时间检查并尝试更新一次DNS记录。

完成配置后，只需确保Python环境已准备好相应的依赖，并且按照 README 中的指示执行 ddns.py，即可开始动态DNS服务的运作。务必替换示例配置中的占位符，以匹配您的实际设置。