SuperAPI AI 工具集

better-auth

前端与建站

查看项目

更新于 10-15 21:48

技能介绍

用途:在 TypeScript/JavaScript 应用中实现认证,覆盖 OAuth 登录、2FA、魔法链接、Passkey、手机认证、企业 SSO、组织多租户、订阅计费与 Web3(SIWE)等场景,也支持从 Auth.js、Clerk、Auth0、Supabase、WorkOS 迁移。

主要能力:框架无关,可用于 Next.js、SvelteKit、Nuxt、Remix、Astro、Expo、NestJS;插件按需启用;端到端类型安全;自托管,数据留在自有基础设施;数据库可选 Prisma、Drizzle、MongoDB、PostgreSQL、MySQL、SQLite。

使用方式:当前稳定版为 1.7.x。1.5 起使用独立 CLI npx auth@latest(generate、migrate、secret、init、check 等)替代 @better-auth/cli。升级到 1.7 后需重新生成 schema(npx auth@latest generate)并参考官方升级指南。Next.js 架构建议按模块组织:服务层配置 betterAuth、hooks 中用 createAuthClient、API 路由 app/api/auth/[...all]/route.ts、proxy.ts 做路由保护。

限制与注意:本技能中的架构指导(proxy.ts、App Router API 路由)仅适用于 Next.js;Prisma schema 与查询细节需另见 prisma-7。1.6 起 session.freshAge 由 createdAt 计算,oidcProvider 已弃用;1.7 移除 oidcProvider,通用 OAuth 提供商改用 signIn.social,数据库 join 走 advanced.database.joins,accounts 以 (issuer, accountId) 为键,twoFactor.enable 返回按方法区分的响应,MCP 迁移至 @better-auth/mcp,SCIM 与 organization 解耦。资料未提供具体收费与价格信息。