# Better Auth

> The most comprehensive authentication framework for TypeScript

## Table of Contents

### Adapters

- [社区适配器](/llms.txt/docs/adapters/community-adapters.md): 由社区构建、用于扩展 Better Auth 的数据库适配器。
- [Drizzle ORM 适配器](/llms.txt/docs/adapters/drizzle.md): 将 Better Auth 与 Drizzle ORM 集成。
- [MongoDB 适配器](/llms.txt/docs/adapters/mongo.md): 将 Better Auth 与 MongoDB 集成。
- [MS SQL](/llms.txt/docs/adapters/mssql.md): 将 Better Auth 与 MS SQL 集成。
- [MySQL](/llms.txt/docs/adapters/mysql.md): 将 Better Auth 与 MySQL 集成。
- [其他关系型数据库](/llms.txt/docs/adapters/other-relational-databases.md): 将 Better Auth 与其他关系型数据库集成。
- [PostgreSQL](/llms.txt/docs/adapters/postgresql.md): 将 Better Auth 与 PostgreSQL 集成。
- [Prisma](/llms.txt/docs/adapters/prisma.md): 将 Better Auth 与 Prisma 集成。
- [SQLite](/llms.txt/docs/adapters/sqlite.md): 将 Better Auth 与 SQLite 集成。

### Ai Resources

- [AI 资源](/llms.txt/docs/ai-resources.md): 在文档中使用 AI、LLMs.txt、文档 MCP 服务器，以及用于编码助手的 Better Auth 技能。
- [MCP](/llms.txt/docs/ai-resources/mcp.md): 通过远程文档 MCP 服务器将 Better Auth 文档连接到支持 MCP 的客户端。
- [技能](/llms.txt/docs/ai-resources/skills.md): 安装 Better Auth agent 技能，使你的编码助手遵循库约定和模式。

### Authentication

- [Apple](/llms.txt/docs/authentication/apple.md): Apple 提供者的设置与使用。
- [Atlassian](/llms.txt/docs/authentication/atlassian.md): Atlassian 提供者的设置和使用。
- [Cognito](/llms.txt/docs/authentication/cognito.md): Amazon Cognito 提供者的设置与使用。
- [Discord](/llms.txt/docs/authentication/discord.md): Discord 提供程序的设置和使用。
- [Dropbox](/llms.txt/docs/authentication/dropbox.md): Dropbox 提供商设置和使用。
- [电子邮件与密码](/llms.txt/docs/authentication/email-password.md): 使用 Better Auth 实现电子邮件和密码认证。
- [Facebook](/llms.txt/docs/authentication/facebook.md): Facebook 提供者的设置和使用。
- [Figma](/llms.txt/docs/authentication/figma.md): Figma 提供者的设置与使用。
- [GitHub](/llms.txt/docs/authentication/github.md): GitHub 提供者的设置和使用。
- [GitLab](/llms.txt/docs/authentication/gitlab.md): GitLab 提供者的设置与使用。
- [Google](/llms.txt/docs/authentication/google.md): Google 提供者的设置和使用。
- [Hugging Face](/llms.txt/docs/authentication/huggingface.md): Hugging Face 提供者的设置与使用。
- [Kakao](/llms.txt/docs/authentication/kakao.md): Kakao 제공자의 설정 및 사용 방법입니다.
- [Kick](/llms.txt/docs/authentication/kick.md): Kick 提供者的设置和使用。
- [LINE](/llms.txt/docs/authentication/line.md): LINE 提供者的设置和使用。
- [Linear](/llms.txt/docs/authentication/linear.md): Linear 提供者的设置和使用。
- [LinkedIn](/llms.txt/docs/authentication/linkedin.md): LinkedIn 提供商
- [Microsoft](/llms.txt/docs/authentication/microsoft.md): Microsoft 提供商的设置与使用。
- [Naver](/llms.txt/docs/authentication/naver.md): Naver 提供者的设置和使用。
- [Notion](/llms.txt/docs/authentication/notion.md): Notion 提供者的设置和使用。
- [其他社交登录提供商](/llms.txt/docs/authentication/other-social-providers.md): 其他社交登录提供商的设置和使用。
- [Paybin](/llms.txt/docs/authentication/paybin.md): Paybin 提供者的设置和使用说明。
- [PayPal](/llms.txt/docs/authentication/paypal.md): PayPal 提供商的设置和使用。
- [Polar](/llms.txt/docs/authentication/polar.md): Polar 提供者的设置和使用。
- [Railway（铁路）](/llms.txt/docs/authentication/railway.md): Railway 提供者的设置和使用。
- [Reddit](/llms.txt/docs/authentication/reddit.md): Reddit 提供者的设置与使用。
- [Roblox](/llms.txt/docs/authentication/roblox.md): Roblox 提供程序的设置和使用。
- [Salesforce](/llms.txt/docs/authentication/salesforce.md): Salesforce 提供者的设置和使用。
- [Slack](/llms.txt/docs/authentication/slack.md): Slack 提供者的设置和使用说明。
- [Spotify](/llms.txt/docs/authentication/spotify.md): Spotify 提供者的设置和使用。
- [TikTok](/llms.txt/docs/authentication/tiktok.md): TikTok 提供者设置和使用说明。
- [Twitch](/llms.txt/docs/authentication/twitch.md): Twitch 提供者设置和使用。
- [Twitter (X)](/llms.txt/docs/authentication/twitter.md): Twitter 提供商的设置和使用说明。
- [Vercel](/llms.txt/docs/authentication/vercel.md): Vercel 提供者的设置与使用。
- [VK](/llms.txt/docs/authentication/vk.md): VK ID 提供者
- [微信](/llms.txt/docs/authentication/wechat.md): 微信提供者设置和使用。
- [Zoom](/llms.txt/docs/authentication/zoom.md): Zoom 提供者的设置和使用。

