SuperAPI AI 工具集

clerk-install-auth

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:在 Next.js、React 或 Express 项目中从零安装并配置 Clerk 认证,包括 SDK 安装、环境变量、ClerkProvider、中间件和初始认证验证。

主要能力:按框架安装对应包,如 npm install @clerk/nextjs、@clerk/clerk-react、@clerk/express、@clerk/backend;配置 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 与 CLERK_SECRET_KEY 等环境变量;在 Next.js App Router 中包裹 ClerkProvider;在项目根目录添加 middleware.ts 并用 clerkMiddleware 与 createRouteMatcher 保护路由;创建登录/注册页面;通过 /api/health 路由验证连接。React SPA 使用 VITE_CLERK_PUBLISHABLE_KEY,Express 使用 clerkMiddleware、requireAuth、getAuth。

使用方式:需 Node.js 18+、包管理器与 Clerk 账号,从 Dashboard 获取 pk_test_* 与 sk_test_*。按步骤安装依赖、写入 .env.local 并加入 .gitignore、配置 Provider 与中间件、创建认证页面、验证连接。

适用场景:新项目接入 Clerk、修复未完成的安装(如中间件未运行、Provider 位置错误、环境变量加载顺序问题)。

限制:资料未提供 CLI 具体命令、收费与价格信息;密钥须保存在平台密钥管理中,CLERK_SECRET_KEY 不得暴露到客户端;生产环境建议按环境使用独立 Clerk 实例。