如何使用 Cloudflare 搭建 DDNS 服务

2025-4-14

利用 Cloudflare 构建稳定可靠的 DDNS 服务：完全指南

动态 DNS（DDNS）服务允许您将域名与动态变化的 IP 地址关联起来。这对于拥有动态公网 IP 的用户来说至关重要，例如使用家用宽带连接的用户。通过 DDNS，您可以轻松访问家中的服务器、网络摄像头、NAS 等设备，而无需记住不断变化的 IP 地址。Cloudflare 提供了一种简单而可靠的 DDNS 解决方案，本文将详细介绍如何使用 Cloudflare 构建自己的 DDNS 服务。

一、准备工作

在开始之前，您需要做好以下准备：

一个域名: 您需要拥有一个域名，并且该域名已经在 Cloudflare 上进行管理。如果您还没有域名，可以从域名注册商处购买一个。
Cloudflare 账户: 您需要一个 Cloudflare 账户，并将您的域名添加到 Cloudflare 中。
更新客户端: 您需要一个运行在您本地网络中的客户端，用于定期检测公网 IP 地址的变化并更新 Cloudflare DNS 记录。您可以选择多种客户端，包括：
- 脚本: 使用 Python、Bash 等脚本语言编写自定义脚本。
- 现成工具: 使用现成的 DDNS 客户端，例如 ddclient、cloudflare-ddns 等。
API Token: 需要创建 Cloudflare API Token 以授权更新客户端修改 DNS 记录。

二、获取 Cloudflare API Token

为了安全起见，建议创建一个具有最小权限的 API Token，仅授予其更新特定 DNS 记录的权限。以下是创建 API Token 的步骤：

登录 Cloudflare 账户。
点击左侧导航栏中的“我的个人资料”。
在“API Tokens”部分，点击“创建 Token”。
选择“编辑区域 DNS”模板。
在“区域资源”部分，选择您的域名，并选择“仅允许编辑”权限。
对于 "记录类型"，选择 "A" 和 "AAAA" (如果您使用 IPv6)。
在 "记录名称" 中，输入您想要更新的子域名，例如 "home"。
点击“继续”。
复制生成的 API Token 并妥善保存，因为它只会显示一次。

三、选择并配置 DDNS 更新客户端

1. 使用脚本 (Python 示例)

以下是一个使用 Python 和 requests 库的示例脚本：

```python
import requests
import json
import socket
import time

Cloudflare API 配置

ZONE_ID = "YOUR_ZONE_ID" # 替换为您的 Zone ID
RECORD_NAME = "home.yourdomain.com" # 替换为您的记录名称
API_TOKEN = "YOUR_API_TOKEN" # 替换为您的 API Token

def get_public_ip():
try:
with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:
s.connect(("8.8.8.8", 80))
return s.getsockname()[0]
except Exception as e:
print(f"获取公网 IP 失败: {e}")
return None

def update_cloudflare_dns(ip):
url = f"https://api.cloudflare.com/client/v4/zones/{ZONE_ID}/dns_records"
headers = {
"Authorization": f"Bearer {API_TOKEN}",
"Content-Type": "application/json"
}
data = {
"type": "A",
"name": RECORD_NAME,
"content": ip,
"ttl": 120
}

try:
response = requests.put(url, headers=headers, data=json.dumps(data))
response.raise_for_status()
print(f"DNS 记录更新成功: {ip}")
except requests.exceptions.RequestException as e:
print(f"DNS 记录更新失败: {e}")

if name == "main":
while True:
current_ip = get_public_ip()
if current_ip:
update_cloudflare_dns(current_ip)
time.sleep(300) # 每 5 分钟检查一次
```

2. 使用 ddclient

ddclient 是一款流行的 DDNS 客户端，支持多种 DDNS 服务提供商，包括 Cloudflare。您可以通过以下步骤配置 ddclient：

安装 ddclient: 根据您的操作系统，使用相应的包管理器安装 ddclient。例如，在 Debian/Ubuntu 系统上，可以使用 sudo apt-get install ddclient。
配置 ddclient: 编辑 /etc/ddclient.conf 文件，添加以下配置：

protocol=cloudflare use=web, ip=checkip.dyndns.org/ server=www.cloudflare.com login=YOUR_EMAIL_ADDRESS # 替换为您的 Cloudflare 邮箱地址 password=YOUR_API_TOKEN # 替换为您的 API Token yourdomain.com # 替换为您的域名 home.yourdomain.com # 替换为您的记录名称