### Basic Usage

- [基本用法](/llms.txt/docs/basic-usage.md): 入门 Better Auth

### Comparison

- [对比](/llms.txt/docs/comparison.md): Better Auth 与其他认证库和服务的对比。

### Concepts

- [API](/llms.txt/docs/concepts/api.md): 了解如何在服务器上调用更佳认证 API 端点，传递 body、headers 和 query 参数，获取响应 headers，以及处理错误。
- [CLI](/llms.txt/docs/concepts/cli.md): 了解 Better Auth CLI 命令，用于生成和迁移数据库架构、初始化项目、生成密钥以及收集诊断信息。
- [Client](/llms.txt/docs/concepts/client.md): Learn how to set up the Better Auth client for React, Vue, Svelte, and other frameworks, use hooks, configure fetch options, handle errors, and extend with client plugins.
- [Cookies](/llms.txt/docs/concepts/cookies.md): 了解 Better Auth 如何使用 cookies，包括 cookie 前缀、自定义 cookie 属性、跨子域共享、安全 cookies，以及使用代理处理 Safari ITP。
- [数据库](/llms.txt/docs/concepts/database.md): 了解数据库适配器、迁移、使用 Redis 的二级存储、核心架构（用户、会话、账户、验证）、自定义表、扩展架构、ID 生成、数据库钩子以及插件架构。
- [邮件](/llms.txt/docs/concepts/email.md): 学习如何设置邮件验证、要求登录时验证邮件、验证后自动登录、处理验证后回调以及实现密码重置邮件。
- [钩子](/llms.txt/docs/concepts/hooks.md): 了解如何使用前置和后置钩子来自定义端点行为、修改请求和响应、处理 Cookie、抛出错误、访问认证上下文以及运行后台任务。
- [OAuth](/llms.txt/docs/concepts/oauth.md): 了解如何配置社交 OAuth 提供商、登录和关联账户、请求权限范围、传递额外数据、刷新访问令牌、映射用户资料以及自定义提供商选项。
- [插件](/llms.txt/docs/concepts/plugins.md): 了解如何使用和创建 Better Auth 插件，包括定义端点、模式、钩子、中间件、速率限制、受信任来源，以及使用自定义操作和原子构建客户端插件。
- [速率限制](/llms.txt/docs/concepts/rate-limit.md): 了解如何在 Better Auth 中配置速率限制，包括 IP 地址检测、IPv6 支持、自定义速率限制时间窗口、存储后端、错误处理和按端点的规则。
- [会话管理](/llms.txt/docs/concepts/session-management.md): 了解 Better Auth 中的会话管理，包括会话过期、新鲜度、Cookie 缓存策略、次级存储、无状态会话以及自定义会话响应。
- [TypeScript](/llms.txt/docs/concepts/typescript.md): 了解 Better Auth 的 TypeScript 配置，包括严格模式、推断会话和用户类型、定义额外字段以及在客户端上推断额外字段。
- [用户与账户](/llms.txt/docs/concepts/users-accounts.md): 了解如何管理用户和账户，包括更新用户信息、更改邮箱和密码、验证删除用户、令牌加密以及账户关联与解除关联。

