用途:帮助用户把自己已拥有的域名指向其 Convex 应用,完成 DNS 记录配置、自定义域名绑定,并在应用使用认证时重绑认证源。
主要流程与能力:先确认目标,即已发布的站点主机(*.convex.app 静态托管)或部署的 HTTP actions URL。随后检测用户提供商是否已有可用且已认证的 DNS CLI,并征询同意后自动创建记录:Cloudflare 可用 flarectl dns create(注意 wrangler 本身不管理 DNS 记录)或通过令牌环境变量调用 CF API;Route53 用 aws route53 change-resource-record-sets;Google Cloud DNS 用 gcloud dns record-sets create;DigitalOcean 用 doctl compute domain records create;Vercel DNS 用 vercel dns add。先以只读方式检查认证状态,例如 flarectl user info、aws sts get-caller-identity、doctl account get,展示确切命令并获确认后再执行。若无已认证 CLI 或用户拒绝,则告知用户在其注册商处应创建的具体记录:CNAME(或顶点用 A/ALIAS)加上 TXT 验证记录,给出具体主机与值字符串而非占位符。然后在 Convex 控制台或 CLI 绑定该自定义域名并等待验证,DNS 传播可能需数分钟到数小时,可用 dig +short 核实记录是否生效。若应用使用认证(passkeys/OAuth),需将认证源(SITE_URL / RP_ID / ORIGIN 环境变量)重绑到新域名并重新部署或重新发布。最后验证域名通过 HTTPS 提供应用,包含已配置的顶点到 www 跳转。
限制与规则:绝不索取或处理注册商凭据;可使用用户机器上已认证的 CLI,凭据留在工具内;不要为此安装 CLI 或执行其登录/认证流程,不要回显令牌。实时域名的 DNS 变更对用户可见,执行前展示确切命令并确认,事后用 dig 验证。始终包含 TXT 验证记录,而非仅 CNAME。重绑域名会改变认证源,之后必须重新发布,否则登录会失效。