​群晖NAS机设置任务计划通过API更新Cloudflare DDNS动态IP域名解析，完成动态IP的域名解析，适用于有不固定动态公网IP的情况。

本文将整体过程拆分为三个部分：

1、获取 Cloudflare API Token

2、获取 Zone ID / Record ID

3、编写 DDNS 脚本并设置定时运行

下面是详细操作步骤：

1、获取 Cloudflare API Token

• 访问：https://dash.cloudflare.com/profile/api-tokens

• 点击 创建令牌（Create Token）

• 在模板中选择 编辑区域 DNS（Edit Zone DNS）

• 权限配置：区域（Zone） → DNS → 编辑（Edit）

• 资源配置：包括（Include） → 特定区域 → <你的域名>

• 完成创建并保存 API Token

点击右上角头像：

要先做身份验证，否则后面无法保存，会提示未做Email验证：

完成双因素身份验证后，点击“API令牌”-》“创建令牌”：

这里因为只需要动态更新IP到DNS，所以只点击“编辑区域DNS”-》“使用模板”：

按照下面设置：

点击“继续以显示摘要”：

 点击“创建令牌”：

至此就完成Token的创建，务必记住上面创建的令牌，复制token并保存起来（注意这个Token只会展示这一次，忘记了就只能重新创建一个Token）。

2、获取 Zone ID / Record ID

• 在 Cloudflare 的域名概览页面复制该域名对应的区域ID（即：Zone ID）

• 为域名新增一条 A 记录，例如主域名为 abc.com，可新建 ddns.abc.com，IP 可随意填写，在浏览器中输入以下地址打开，其中，<ZONE_ID> 替换为上面拿到的域名对应区域ID（ZONE_ID），其余内容不要更改：

  https://dash.cloudflare.com/api/v4/zones/<ZONE_ID>/dns_records?per_page=200&order=name&direction=asc

{"result":[{"id":"adb5019e5d96ff4b213a80983a6637bc","name":"ddns.abc.com","type":"A","content":"121.40.20.16","proxiable":true,"proxied":false,"ttl":1,"settings":{},"meta":{},"comment":null,"tags":[],"created_on":"2026-06-05T04:34:11.864432Z","modified_on":"2026-06-05T04:34:11.864432Z"},{"id":"fab2fdfbc16549594e52c6294adf691d","name":"*.abc.com","type":"A","content":"27.45.25.1","proxiable":true,"proxied":false,"ttl":1,"settings":{},"meta":{},"comment":null,"tags":[],"created_on":"2026-06-05T04:32:21.100399Z","modified_on":"2026-06-05T04:32:32.120333Z"},{"id":"82b174a7adc2a476df7d2207702a0e17","name":"abc.com","type":"A","content":"27.45.25.1","proxiable":true,"proxied":false,"ttl":1,"settings":{},"meta":{},"comment":null,"tags":[],"created_on":"2026-06-05T04:32:21.083773Z","modified_on":"2026-06-05T04:32:33.205554Z"},{"id":"f930ccb856e6b56b6c3a2b2943162f43","name":"www.abc.com","type":"A","content":"27.45.25.1","proxiable":true,"proxied":false,"ttl":1,"settings":{},"meta":{},"comment":null,"tags":[],"created_on":"2026-06-05T04:32:21.112018Z","modified_on":"2026-06-05T04:32:33.955677Z"}],"success":true,"errors":[],"messages":[],"result_info":{"page":1,"per_page":200,"count":14,"total_count":14,"total_pages":1}}

上面黄色位置 id 就是域名 ddns.abc.com（二级子域名） 对应的“Record ID”：adb5019e5d96ff4b213a80983a6637bc（以实际看到为准）。

3、编写 DDNS 脚本并设置定时运行

通过上面的操作，已经获取到了所有必须的信息，下面就开始设置需要在群晖NAS机任务计划中执行的脚本：

#!/bin/bash
API_TOKEN="YOUR_API_TOKEN"
ZONE_ID="YOUR_ZONE_ID"
RECORD_ID="YOUR_RECORD_ID"
RECORD_NAME="ddns.abc.com"
CURRENT_IP=$(curl -s http://ipv4.icanhazip.com)


# 更新DNS记录
curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$RECORD_ID" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  --data "{\"type\":\"A\",\"name\":\"$RECORD_NAME\",\"content\":\"$CURRENT_IP\",\"ttl\":120}"

将上面的：

API_TOKEN="YOUR_API_TOKEN"

ZONE_ID="YOUR_ZONE_ID"

RECORD_ID="YOUR_RECORD_ID"

RECORD_NAME="ddns.abc.com"

改为上面实际获取到的真实参数，其余内容不需要更改，然后保存执行，等待数分钟即可在日志目录看到更新记录，表示 DDNS 已成功运行。