SuperAPI AI 工具集

clerk-deploy-integration

部署与运维

查看项目

更新于 10-16 03:39

技能介绍

用途:把使用 Clerk 认证的应用部署到 Vercel、Netlify、Railway 或其他托管平台,并完成环境变量、域名与 Webhook 端点配置。

前提条件:已创建 Clerk 生产实例(pk_live_ / sk_live_ 密钥)、已配置生产域名、拥有托管平台账号。

主要能力:

  1. 环境变量配置。Vercel 可用 vercel env add NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY production、CLERK_SECRET_KEY、CLERK_WEBHOOK_SECRET,并为 preview 添加测试密钥;Netlify 用 netlify env:set;Railway 用 railway variables set。
  2. Clerk Dashboard 配置。在 Domains 添加生产域名,并设置 Home URL、Sign-in URL、Sign-up URL、After sign-in URL。
  3. Netlify Functions 验证。用 @clerk/backend 的 createClerkClient 与 sessions.verifySession 校验 Bearer Token。
  4. Docker 部署。多阶段构建,公开密钥作为构建参数,CLERK_SECRET_KEY 在运行时通过 docker run -e 或 docker-compose 注入。
  5. 部署后验证脚本。用 curl 检查首页、登录页、健康检查端点与 Webhook 端点状态码(Webhook 无有效负载时返回 400/405 属预期)。

常见错误处理:登录页 500 多为缺少 CLERK_SECRET_KEY;Webhook 签名失败需更新 Dashboard 中的端点 URL;CORS 报错需在 Domains 添加域名;重定向循环检查 NEXT_PUBLIC_CLERK_SIGN_IN_URL;Docker 构建缺少公开密钥需补 --build-arg。

限制:资料未提供具体平台版本要求、配额、计费与故障排查以外的高级配置,相关内容暂未提供。