### Examples

- [Astro 示例](/llms.txt/docs/examples/astro.md): Better Auth Astro 示例。
- [Next.js 示例](/llms.txt/docs/examples/next-js.md): Better Auth Next.js 示例。
- [Nuxt 示例](/llms.txt/docs/examples/nuxt.md): Better Auth Nuxt 示例。
- [React Router v7 示例](/llms.txt/docs/examples/react-router.md): Better Auth React Router v7 示例。
- [SvelteKit 示例](/llms.txt/docs/examples/svelte-kit.md): Better Auth SvelteKit 示例。

### Guides

- [从 Auth0 迁移到 Better Auth](/llms.txt/docs/guides/auth0-migration-guide.md): 从 Auth0 迁移到 Better Auth 的逐步指南。
- [浏览器扩展指南](/llms.txt/docs/guides/browser-extension-guide.md): 使用 Better Auth 创建浏览器扩展的逐步指南。
- [从 Clerk 迁移到 Better Auth](/llms.txt/docs/guides/clerk-migration-guide.md): 一个逐步指导，帮助您从 Clerk 平滑迁移到 Better Auth。
- [创建数据库适配器](/llms.txt/docs/guides/create-a-db-adapter.md): 了解如何为 Better-Auth 创建自定义数据库适配器
- [动态基础 URL](/llms.txt/docs/guides/dynamic-base-url.md): 为预览部署、多域名以及按请求解析 URL 配置 Better Auth。
- [从 Auth.js 迁移到 Better Auth](/llms.txt/docs/guides/next-auth-migration-guide.md): 从 Auth.js 迁移到 Better Auth 的分步指南。
- [性能优化](/llms.txt/docs/guides/optimizing-for-performance.md): 优化您的 Better Auth 应用性能的指南。
- [使用 Okta 的 SAML 单点登录](/llms.txt/docs/guides/saml-sso-with-okta.md): 一份使用 Okta 集成 SAML 单点登录（SSO）到 Better Auth 的指南
- [从 Supabase Auth 迁移到 Better Auth](/llms.txt/docs/guides/supabase-migration-guide.md): 逐步指导如何从 Supabase Auth 迁移到 Better Auth。
- [从 WorkOS 迁移到 Better Auth](/llms.txt/docs/guides/workos-migration-guide.md): 一步步指导如何从 WorkOS 迁移到 Better Auth。
- [创建你的第一个插件](/llms.txt/docs/guides/your-first-plugin.md): 创建你的第一个 Better Auth 插件的逐步指南。

### Infrastructure

- [入门指南](/llms.txt/docs/infrastructure/getting-started.md): 本指南将帮助您将 Better Auth 基础设施集成到您的应用程序中。
- [更佳身份验证基础设施](/llms.txt/docs/infrastructure/introduction.md): 面向企业的仪表板、安全性和托管服务，支持更佳身份验证。
- [审计日志](/llms.txt/docs/infrastructure/plugins/audit-logs.md): 通过自动审计日志记录，跟踪并查询您应用中的身份验证事件。
- [仪表盘插件 (dash)](/llms.txt/docs/infrastructure/plugins/dash.md): `dash()` 插件将你的 Better Auth 实例连接到 Better Auth 基础设施，支持分析跟踪、事件日志记录和管理仪表盘 API。
- [仪表盘](/llms.txt/docs/infrastructure/plugins/dashboard.md): `dash()` 插件将您的 Better Auth 实例连接到 Better Auth 基础设施，实现分析跟踪、活动监控和管理员仪表盘 API。
- [安全插件（sentinel）](/llms.txt/docs/infrastructure/plugins/sentinel.md): `sentinel()` 插件为您的认证系统提供全面的安全和滥用防护。它能够检测并防止多种攻击手段，包括凭证填充、不可能的旅行、免费试用滥用等。
- [邮件服务](/llms.txt/docs/infrastructure/services/email.md): Better Auth Infrastructure 提供了一个托管的事务性邮件服务，内置常用身份验证流程的模板。发送验证邮件、密码重置邮件、邀请函等，无需管理邮件基础设施。
- [短信服务](/llms.txt/docs/infrastructure/services/sms.md): Better Auth Infrastructure 提供托管的短信服务，用于发送用于手机号验证和双因素认证的一次性验证码。发送验证码无需管理短信供应商。

