Skip to content

域名解析(DDNS) ​

节点公网 IP 变了,面板自动把你在 Cloudflare 上绑定的 A / AAAA 记录改成新地址。不用在每台机器上另装 DDNS 工具,Cloudflare Token 只保存在面板里。

所有用户都可以使用,不需要授权。

  • A 记录跟随节点的公网 IPv4,AAAA 记录跟随公网 IPv6。
  • 只改记录内容,不改代理(橙色云朵)、TTL 和备注;不会删除任何记录。
  • 在 后台 → 插件 里可以关闭;关闭后停止更新,已有设置保留。

准备 ​

  • 域名已经托管在 Cloudflare。
  • 节点已接入面板并在线。被控版本越新,发现 IP 变化越快(见文末「多久更新一次」)。

第一步:在 Cloudflare 创建 API Token ​

  1. 登录 Cloudflare,打开 API 令牌 页面(右上角头像 → 我的个人资料 → API 令牌),点「创建令牌」。

    Cloudflare API 令牌页的「创建令牌」

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

    选择「编辑区域 DNS」模板

  3. 按下图设置:

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

    权限与区域资源设置

  4. 点「继续以显示摘要」,核对域名和权限,点「创建令牌」。

    令牌摘要

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

    令牌创建成功,复制 Token

第二步:在面板填写 Token ​

  1. 打开 服务器管理 → 域名解析(DDNS),点「设置 Token」。
  2. 粘贴刚才复制的 Token,点「验证并保存」。面板会先向 Cloudflare 验证,验证通过才保存。

DDNS 的 Token 设置抽屉

保存后,Token 卡显示「已设置 · 末 4 位 ××××」。点「测试」可以看到这个 Token 能管理哪些域名。

第三步:绑定记录 ​

  1. 点「新增绑定」。
  2. 选择节点,填写完整的记录名(例如 home.example.com),选择 A 或 AAAA。
  3. 下方「绑定预览」会显示结果:
    • 记录已存在:显示当前内容,绑定后按节点地址更新。
    • 记录不存在:列出将新建的记录(不代理、TTL 自动),勾选「新建这条记录」后才能提交。
  4. 点「绑定」(或「新建并绑定」)。

新增绑定与绑定预览

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

DDNS 绑定列表

备用节点 ​

绑定时可以再选一个「备用节点」。主节点离线(或没有可用的公网地址)超过 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 只能在页面上填写。

DStatus 文档