SuperAPI AI 工具集

clerk-environments-deployment

部署与运维

查看项目

更新于 10-15 23:41

技能介绍

用途:当任务超出单一框架范围时使用,例如开发与生产环境划分、部署就绪、自定义域名与 DNS、重定向、CORS/Cookie、Webhook、CSP、监控、事件响应以及多语言后端架构。核心思路是把环境设计当作认证实现的一部分。

环境模型:开发与生产使用独立的 Clerk 实例;预发布/预览需明确使用独立预发布实例还是受限开发实例。密钥前缀可作快速检查:publishable key 为 pk_test_.../pk_live_...(客户端可用),secret key 为 sk_test_.../sk_live_...(仅服务端),Webhook 签名密钥与加密密钥均为服务端专用。禁止混用不同实例或端点的密钥。

本地开发:仅用 .env.local 存放开发密钥;确认框架变量名,如 Next.js 的 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 与 CLERK_SECRET_KEY;配置本地登录/注册路由与回退重定向;可用 Clerk CLI 的 setup/init、env pull、deploy status;Webhook 用隧道暴露本地应用并创建开发端点,签名密钥与生产分离;测试未登录、已登录、错误角色/组织与 Webhook 重放流程;不要提交 .env 或含令牌日志。

预发布/预览:为非受信预览分支使用非生产密钥,配置允许来源与重定向 URL,避免让所有预览 URL 使用生产 OAuth 凭证或生产 Webhook;检查 CORS、Cookie 与 SameSite 行为。

生产上线:创建生产实例,在托管平台设置生产环境变量,配置生产域名与 DNS,替换为自有 OAuth 凭证,配置登录/注册与重定向、生产 Webhook 端点及其签名密钥,按需配置代理与 CSP,设置子域允许列表与 authorizedParties,验证代理转发认证相关头,运行带/不带 Bearer 令牌的 API 测试与 Webhook 重放,确认日志脱敏,并记录回滚与密钥轮换步骤。

局限:资料仅提供清单式指导,未给出具体价格、套餐或平台支持范围;部分运行时细节需参照 Clerk 官方文档。