Cloudflare DDNS：轻松实现动态域名解析 – wiki基地

作者： /

Cloudflare DDNS：轻松实现动态域名解析

在当今的互联网世界中，许多家庭和小型办公室的网络连接都通过动态IP地址接入。这意味着您的公共IP地址会定期改变，这给需要从外部访问本地资源（如家庭服务器、网络摄像头或NAS）的用户带来了挑战。每次IP地址变更后，您都不得不手动更新DNS记录，以确保您的域名能正确指向新的IP地址。

这就是动态域名解析（DDNS）发挥作用的地方。而结合强大的Cloudflare平台，您可以轻松、高效地实现这一目标。

什么是动态域名解析（DDNS）？

动态域名解析（DDNS）是一项服务，它允许您将一个域名（例如 home.yourdomain.com）与一个动态变化的IP地址关联起来。当您的互联网服务提供商（ISP）更改您的公共IP地址时，DDNS客户端会自动检测到这一变化，并向DDNS服务提供商（在本例中是Cloudflare）发送更新请求，从而确保您的域名始终指向您当前的IP地址。

为什么选择 Cloudflare 实现 DDNS？

Cloudflare 不仅提供免费的DNS服务，还以其卓越的性能、安全性和全球网络而闻名。通过将您的域名托管在 Cloudflare 上，并利用其强大的API，您可以：

  • 免费使用： Cloudflare 的核心DNS服务是免费的，非常适合个人和小型项目。
  • 全球CDN和安全性： 即使您仅使用其DNS功能，您的域名也受益于Cloudflare的全球Anycast网络和DDoS防护。
  • 可靠的API： Cloudflare 提供功能强大且文档完善的API，使得自动化任务（如DDNS更新）变得轻而易举。
  • 快速传播： Cloudflare 的DNS记录更新通常在全球范围内迅速生效。

设置 Cloudflare DDNS：分步指南

以下是使用Cloudflare实现动态域名解析的详细步骤：

步骤 1: 获取 Cloudflare API 凭证

要通过脚本与Cloudflare API交互，您需要以下信息：

  1. Cloudflare API Token:

    • 登录您的 Cloudflare 账户。
    • 导航至 “我的个人资料” (My Profile) -> “API Token”。
    • 点击 “创建 Token” (Create Token)。
    • 选择 “编辑区域 DNS” (Edit zone DNS) 模板，这将授予此Token修改DNS记录的权限。
    • 为您的Token命名（例如 “DDNS Updater”），并选择它能访问的特定区域（您的域名）。
    • 创建并立即复制此Token。请务必妥善保管，因为创建后便无法再次查看。

  2. Zone ID:

    • 在 Cloudflare 仪表板中，选择您要配置DDNS的域名。
    • 在域名 “概览” (Overview) 页面的右侧，您可以找到 “区域 ID” (Zone ID)。复制此ID。

  3. DNS Record ID:

    • 您需要获取您希望动态更新的特定DNS A记录的ID（例如 home.yourdomain.com 对应的A记录）。
    • 您可以通过Cloudflare API来查询：
      bash
      curl -X GET "https://api.cloudflare.com/client/v4/zones/<YOUR_ZONE_ID>/dns_records?type=A&name=your.domain.com" \
      -H "X-Auth-Email: <YOUR_CLOUDFLARE_EMAIL>" \
      -H "Authorization: Bearer <YOUR_API_TOKEN>" \
      -H "Content-Type: application/json"
      将 <YOUR_ZONE_ID>、<YOUR_CLOUDFLARE_EMAIL> 和 <YOUR_API_TOKEN> 替换为您的实际信息。在返回的JSON数据中，找到对应记录的 "id" 字段并复制其值。

步骤 2: 创建 DDNS 更新脚本

我们将使用一个简单的Bash脚本来执行DDNS更新逻辑。创建一个名为 cloudflare_ddns.sh 的文件，并添加以下内容：

