【亲测免费】 Synology Cloudflare DDNS 使用手册

1. 目录结构及介绍

本节将概述SynologyCloudflareDDNS项目的主要目录结构及其重要文件的功能简介。

├── README.md                 # 项目的核心说明文档，包含安装步骤和快速使用指南。
├── cloudflare_ddns.py        # 核心脚本，实现了与Cloudflare API的交互以更新DNS记录。
├── requirements.txt          # Python依赖列表，用于确保环境具有运行脚本所需的所有库。
├── setup.py                  # 可选，可能用于打包或安装项目的脚本。
└── example_config.ini         # 配置文件示例，展示了如何设置您的Cloudflare认证信息和域名。

• README.md 是用户首先接触的文档，详细说明了项目的功能、安装过程和基本用法。
• cloudflare_ddns.py 是实际执行DNS更新操作的脚本，它通过API与Cloudflare通信。
• requirements.txt 列出了运行脚本所需的Python库版本，如requests等。
• setup.py（假设存在）通常用于项目的安装，但在这个上下文中可能不是必需的。
• example_config.ini 提供了一个配置模板，帮助用户正确设置他们的Cloudflare凭据和目标域名。

2. 项目的启动文件介绍

云flare_DDNS启动流程 关键在于cloudflare_ddns.py文件：

• 手动执行: 用户可以通过命令行直接调用此脚本，例如在Synology NAS或其他支持Python环境的系统中执行 python cloudflare_ddns.py。但这之前需确保所有先决条件已满足，包括正确的配置文件和必要的Python环境设置。

• 自动化调度: 对于持续的DNS同步需求，推荐使用cron作业或者Synology NAS的计划任务来定期运行该脚本，确保DNS记录始终反映主机的实际IP地址变化。

3. 项目的配置文件介绍

配置文件（example_config.ini) 的关键部分提供了与Cloudflare进行交互所需的详细参数：

[cf_settings]
api_token = YOUR_CLOUDFLARE_API_TOKEN  # 必填，Cloudflare API令牌。
zones = domain1.com,domain2.com      # 列出要更新的域名，用逗号隔开。

[main]
check_ip_service = ifconfig.me       # 可选，用于检查当前公共IP的服务地址。
log_file = log.txt                     # 日志文件位置，记录执行情况。
interval = 600                        # 更新间隔，单位秒，默认10分钟。

• [cf_settings] 区块包含了访问Cloudflare API的关键信息。
• [main] 区块定义了运行脚本的行为，比如IP检查服务、日志记录位置和自动更新的频率。

确保替换YOUR_CLOUDFLARE_API_TOKEN和其他占位符，以符合你的具体设置，并且根据需要调整其他配置选项。

这个文档仅提供了一个基础框架，详细的使用和调试可能还需要参考最新的项目文档和源码注释。务必遵守最佳安全实践，妥善管理API密钥。