### Installation

- [安装](/llms.txt/docs/installation.md): 学习如何在你的项目中配置 Better Auth。

### Integrations

- [Astro 集成](/llms.txt/docs/integrations/astro.md): 将 Better Auth 集成到 Astro 中。
- [凸集成](/llms.txt/docs/integrations/convex.md): 将 Better Auth 与 Convex 集成。
- [Electron 集成](/llms.txt/docs/integrations/electron.md): 将 Better Auth 集成到 Electron 中。
- [Elysia 集成](/llms.txt/docs/integrations/elysia.md): 将 Better Auth 集成到 Elysia 中。
- [Encore 集成](/llms.txt/docs/integrations/encore.md): 将 Better Auth 与 Encore 集成。
- [Expo 集成](/llms.txt/docs/integrations/expo.md): 将 Better Auth 与 Expo 集成。
- [Express 集成](/llms.txt/docs/integrations/express.md): 将 Better Auth 与 Express 集成。
- [Better Auth 与 Fastify 集成指南](/llms.txt/docs/integrations/fastify.md): 学习如何将 Better Auth 无缝集成到您的 Fastify 应用中。
- [Hono 集成](/llms.txt/docs/integrations/hono.md): 将 Better Auth 集成到 Hono 中。
- [Lynx 集成](/llms.txt/docs/integrations/lynx.md): 将 Better Auth 集成到 Lynx 跨平台框架中。
- [NestJS 集成](/llms.txt/docs/integrations/nestjs.md): 将 Better Auth 与 NestJS 集成。
- [Next.js 集成](/llms.txt/docs/integrations/next.md): 将 Better Auth 与 Next.js 集成。
- [Nitro 集成](/llms.txt/docs/integrations/nitro.md): 将 Better Auth 集成到 Nitro。
- [Nuxt 集成](/llms.txt/docs/integrations/nuxt.md): 将 Better Auth 集成到 Nuxt 中。
- [React Router v7 集成](/llms.txt/docs/integrations/react-router.md): 将 Better Auth 集成到 React Router v7（前 Remix）。
- [SolidStart 集成](/llms.txt/docs/integrations/solid-start.md): 将 Better Auth 集成到 SolidStart 中。
- [SvelteKit 集成](/llms.txt/docs/integrations/svelte-kit.md): 将 Better Auth 集成到 SvelteKit 中。
- [TanStack Start 集成](/llms.txt/docs/integrations/tanstack.md): 将 Better Auth 集成到 TanStack Start。
- [Waku 集成](/llms.txt/docs/integrations/waku.md): 将 Better Auth 集成到 Waku 中。

### Introduction

- [介绍](/llms.txt/docs/introduction.md): 关于 Better Auth 的介绍。

### Plugins