“`bash

!/bin/bash

Cloudflare API 凭证 (请替换为您的实际值)

API_TOKEN=”YOUR_CLOUDFLARE_API_TOKEN” # 您的 Cloudflare API Token
ZONE_ID=”YOUR_CLOUDFLARE_ZONE_ID” # 您的 Zone ID
RECORD_ID=”YOUR_CLOUDFLARE_RECORD_ID” # 您要更新的 DNS A 记录的 ID
DOMAIN_NAME=”home.yourdomain.com” # 您要更新的完整域名 (例如 home.yourdomain.com)
EMAIL=”[email protected]” # 您的 Cloudflare 账户邮箱

日志文件路径 (可以根据需要调整)

LOG_FILE=”/var/log/cloudflare_ddns.log”

获取当前公共 IP 地址

CURRENT_IP=$(curl -s https://api.ipify.org || curl -s https://ipv4.icanhazip.com)

if [ -z “$CURRENT_IP” ]; then
echo “$(date) – 错误: 无法获取当前公共 IP 地址。” >> “$LOG_FILE”
exit 1
fi

获取 Cloudflare 上 DNS 记录的当前 IP 地址

CLOUDFLARE_IP=$(curl -s -X GET “https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$RECORD_ID” \
-H “X-Auth-Email: $EMAIL” \
-H “Authorization: Bearer $API_TOKEN” \
-H “Content-Type: application/json” | grep -oP ‘(?<=”content”:”)[^”]*’)

if [ -z “$CLOUDFLARE_IP” ]; then
echo “$(date) – 错误: 无法从 Cloudflare 获取 DNS 记录的 IP 地址。” >> “$LOG_FILE”
exit 1
fi

比较 IP 地址，如果不同则更新

if [ “$CURRENT_IP” = “$CLOUDFLARE_IP” ]; then
echo “$(date) – IP 地址未改变 ($CURRENT_IP)。无需更新。” >> “$LOG_FILE”
else
echo “$(date) – IP 地址已改变。旧 IP: $CLOUDFLARE_IP, 新 IP: $CURRENT_IP。正在更新…” >> “$LOG_FILE”

# 更新 Cloudflare DNS 记录
UPDATE_RESPONSE=$(curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$RECORD_ID" \
    -H "X-Auth-Email: $EMAIL" \
    -H "Authorization: Bearer $API_TOKEN" \
    -H "Content-Type: application/json" \
    --data "{\"type\":\"A\",\"name\":\"$DOMAIN_NAME\",\"content\":\"$CURRENT_IP\",\"ttl\":120,\"proxied\":false}") # TTL 120秒，此处设置为不使用 Cloudflare 代理

if echo "$UPDATE_RESPONSE" | grep -q '"success":true'; then
    echo "$(date) - DNS 记录更新成功。新 IP: $CURRENT_IP。" >> "$LOG_FILE"
else
    echo "$(date) - 错误: DNS 记录更新失败。响应: $UPDATE_RESPONSE" >> "$LOG_FILE"
fi

fi
``
**请务必将脚本中的占位符 (YOUR_CLOUDFLARE_API_TOKEN等) 替换为您的实际凭证和域名信息。**ttl(Time To Live) 设置为120秒（2分钟）是一个较短的值，可以加快IP更新的传播速度。“proxied”:false意味着流量将直接流向您的IP地址，而不是通过Cloudflare的代理网络。如果您希望利用Cloudflare的CDN和安全功能，可以将其设置为true`。

步骤 3: 赋予脚本执行权限

在您的终端中运行以下命令，使脚本可执行：

bash
chmod +x cloudflare_ddns.sh

步骤 4: 使用 Cron 自动化脚本运行

为了让脚本定期检查并更新您的IP地址，您可以使用 cron（Linux/macOS）或任务计划程序（Windows）。这里以 cron 为例：

  1. 打开您的 crontab 编辑器：
    bash
    crontab -e

  2. 在文件末尾添加一行，例如，每5分钟运行一次脚本：
    cron
    */5 * * * * /path/to/your/cloudflare_ddns.sh > /dev/null 2>&1
    请将 /path/to/your/cloudflare_ddns.sh 替换为您脚本的实际路径。> /dev/null 2>&1 会将脚本的所有标准输出和错误输出重定向到空设备，避免cron发送大量邮件。所有重要信息将写入脚本中定义的日志文件 (/var/log/cloudflare_ddns.log)。

故障排除和最佳实践

  • 检查日志文件： 定期查看 /var/log/cloudflare_ddns.log 以确保脚本正常运行并检查任何错误信息。
  • API Token 安全： 您的API Token具有修改DNS记录的权限，因此请像对待密码一样保护它。不要将其公开或提交到公共代码仓库。
  • 权限最小化： 在创建API Token时，仅授予其所需的最小权限（即 “编辑区域 DNS”）。
  • 测试运行： 在设置cron任务之前，手动运行几次脚本以确认其功能正常。

结论

通过Cloudflare的强大API和简单的Shell脚本，您可以轻松地为您的动态IP地址设置DDNS，实现域名的自动更新。这不仅简化了管理，还确保您能够随时通过域名访问您的本地网络资源，无论是家庭服务器还是其他需要外部访问的设备。告别手动更新IP地址的烦恼，拥抱自动化的便捷吧！
“`

滚动至顶部