OpenCoreDev 发布 Domain SDK 0.2.0：一个 TypeScript API 统一管理 Vercel、Cloudflare 等五个平台

一句话看懂

OpenCoreDev 发布 Domain SDK 0.2.0，用一个 TypeScript API 统一管理 Vercel、Cloudflare for SaaS、Railway、Render 和 Netlify 五个平台的客户域名生命周期。

详细发生了什么

OpenCoreDev 发布了 Domain SDK 0.2.0，这是一个 TypeScript 客户端库，用来标准化不同托管平台的客户域名管理流程。它覆盖了 Vercel、Cloudflare for SaaS、Railway、Render 和 Netlify 五个平台，提供统一的 API 来添加、验证和删除域名。

SDK 的核心是 createDomainClient() 函数，返回一个无状态客户端，包含 add、get、refresh、list、verify、remove 和 waitUntilActive 七个方法。每个方法都支持 AbortSignal，而且 add 和 remove 是幂等的，可以安全重试。

状态模型是 SDK 的一大亮点：DomainStatus 包含八个值：pending、pending_dns、pending_verification、pending_certificate、active、misconfigured、failed、unknown。此外，Domain 对象还有独立的 verification 和 certificate 字段，以及一个 issues 数组，每个 issue 都有代码、消息和可重试标志。

每个平台适配器是独立的入口点：./vercel、./cloudflare、./railway、./render、./netlify 和 ./testing。切换平台只需改 import 路径，工作流不变。SDK 还提供了 client.capabilities 属性，用于在运行时查询各平台的能力差异，比如是否支持列表、显式验证、托管证书、根域名和通配符域名。

此外，SDK 包含一个内存适配器用于测试，以及一个 agent skill，可以安装到 Codex、Claude Code、Cursor 等 AI 编程工具中。

中文圈视角

对于国内开发者，这个 SDK 直接覆盖的平台（Vercel、Cloudflare、Railway、Render、Netlify）大多需要科学上网才能流畅使用，但 Cloudflare 在国内有部分节点，Vercel 和 Netlify 也有国内镜像或替代方案。如果团队主要面向海外用户，这个 SDK 能显著减少多平台域名管理的重复劳动。

国内类似场景的替代方案包括：阿里云 DNS、腾讯云 DNSPod 的 API，以及 Serverless 平台如阿里云函数计算、腾讯云 Serverless Framework。但国内平台通常没有统一的 SDK 来抽象域名生命周期，开发者往往需要自己封装。Domain SDK 的设计思路（幂等操作、状态机模型、能力查询）值得借鉴，可以用于封装国内平台 API。

对于使用 Vercel 部署前端应用、Cloudflare 做 CDN 的团队，这个 SDK 能统一管理客户自定义域名，减少出错。不过需要注意，SDK 不处理 DNS 注册和代理流量，你需要自己管理 DNS 记录和证书。

几条值得记住的细节

SDK 是 ESM-only，Node.js >=20，支持 Bun，仅依赖 tldts。
DomainStatus 有八个值，verification 和 certificate 各有四个状态，issues 数组包含可重试标志。
waitUntilActive 默认超时 300 秒，轮询间隔 5 秒，最小 250 毫秒，支持 onStatus 回调。
各平台能力不同：Cloudflare for SaaS 不支持根域名，Render 支持通配符域名，没有平台自动修改客户 DNS。
测试适配器支持 transition()、延迟注入、按操作失败和调用日志。

一句话总结

如果你在多个海外平台管理客户域名，Domain SDK 能用一个 API 统一流程，减少重复代码和出错可能。