服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 10 月 26 日开始的 rollout 预计持续 7 天，覆盖 zone DNS settings 与 account DNS defaults 两个接口。
- rollout 尚未到达某个账号时，Advanced Nameservers 仍可能返回 cloudflare.standard；这不表示该账号的资格已变化。
- 新写入应使用 nameservers.type=cloudflare.advanced；过渡期 foundation_dns 仍是兼容别名。
- 同一 PATCH 同时发送两个字段时，二者必须一致；冲突值会被 API 拒绝。
- 官方计划从 2026-11-23 起逐步移除 foundation_dns，预计需要 7 天；集成应提前完成迁移。
Cloudflare DNS API 改了什么？
Cloudflare 于 2026 年 10 月 26 日开始分批用 `nameservers.type: "cloudflare.advanced"` 表示 Advanced Nameservers。官方预计这轮 rollout 持续 7 天，因此不同账号在同一时间可能看到不同返回值。
变更涉及 zone 设置接口 `/zones/{zone_id}/dns_settings` 和账户默认设置接口 `/accounts/{account_id}/dns_settings`。如果你的 SDK、控制面板或自动化程序读取或写入这两类 DNS 设置，就应检查字段映射和类型判断。
为什么 Advanced Nameservers 还会返回 cloudflare.standard？
在 rollout 到达某个账号前，Cloudflare 说明接口仍会把 Advanced Nameservers 返回为 `nameservers.type: "cloudflare.standard"`。这表示新返回格式尚未到该账号，不应被客户端直接解释成订阅或功能已关闭。
Cloudflare 同时说明，此次 API 表示方式变化不会改变 Foundation DNS 订阅，也不会改变某个 zone 是否已启用 Advanced Nameservers，更不要求迁移 zone。把“API rollout 状态”和“账号原有资格/配置”分开处理，能避免客户端因暂时读到旧表示而自动回写错误设置。
新的读写字段应该怎样处理？
新写入应使用 `nameservers.type`。对符合条件的账号，PATCH 可使用 `cloudflare.advanced`；账户级和 zone 级接口使用同一字段概念。接收响应的客户端也应把 `cloudflare.advanced` 加入允许值，尤其是把枚举写死的 SDK、验证器和管理后台。
过渡期间，`foundation_dns` 仍可读取和写入，作为已弃用的兼容别名。兼容层可以继续识别旧布尔值，但新代码应逐步以 `nameservers.type` 作为主要字段，并保留必要的旧格式读取能力直到旧字段退出。
同一次 PATCH 带两个字段时有什么约束？
过渡期间，如果请求同时包含 `nameservers.type` 与 `foundation_dns`，两个值必须表达相同状态；Cloudflare 会拒绝彼此冲突的 PATCH。对于 Advanced Nameservers，不能一边发送 `cloudflare.advanced`，一边又发送 `foundation_dns: false`。
如果旧客户端仍会发送布尔字段，应在组装请求前从同一份状态生成两种表示，或逐步停止发送旧字段。不要让两个设置来源分别计算这两个值，否则升级期间容易出现冲突请求。
11 月 23 日前，集成方应完成哪些调整？
Cloudflare 的弃用说明把 `foundation_dns` 的结束日期列为 2026 年 11 月 23 日，并说明从该日开始 API 将逐步不再返回或接受它，预计 rollout 持续 7 天。应在这个日期前完成客户端迁移，不要把 11 月 23 日当作还能开始修改的宽限期。
先扩大客户端枚举，避免遇到 `cloudflare.advanced` 时解析失败；再更新写入逻辑，并在读路径继续兼容旧布尔字段。然后分别检查 account-default 与 zone-level 两个 API 路径，确认请求不会发送互相矛盾的值，并记录未识别类型供排查。
Advanced Nameservers 仍有账号资格要求。Cloudflare 接受新类型的 PATCH，不代表所有套餐或账号都会因此获得 Advanced Nameservers；迁移字段也不会自动改变 entitlement。
这是 DNS 迁移或订阅变更吗？
不是。这次变化调整的是 DNS settings API 对 Advanced Nameservers 的表示方式，不要求迁移 zone。Cloudflare 明确表示，Foundation DNS 订阅及 zone 是否启用 Advanced Nameservers 均不因这次 API 变化而改变。
需要调整的是读写这两个 DNS settings endpoint 的集成代码。先核对账号现有 entitlement，再按新字段迁移；不要把 API 字段升级误写成新增套餐、自动启用或一次实际 DNS 切换。
资料来源
常见问题
rollout 期间读到 cloudflare.standard，就应该关闭 Advanced Nameservers 吗？
不应只凭这个返回值关闭配置。Cloudflare 说明 rollout 到达账号前，Advanced Nameservers 仍可能返回 cloudflare.standard；应将该过渡状态与账号 entitlement 和现有配置分开判断。
旧 foundation_dns 字段能继续用到什么时候？
过渡期仍可读写这个兼容别名。官方把 2026 年 11 月 23 日列为结束日期，并计划从该日开始分批停止返回或接受；集成方应在此之前迁移到 nameservers.type。
把字段改成 cloudflare.advanced 会自动获得 Foundation DNS 吗？
不会。新类型不改变订阅或 zone entitlement。只有具备相应资格的账号才能使用 Advanced Nameservers；Cloudflare 表示本次 API 变化不要求迁移 zone。
只改 zone 接口就够了吗？
如果你的集成也管理 account-level DNS defaults，还要更新 `/accounts/{account_id}/dns_settings` 的读写和类型处理。Cloudflare 表示账户级与 zone 级接口会同步采用新的表示方式。