- [双重身份验证 (2FA)](/llms.txt/docs/plugins/2fa.md): 通过双重身份验证增强您的应用安全性。
- [管理员](/llms.txt/docs/plugins/admin.md): Better Auth 的管理员插件
- [Agent Auth](/llms.txt/docs/plugins/agent-auth.md): AI Agent 的身份认证、注册、发现以及基于能力的授权。
- [匿名](/llms.txt/docs/plugins/anonymous.md): 用于 Better Auth 的匿名插件。
- [秋季计费](/llms.txt/docs/plugins/autumn.md): 秋季计费的更佳认证插件
- [Bearer 令牌认证](/llms.txt/docs/plugins/bearer.md): 使用 Bearer 令牌而非浏览器 cookie 来认证 API 请求
- [验证码](/llms.txt/docs/plugins/captcha.md): 验证码插件
- [Chargebee](/llms.txt/docs/plugins/chargebee.md): 用于 Better Auth 的 Chargebee 插件，用于管理订阅和支付。
- [社区插件](/llms.txt/docs/plugins/community-plugins.md): 由社区构建的扩展 Better Auth 功能的插件。
- [Creem](/llms.txt/docs/plugins/creem.md): 使用 Creem 的支付和订阅管理的更好认证插件
- [设备授权](/llms.txt/docs/plugins/device-authorization.md): 针对输入受限设备的 OAuth 2.0 设备授权授予
- [Dodo Payments](/llms.txt/docs/plugins/dodopayments.md): 更好的 Dodo Payments 认证插件
- [Dub](/llms.txt/docs/plugins/dub.md): 使用 Dub 链接和 OAuth 关联进行更好的潜在客户跟踪认证插件
- [电子邮件 OTP](/llms.txt/docs/plugins/email-otp.md): 用于 Better Auth 的电子邮件 OTP 插件。
- [通用 OAuth](/llms.txt/docs/plugins/generic-oauth.md): 使用任何 OAuth 提供商进行用户身份验证
- [我是否已经被泄露](/llms.txt/docs/plugins/have-i-been-pwned.md): 一个用于检查密码是否已被泄露的插件
- [i18n](/llms.txt/docs/plugins/i18n.md): 用于翻译错误信息的国际化插件
- [插件](/llms.txt/docs/plugins.md): 浏览所有 Better Auth 插件 — 身份验证、授权、支付、安全等功能。
- [JWT](/llms.txt/docs/plugins/jwt.md): 在无法使用 session 的服务中使用 JWT 令牌进行用户认证
- [上次登录方式](/llms.txt/docs/plugins/last-login-method.md): 跟踪并显示用户最后使用的身份验证方式
- [魔法链接](/llms.txt/docs/plugins/magic-link.md): 魔法链接插件
- [MCP](/llms.txt/docs/plugins/mcp.md): 用于 Better Auth 的 MCP 提供者插件
- [多会话](/llms.txt/docs/plugins/multi-session.md): 学习如何在 Better Auth 中使用多会话插件。
- [OAuth 2.1 提供者](/llms.txt/docs/plugins/oauth-provider.md): 一个更好的认证插件，使您的认证服务器能够作为 OAuth 2.1 提供者运行。
- [OAuth 代理](/llms.txt/docs/plugins/oauth-proxy.md): Better Auth 的 OAuth 代理插件
- [OIDC 提供者](/llms.txt/docs/plugins/oidc-provider.md): Better Auth 的 Open ID Connect 插件，允许您拥有自己的 OIDC 提供者。
- [一键登录](/llms.txt/docs/plugins/one-tap.md): 用于 Better Auth 的一键登录插件
- [一次性令牌插件](/llms.txt/docs/plugins/one-time-token.md): 生成和验证一次性令牌
- [开放 API](/llms.txt/docs/plugins/open-api.md): Better Auth 的开放 API 参考。
- [组织](/llms.txt/docs/plugins/organization.md): 组织插件允许您管理组织的成员和团队。
- [Passkey 密钥](/llms.txt/docs/plugins/passkey.md): Passkey 密钥
- [电话号码](/llms.txt/docs/plugins/phone-number.md): 电话号码插件
- [Polar](/llms.txt/docs/plugins/polar.md): 使用 Polar 实现更佳的支付和结账验证插件
- [跨域身份管理系统（SCIM）](/llms.txt/docs/plugins/scim.md): 将 SCIM 集成到您的应用程序中。
- [以太坊登录（SIWE）](/llms.txt/docs/plugins/siwe.md): Better Auth 的以太坊登录插件
- [单点登录（SSO）](/llms.txt/docs/plugins/sso.md): 将单点登录（SSO）集成到您的应用程序中。
- [Stripe](/llms.txt/docs/plugins/stripe.md): Stripe 插件，用于 Better Auth，管理订阅和支付。
- [测试工具](/llms.txt/docs/plugins/test-utils.md): 用于集成测试和端到端测试的测试实用工具
- [用户名](/llms.txt/docs/plugins/username.md): 用户名插件
- [高级功能](/llms.txt/docs/plugins/api-key/advanced.md): 高级 API 密钥功能，包括会话、多配置、组织密钥、存储模式等。
- [API 密钥](/llms.txt/docs/plugins/api-key.md): Better Auth 的 API 密钥插件。
- [参考](/llms.txt/docs/plugins/api-key/reference.md): API 密钥插件选项、权限及模式参考。

