SuperAPI AI 工具集

better-auth

通用与其它

查看项目

更新于 10-16 08:10

技能介绍

用途:为 TypeScript/JavaScript 应用实现认证与授权,适用于邮箱密码、社交 OAuth、2FA、Passkey、魔术链接、多租户组织、会话与用户生命周期管理等场景。

主要能力:框架无关,内置邮箱密码登录、邮箱验证、密码重置、社交 OAuth 与限流、会话管理;2FA/TOTP、Passkey/WebAuthn、魔术链接、用户名登录、组织/多租户等通过插件启用。采用客户端-服务端架构:服务端 better-auth 处理认证逻辑、数据库操作与 API 路由,客户端 better-auth/client 提供前端 Hook 与方法。

使用方式:安装 npm install better-auth(或 pnpm/yarn/bun add better-auth);配置环境变量 BETTER_AUTH_SECRET(至少 32 字符)与 BETTER_AUTH_URL;创建 auth.ts 并传入 database、emailAndPassword、socialProviders 等配置;用 npx @better-auth/cli generate 生成 schema/迁移,npx @better-auth/cli migrate 应用迁移(仅 Kysely);在框架中挂载 API 处理器,例如 Next.js App Router 使用 toNextJsHandler(auth);创建 auth-client.ts,通过 authClient 调用 signUp.email、signIn.email、signIn.social 及 useSession/getSession。

适用场景:标准 Web 应用基础认证、社交登录、密码less 登录、企业多认证方式与渐进增强。

限制:资料未提供具体定价、版本与各框架挂载的完整细节;数据库适配器、邮件发送与生产限流等需参考对应文档,资料中未完整展开。