Cloudflare-DDNS 使用指南

Cloudflare-DDNS 使用指南

cloudflare-ddnsScript for dynamically updating a CloudFlare DNS record. (Deprecated)项目地址:https://gitcode.com/gh_mirrors/cloud/cloudflare-ddns

项目概述

Cloudflare-DDNS 是一个用于自动同步本地 IP 地址至 Cloudflare DNS 记录的开源工具。通过该工具，用户可以确保其域名始终指向正确的公共 IP 地址，非常适合动态 IP 用户以保持网站或应用的连续访问性。

项目目录结构及介绍

以下是 cloudflare-ddns 项目的基本目录结构及其简要说明：

cloudflare-ddns/
├── README.md             # 项目说明文档
├── LICENSE               # 开源许可证
├── requirements.txt      # Python 依赖列表
├── cloudflare_ddns.py    # 主程序文件
├── config.example.ini     # 配置文件示例
└── utils/                 # 工具模块
    ├── __init__.py
    └── ...                # 其他辅助脚本或函数

• README.md: 项目的快速入门和基本信息。
• LICENSE: 项目遵循的开源协议，详细规定了软件的使用权限和限制。
• requirements.txt: 列出了运行项目所需的所有Python库和版本。
• cloudflare_ddns.py: 核心脚本，实现了与Cloudflare API交互、检查并更新DNS记录的功能。
• config.example.ini: 提供了一个配置文件模板，用户需要根据自己的需求修改此文件后使用。
• utils/: 包含各种辅助功能的模块或脚本。

项目的启动文件介绍

主要启动文件：cloudflare_ddns.py

这是一个Python脚本，用户执行此文件即可运行Cloudflare-DDNS服务。它负责读取配置文件(config.ini)中的信息，并利用这些信息查询当前公网IP地址，对比Cloudflare上设定的DNS记录，如果发现不匹配，则自动更新DNS记录到最新IP。通常，这个过程会被设计为定期执行的任务（如通过定时任务cron）来保证IP地址的实时性。

运行命令示例

在安装了所有必需的依赖之后，可以通过以下命令运行项目：

python cloudflare_ddns.py

确保替换上述命令路径以匹配你的实际项目位置。

项目的配置文件介绍

配置文件：config.ini（基于config.example.ini自定义）

配置文件是Cloudflare-DDNS的关键部分，它定义了所有的操作参数，包括但不限于API密钥、邮箱、域名等。下面是配置文件中常见的几个重要字段：

[SETTINGS]
email = your_email@example.com          # Cloudflare 账户邮箱
api_key = your_api_key_here              # Cloudflare API 密钥
zone_id = your_zone_identifier           # 目标域名的Zone ID
record_name = subdomain.yourdomain.com   # 要更新的子域名或裸域名
ip_service = http://ipv4.icanhazip.com    # 查询当前公网IP的服务URL，可选

[TIMING]
update_interval = 60                    # 更新间隔时间，单位为分钟，默认每60分钟检查一次

• email: 登录Cloudflare账户的电子邮箱地址。
• api_key: 在Cloudflare账户设置的API密钥。
• zone_id: 需要更新DNS记录的域名对应的Zone ID，可以在Cloudflare控制台找到。
• record_name: 指定你要更新的DNS记录名称，可以是子域名或主域名。
• ip_service: 可选，默认使用的公网IP查询服务，用于获取当前机器的外网IP地址。
• update_interval: 自动更新DNS记录的时间间隔，可以根据个人需要调整。

在开始使用之前，务必用自己的真实数据替换上述配置项，并保存为config.ini。

---

以上就是关于Cloudflare-DDNS项目的基础介绍，包括其目录结构、启动文件以及配置文件的概览。正确配置和理解这些要素对于成功部署和运用此工具至关重要。

cloudflare-ddnsScript for dynamically updating a CloudFlare DNS record. (Deprecated)项目地址:https://gitcode.com/gh_mirrors/cloud/cloudflare-ddns