### Reference

- [为 BetterAuth 贡献代码](/llms.txt/docs/reference/contributing.md): 关于如何为 BetterAuth 贡献代码的简明指南
- [常见问题解答](/llms.txt/docs/reference/faq.md): 关于 Better Auth 的常见问题解答。
- [仪器化（实验性）](/llms.txt/docs/reference/instrumentation.md): Better Auth 的分布式追踪
- [选项](/llms.txt/docs/reference/options.md): Better Auth 配置选项参考。
- [资源](/llms.txt/docs/reference/resources.md): 精选资源合集，助你学习并掌握 Better Auth。
- [安全性](/llms.txt/docs/reference/security.md): Better Auth 的安全功能。
- [远程测量](/llms.txt/docs/reference/telemetry.md): Better Auth 现在会收集有关一般使用情况的匿名远程测量数据。
- [账号已关联到不同用户](/llms.txt/docs/reference/errors/account_already_linked_to_different_user.md): 该账号已经关联到另一个不同的用户。
- [account\_not\_linked](/llms.txt/docs/reference/errors/account_not_linked.md): 提供商账户未与当前用户关联，且无法自动关联。
- [email_doesn't_match](/llms.txt/docs/reference/errors/email_doesn't_match.md): 电子邮件与账户的电子邮件不匹配。
- [email_not_found](/llms.txt/docs/reference/errors/email_not_found.md): 提供方未返回电子邮件地址。
- [错误](/llms.txt/docs/reference/errors.md): Better Auth 中可能出现的错误。
- [internal\_server\_error](/llms.txt/docs/reference/errors/internal_server_error.md): 认证过程中发生了一个意外错误。
- [invalid_callback_request](/llms.txt/docs/reference/errors/invalid_callback_request.md): 回调请求无效。
- [invalid\_code](/llms.txt/docs/reference/errors/invalid_code.md): 提供的身份验证代码无效或已过期。
- [无回调 URL](/llms.txt/docs/reference/errors/no_callback_url.md): 请求中未找到回调 URL。
- [no_code](/llms.txt/docs/reference/errors/no_code.md): 请求中未找到代码。
- [oauth_provider_not_found](/llms.txt/docs/reference/errors/oauth_provider_not_found.md): 未找到 OAuth 提供者。
- [请重启该流程](/llms.txt/docs/reference/errors/please_restart_the_process.md): 无法解析 OAuth 状态。必须重新启动登录流程。
- [禁用注册](/llms.txt/docs/reference/errors/signup_disabled.md): 禁用注册错误
- [state_mismatch](/llms.txt/docs/reference/errors/state_mismatch.md): OAuth 回调期间状态验证失败。涵盖所有与状态相关的错误代码及其原因。
- [state_not_found](/llms.txt/docs/reference/errors/state_not_found.md): 请求中未找到 state 参数。
- [unable\_to\_create\_session](/llms.txt/docs/reference/errors/unable_to_create_session.md): 在身份验证期间无法创建会话。
- [unable\_to\_create\_user](/llms.txt/docs/reference/errors/unable_to_create_user.md): 身份验证期间无法创建用户。
- [无法获取用户信息](/llms.txt/docs/reference/errors/unable_to_get_user_info.md): 请求中未找到用户信息。
- [无法关联账户](/llms.txt/docs/reference/errors/unable_to_link_account.md): 无法关联该账户。
- [未知错误](/llms.txt/docs/reference/errors/unknown.md): 发生了未知错误。

