Back

网站域名修改指南:Cloudflare、Vercel 与 Clerk 注意事项

MasterMao

Hello!大家好,我是猫猫鱼。大家应该看到猫猫鱼 Top4 AI工具窝的域名变化了。

修改网站域名可能是一个复杂的过程,尤其是在您使用 Cloudflare 作为 CDN、Vercel 作为托管平台,以及 Clerk 作为用户身份验证服务时。本指南将引导您完成每个平台的必要步骤和具体注意事项,以确保平稳过渡。

通用步骤

  1. 301 重定向: 在服务器端配置 301 重定向,将旧域名跳转到新域名。这对于 SEO 和用户体验都至关重要。
  2. 更新 DNS 记录: 将新域名的 A 记录指向服务器的 IP 地址。
  3. 更新 HTTPS: 为新域名生成 SSL/TLS 证书,确保 HTTPS 可用。
  4. Google Search Console: 在 Google Search Console 中设置首选域名,并监控网站排名和流量。

Cloudflare 注意事项

  1. DNS 设置: 在 Cloudflare 中更新新域名的 DNS 记录。
  2. SSL/TLS 设置: 确保新域名在 Cloudflare 中使用 HTTPS 连接。
  3. Page Rules: 根据需要更新 Page Rules,以匹配新域名的设置。
  4. 缓存清除: 清除 Cloudflare 的缓存,确保新域名访问时不会加载旧内容。

Vercel 注意事项

  1. 域名配置: 在 Vercel 项目的 Domains 配置中添加新域名。
  2. 旧域名重定向: 将 Vercel 部署配置里的老域名全部 301 重定向到新域名。
  3. DNS 更新: 确保新域名的 DNS 指向 Vercel 的服务器。

Clerk 注意事项

  1. Clerk Dashboard: 在 Clerk Dashboard 中更新生产环境的域名。
    • 进入 Domains 页面,选择 Danger 标签。
    • 点击 Change domain 更新域名。
    • 或者使用 Backend API 进行更新。
  2. Backend API 更新:
    • 使用以下 curl 命令(需要替换 YOUR_CLERK_SECRET_KEYYOUR_PROD_URL):
    curl -X POST -H "Authorization: Bearer YOUR_CLERK_SECRET_KEY" -H "Content-Type: application/json" -d "{ \"home_url\": \"YOUR_PROD_URL\" }" https://api.clerk.com/v1/instance/change_domain
    
  3. 更新 Publishable Key: 修改域名后,Clerk 会生成新的 Publishable Key。需要在环境变量中更新此 Key,并重新部署应用程序。
  4. 社交登录: 如果使用社交登录,需要在社交平台的设置中更新回调 URL。
  5. JWT 模板: 如果使用 JWT 模板,更新 JWT issuer 和 JWKS Endpoint 在外部 JWT SSO 服务。
  6. 子域名设置:
    • Domains 页面,选择 Danger 标签。
    • 修改或删除您的子域名。

重要提醒

  • Clerk 的开发环境域名无法修改。

总结

修改网站域名是一个敏感的操作,需要在多个平台进行配置和更新。务必在操作前备份数据,并确保每个步骤都正确无误。特别是 Cloudflare、Vercel 和 Clerk 这些服务,都需要根据其具体配置进行相应的修改。否则,可能导致网站无法正常访问或影响 SEO 排名。