用途:把用户已拥有的域名(GoDaddy、Namecheap、Cloudflare 等)指向其 Convex 应用,不涉及购买域名,也不需要注册商凭据。
主要能力与步骤:
- 确定目标:静态托管取已发布站点主机;否则取部署的 HTTP actions URL,可用 npx convex env get CONVEX_SITE_URL 或从控制台获取。
- 向用户提供需在自己注册商处创建的确切 DNS 记录:CNAME(或根域的 A/ALIAS),以及 TXT 验证记录,须给出具体主机名与取值,不写占位符。
- 在 Convex 侧附加自定义域名(控制台 deployment → Custom Domains,或 CLI),等待验证。DNS 传播可能需数分钟到数小时,应告知用户,不要无限轮询。
- 若应用使用认证(passkeys/OAuth),需将 auth origin(SITE_URL、RP_ID、ORIGIN 等环境变量)重绑到新域名并重新部署,否则新域名上登录会失败。
- 验证:域名通过 HTTPS 正常提供应用,如配置了根域到 www 的跳转也应生效。
规则与限制:绝不索取注册商凭据,记录由用户自行创建;必须包含 TXT 验证记录而非仅 CNAME;重绑域名会改变 auth origin,之后必须重新部署。资料未提供具体费用、平台限制或更多故障排查内容。