动态 DNS（DynDNS、DDNS）是一项可以在 IP 地址发生变化时自动更新 DNS 记录的服务。例如，当您希望让位于家中的服务器可以从外部访问，但家庭宽带服务商分配的 IP 地址又会定期变化时，通常会使用 DynDNS。借助 DynDNS API，您可以自动更新 netcup 账户中某个域名或子域名的 A 记录 (IPv4) 和/或 AAAA 记录 (IPv6)。使用 DynDNS 时，您的路由器或脚本会定期访问特定 URL，并自动将当前 IP 地址写入您的 CloudDNS 区域中。

要使用 DynDNS API，您需要满足以下条件：

• 该域名必须通过 CloudDNS 进行管理。
• 您拥有用于向 netcup API 进行身份验证的有效令牌 (Token)。
• 至少传递一个 IP 地址（IPv4 或 IPv6），例如：https://customercontrolpanel.de/wsDynDns.php?action=update&token=YOUR_TOKEN&fqdn=home.example.com&ipv4Address=203.0.113.10
• 对于 IPv6，您还必须指定 ipv6Address，或者将其作为替代参数使用：https://customercontrolpanel.de/wsDynDns.php?action=update&token=YOUR_TOKEN&fqdn=home.example.com&ipv4Address=203.0.113.10&ipv6Address=2001:db8::10

以下是所用参数的概览：

• DynDNS 会自动判断 FQDN 中的哪一部分是与账户关联的主域名，哪一部分是主机名 (Host)。对于多段式顶级域名 (TLD)，如 ".co.uk"，系统也能自动识别。
  • "home.example.com" → 域名 (domain)："example.com"，主机名 (host)："home"
  • "example.com" → 域名 (domain)："example.com"，主机名 (host)："@"（区域根域名 / Zone root）
• 国际化域名 (IDN) 在内部会自动转换为 Punycode 编码。
• 如果在账户中未找到匹配的域名，请求将被拒绝并返回 HTTP 错误代码 404。
• 如果该域名未通过 CloudDNS 进行管理，请求将被拒绝并返回 HTTP 错误代码 400。

• 新条目将使用默认生存时间 (TTL) 和默认区域创建。
• 可以在单次调用中同时更新 A 记录和 AAAA 记录。

您可以在此处找到在 FRITZ!Box 路由器上设置 DynDNS 的说明：

• https://fritz.com/en-at/apps/knowledge-base/FRITZ-Box-7590/30_Setting-up-dynamic-DNS-in-the-FRITZ-Box （外部链接）

在设置过程中，请在提供的字段中输入以下信息：

• 更新 URL (Update URL): https://customercontrolpanel.de/wsDynDns.php?action=update&token=<pass>&fqdn=<domain>&ipv4Address=ipaddr>&ipv6Address=<ip6addr>
• 域名 (Domain Name): <sub.domain.tld>
• 用户名 (Username): 客户编号 (Customer Number)
• 密码 (Password)

系统会检查所识别主机的现有 A 记录或 AAAA 记录：

1. 记录已存在，且 IP 地址完全相同。
   1. 无需进行任何更改。
2. 记录已存在，但 IP 地址不同。
   1. 使用提供的 IP 地址更新该记录。
3. 记录尚不存在。
   1. 创建一条新记录。如果这导致了实际的更改，这些更改将保存在 CloudDNS 区域中。如果所提供的所有值均已设置且一致，则不会进行任何更改。

响应以 JSON 格式返回 (Content Type: text/json; charset=utf-8)：

• "Record(s) have been saved."
• "No record update needed."

旧版 API (Legacy API)

CloudDNS 云解析

配置 DNS (CloudDNS)

设置您自己的域名服务器 (CloudDNS)

DNSSEC (CloudDNS)