Appearance
域名解析(DDNS)
节点公网 IP 变了,面板自动把你在 Cloudflare 上绑定的 A / AAAA 记录改成新地址。不用在每台机器上另装 DDNS 工具,Cloudflare Token 只保存在面板里。
所有用户都可以使用,不需要授权。
- A 记录跟随节点的公网 IPv4,AAAA 记录跟随公网 IPv6。
- 只改记录内容,不改代理(橙色云朵)、TTL 和备注;不会删除任何记录。
- 在 后台 → 插件 里可以关闭;关闭后停止更新,已有设置保留。
准备
- 域名已经托管在 Cloudflare。
- 节点已接入面板并在线。被控版本越新,发现 IP 变化越快(见文末「多久更新一次」)。
第一步:在 Cloudflare 创建 API Token
登录 Cloudflare,打开 API 令牌 页面(右上角头像 → 我的个人资料 → API 令牌),点「创建令牌」。

在「编辑区域 DNS」这一行点「使用模板」。

按下图设置:
- 令牌名称:随意,例如
DStatus DDNS。 - 权限:模板已带「区域 · DNS · 编辑」。建议点「添加更多」,再加一行「区域 · 区域 · 读取」,这样面板能按域名自动找到对应的区域。
- 区域资源:「包括 · 特定区域」,选择要用于 DDNS 的域名。只选需要的域名更安全。

- 令牌名称:随意,例如
点「继续以显示摘要」,核对域名和权限,点「创建令牌」。

点 Token 右侧的复制按钮。Cloudflare 只显示这一次,关掉页面后就看不到了;丢了可以在令牌列表里「轮转」重新生成。

第二步:在面板填写 Token
- 打开 服务器管理 → 域名解析(DDNS),点「设置 Token」。
- 粘贴刚才复制的 Token,点「验证并保存」。面板会先向 Cloudflare 验证,验证通过才保存。

保存后,Token 卡显示「已设置 · 末 4 位 ××××」。点「测试」可以看到这个 Token 能管理哪些域名。
第三步:绑定记录
- 点「新增绑定」。
- 选择节点,填写完整的记录名(例如
home.example.com),选择 A 或 AAAA。 - 下方「绑定预览」会显示结果:
- 记录已存在:显示当前内容,绑定后按节点地址更新。
- 记录不存在:列出将新建的记录(不代理、TTL 自动),勾选「新建这条记录」后才能提交。
- 点「绑定」(或「新建并绑定」)。

绑定后,列表里能看到每条记录的节点、已确认内容、节点公网地址和状态。

备用节点
绑定时可以再选一个「备用节点」。主节点离线(或没有可用的公网地址)超过 3 分钟,记录自动改指向备用节点;主节点恢复并稳定 10 分钟后自动切回。备用节点也不可用时保持原样不改。每次切换会发「DDNS 主备切换」通知。
已有绑定在列表里点「修改节点」即可设置或更换备用节点,也可以把主、备对调。
切换是按节点离线判断的。节点在线但从某些地区访问不通(例如线路被封)时不会切换。
状态说明
| 状态 | 含义 | 要做什么 |
|---|---|---|
| 正常 | Cloudflare 上已是节点当前地址 | 无 |
| 备用中 | 主节点不可用,已切到备用节点 | 主节点恢复稳定后自动切回 |
| 同步中 | 节点地址变了,正在写入 | 稍等片刻 |
| 等待节点上报 | 节点离线,或还没上报可用的公网地址 | 检查节点是否在线 |
| 写入失败,重试中 | 暂时连不上 Cloudflare 等原因,会自动重试 | 持续失败会收到通知 |
| 需处理 | 记录在 Cloudflare 上被改动或删除、域名不可访问、Token 失效、节点地址短时间内反复变化 | 按提示处理后点「恢复」 |
| 已暂停 | 你手动暂停了这条记录 | 需要时点「恢复」 |
「需处理」时面板不会自动改回,以免覆盖你的手动修改。点「恢复」前会先告诉你 Cloudflare 上现在的值和恢复后将写入的值,确认后才改写。Token 失效时,换一个新 Token 保存后会自动恢复。
常见问题
多久更新一次? 被控在启动时、每小时,以及发现网络变化时(与面板的连接断开重连、网卡地址变化)查询公网 IP,面板随后写入 Cloudflare。新版被控通常在 IP 变化后几分钟内更新,旧版被控最长约一小时。DNS 生效还取决于记录的 TTL。
提示「Token 缺少 Zone 读取权限」? 按第一步给 Token 加上「区域 · 区域 · 读取」;或在新增绑定时展开「手动填写 zone ID」,在 Cloudflare 该域名的「概述」页右侧找到「区域 ID」复制填入。
节点通过代理出网,或有多个公网 IP? 面板使用节点上报的出口地址。经代理出网、出口地址与服务地址不同的情况,DDNS 写入的可能不是你想要的地址,暂不支持。
会收到通知吗? 「需处理」、恢复和主备切换时会通知。是否发送、发到哪里,在 通知管理 → 通知规则 →「系统提醒」里的「DDNS 需处理」「DDNS 已恢复」「DDNS 主备切换」设置。
换服务器时要注意什么? 在新服务器上用原节点身份装好被控后,记录会自动改到新地址。记得先停掉旧服务器上的被控:两台同时用一个节点身份上报,地址会来回变化,面板会暂停这条记录并通知你。
解绑或删除节点会删掉 DNS 记录吗? 不会。解绑、删除节点只停止自动更新,Cloudflare 上的记录保留。
能用 AI 助手或 MCP 管理吗? 可以列出、绑定、解绑、暂停或恢复、立即同步。Token 只能在页面上填写。