better-auth
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseBetter Auth API リファレンス
Better Auth API 参考文档
Better Auth — TypeScript 向けフレームワーク非依存の認証・認可フレームワーク。
対象 Better Auth v1.7.10(docs: GitHub tag v1.7.10、取得 2026-10-17)。1.6 からの移行は 。
ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。
references/guides/1-7-upgrade-guide.mdBetter Auth——面向 TypeScript 的框架无关认证与授权框架。
适用 Better Auth v1.7.10(文档:GitHub tag v1.7.10,获取于 2026-10-17)。从 1.6 升级请参阅 。
应根据用户任务读取相应的 README.md,再从那里进入各个具体文件。
references/guides/1-7-upgrade-guide.mdディレクトリ構成
目录结构
text
skills/better-auth/
SKILL.md
references/
getting-started/
README.md
installation.md
basic-usage.md
concepts/
README.md
api.md
cli.md
client.md
cookies.md
database.md
dynamic-base-url.md
email.md
hooks.md
oauth.md
plugins.md
rate-limit.md
session-management.md
typescript.md
users-accounts.md
adapters/
README.md
community-adapters.md
drizzle.md
mongodb.md
mssql.md
mysql.md
other-relational.md
postgresql.md
prisma.md
sqlite.md
integrations/
README.md
astro.md
convex.md
electron.md
elysia.md
encore.md
expo.md
express.md
fastify.md
hono.md
lynx.md
nestjs.md
next.md
nitro.md
nuxt.md
react-router.md
solid-start.md
svelte-kit.md
tanstack.md
waku.md
effect.md
examples/
README.md
astro.md
next-js.md
nuxt.md
react-router.md
svelte-kit.md
authentication/
README.md
email-password.md
social-providers-common.md
other-social-providers.md
social-apple.md
social-atlassian.md
social-cloudflare.md
social-cognito.md
social-discord.md
social-dropbox.md
social-facebook.md
social-figma.md
social-github.md
social-gitlab.md
social-google.md
social-huggingface.md
social-kakao.md
social-kick.md
social-line.md
social-linear.md
social-linkedin.md
social-microsoft.md
social-naver.md
social-notion.md
social-paybin.md
social-paypal.md
social-polar.md
social-railway.md
social-reddit.md
social-roblox.md
social-salesforce.md
social-slack.md
social-spotify.md
social-tiktok.md
social-twitch.md
social-twitter.md
social-vercel.md
social-vk.md
social-wechat.md
social-zoom.md
plugins/
README.md
admin.md
agent-auth.md
anonymous.md
api-key.md
api-key-advanced.md
api-key-reference.md
autumn.md
bearer.md
captcha.md
chargebee.md
cimd.md
commet.md
community-plugins.md
creem.md
device-authorization.md
dodopayments.md
dub.md
email-otp.md
generic-oauth.md
have-i-been-pwned.md
i18n.md
jwt.md
last-login-method.md
magic-link.md
mcp.md
multi-session.md
oauth-provider.md
oauth-proxy.md
oidc-provider.md
one-tap.md
one-time-token.md
open-api.md
organization.md
passkey.md
phone-number.md
polar.md
scim.md
scim-groups-and-roles.md
scim-reference.md
siwe.md
sso.md
stripe.md
test-utils.md
two-factor.md
username.md
infrastructure/
README.md
introduction.md
getting-started.md
dashboard.md
audit-logs.md
sentinel.md
email-service.md
sms-service.md
reference/
README.md
contributing.md
options.md
resources.md
security.md
faq.md
instrumentation.md
telemetry.md
errors.md
error-account-already-linked.md
error-account-not-linked.md
error-email-doesnt-match.md
error-email-not-found.md
error-internal-server-error.md
error-invalid-callback-request.md
error-invalid-code.md
error-no-callback-url.md
error-no-code.md
error-oauth-provider-not-found.md
error-signup-disabled.md
error-state-invalid.md
error-state-mismatch.md
error-state-not-found.md
error-unable-to-create-session.md
error-unable-to-create-user.md
error-unable-to-get-user-info.md
error-unable-to-link-account.md
error-unknown.md
guides/
README.md
1-7-upgrade-guide.md
auth0-migration.md
browser-extension.md
clerk-migration.md
create-a-db-adapter.md
dynamic-base-url.md
next-auth-migration.md
optimizing-for-performance.md
saml-sso-with-okta.md
supabase-migration.md
workos-migration.md
your-first-plugin.md
samples/
README.md
astro.md
client-setup.md
convex.md
electron.md
elysia.md
email-password-auth.md
email-verification.md
encore.md
expo.md
express.md
fastify.md
hono.md
hooks.md
lynx.md
mcp-server.md
nestjs.md
next.md
nitro.md
nuxt.md
password-reset.md
react-router.md
server-setup.md
session-management.md
sign-out.md
social-sign-in.md
solid-start.md
svelte-kit.md
tanstack.md
two-factor-auth.md
user-management.md
waku.md
scripts/
README.md
cli.md
generate.md
install.mdtext
skills/better-auth/
SKILL.md
references/
getting-started/
README.md
installation.md
basic-usage.md
concepts/
README.md
api.md
cli.md
client.md
cookies.md
database.md
dynamic-base-url.md
email.md
hooks.md
oauth.md
plugins.md
rate-limit.md
session-management.md
typescript.md
users-accounts.md
adapters/
README.md
community-adapters.md
drizzle.md
mongodb.md
mssql.md
mysql.md
other-relational.md
postgresql.md
prisma.md
sqlite.md
integrations/
README.md
astro.md
convex.md
electron.md
elysia.md
encore.md
expo.md
express.md
fastify.md
hono.md
lynx.md
nestjs.md
next.md
nitro.md
nuxt.md
react-router.md
solid-start.md
svelte-kit.md
tanstack.md
waku.md
effect.md
examples/
README.md
astro.md
next-js.md
nuxt.md
react-router.md
svelte-kit.md
authentication/
README.md
email-password.md
social-providers-common.md
other-social-providers.md
social-apple.md
social-atlassian.md
social-cloudflare.md
social-cognito.md
social-discord.md
social-dropbox.md
social-facebook.md
social-figma.md
social-github.md
social-gitlab.md
social-google.md
social-huggingface.md
social-kakao.md
social-kick.md
social-line.md
social-linear.md
social-linkedin.md
social-microsoft.md
social-naver.md
social-notion.md
social-paybin.md
social-paypal.md
social-polar.md
social-railway.md
social-reddit.md
social-roblox.md
social-salesforce.md
social-slack.md
social-spotify.md
social-tiktok.md
social-twitch.md
social-twitter.md
social-vercel.md
social-vk.md
social-wechat.md
social-zoom.md
plugins/
README.md
admin.md
agent-auth.md
anonymous.md
api-key.md
api-key-advanced.md
api-key-reference.md
autumn.md
bearer.md
captcha.md
chargebee.md
cimd.md
commet.md
community-plugins.md
creem.md
device-authorization.md
dodopayments.md
dub.md
email-otp.md
generic-oauth.md
have-i-been-pwned.md
i18n.md
jwt.md
last-login-method.md
magic-link.md
mcp.md
multi-session.md
oauth-provider.md
oauth-proxy.md
oidc-provider.md
one-tap.md
one-time-token.md
open-api.md
organization.md
passkey.md
phone-number.md
polar.md
scim.md
scim-groups-and-roles.md
scim-reference.md
siwe.md
sso.md
stripe.md
test-utils.md
two-factor.md
username.md
infrastructure/
README.md
introduction.md
getting-started.md
dashboard.md
audit-logs.md
sentinel.md
email-service.md
sms-service.md
reference/
README.md
contributing.md
options.md
resources.md
security.md
faq.md
instrumentation.md
telemetry.md
errors.md
error-account-already-linked.md
error-account-not-linked.md
error-email-doesnt-match.md
error-email-not-found.md
error-internal-server-error.md
error-invalid-callback-request.md
error-invalid-code.md
error-no-callback-url.md
error-no-code.md
error-oauth-provider-not-found.md
error-signup-disabled.md
error-state-invalid.md
error-state-mismatch.md
error-state-not-found.md
error-unable-to-create-session.md
error-unable-to-create-user.md
error-unable-to-get-user-info.md
error-unable-to-link-account.md
error-unknown.md
guides/
README.md
1-7-upgrade-guide.md
auth0-migration.md
browser-extension.md
clerk-migration.md
create-a-db-adapter.md
dynamic-base-url.md
next-auth-migration.md
optimizing-for-performance.md
saml-sso-with-okta.md
supabase-migration.md
workos-migration.md
your-first-plugin.md
samples/
README.md
astro.md
client-setup.md
convex.md
electron.md
elysia.md
email-password-auth.md
email-verification.md
encore.md
expo.md
express.md
fastify.md
hono.md
hooks.md
lynx.md
mcp-server.md
nestjs.md
next.md
nitro.md
nuxt.md
password-reset.md
react-router.md
server-setup.md
session-management.md
sign-out.md
social-sign-in.md
solid-start.md
svelte-kit.md
tanstack.md
two-factor-auth.md
user-management.md
waku.md
scripts/
README.md
cli.md
generate.md
install.md探索手順
探索步骤
タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:
- 下記マッピング表でタスクに対応するカテゴリを探す
- そのカテゴリの を参照して目的のページを特定する
references/{category}/README.md - 該当ページの を Read して詳細を確認する
.md
根据任务确定类别,并通过该类别的 README.md 定位目标页面:
- 在下方映射表中查找与任务对应的类别
- 参阅该类别的 ,定位目标页面
references/{category}/README.md - 使用 读取目标页面的
Read文件,确认详细信息.md
タスク → カテゴリ マッピング
任务 → 类别映射
| タスク | カテゴリ | 参照 README |
|---|---|---|
| インストール・初期設定・auth インスタンス作成 | getting-started | references/getting-started/README.md |
| 基本的な認証パターン・メール/パスワード・セッション取得の概要 | getting-started | references/getting-started/README.md |
| auth.api・クライアント・セッション管理・Cookie・DB・フック・レートリミット | concepts | references/concepts/README.md |
| OAuth フロー・型安全性・プラグイン概念・動的ベース URL | concepts | references/concepts/README.md |
| Prisma / Drizzle / MongoDB / SQLite / PostgreSQL / MySQL 等の DB アダプター | adapters | references/adapters/README.md |
| コミュニティ製サードパーティ DB アダプター | adapters | references/adapters/README.md |
| Next.js / Nuxt / SvelteKit / Hono / Express / Fastify / Expo 等フレームワーク統合 | integrations | references/integrations/README.md |
| Astro / React Router / TanStack / Convex / Electron / NestJS 等の統合手順 | integrations | references/integrations/README.md |
| 公式ウォークスルー実例 (Astro, Next.js, Nuxt, React Router, SvelteKit) | examples | references/examples/README.md |
| Email/Password 認証・ソーシャルログイン (GitHub, Google, Apple 等) | authentication | references/authentication/README.md |
| 特定ソーシャルプロバイダー (Discord, Microsoft, LINE, Twitter 等) の設定 | authentication | references/authentication/README.md |
| 2FA (TOTP)・パスキー・マジックリンク・SMS OTP・匿名認証 | plugins | references/plugins/README.md |
| Organization・Admin・SSO・SCIM・API Key・JWT・Bearer トークン | plugins | references/plugins/README.md |
| Stripe / Chargebee / Polar / Autumn 等の課金・サブスクリプション統合 | plugins | references/plugins/README.md |
| MCP 認証・エージェント認証・SIWE・キャプチャ・パスワード漏洩チェック | plugins | references/plugins/README.md |
| コミュニティ製プラグイン一覧を確認したい | plugins | references/plugins/README.md |
| OAuth 2.1 / OIDC プロバイダー構築・CIMD・DPoP | plugins | references/plugins/README.md |
| SCIM の groups・roles・reference | plugins | references/plugins/README.md |
| Effect HTTP server 統合 | integrations | references/integrations/README.md |
| Better Auth Infrastructure(有料。@better-auth/infra の dash / sentinel、audit logs、managed email / SMS) | infrastructure | references/infrastructure/README.md |
| 設定オプション一覧・セキュリティガイド・FAQ | reference | references/reference/README.md |
| エラーコード調査・OpenTelemetry・テレメトリー | reference | references/reference/README.md |
| コントリビューションガイド・コミュニティ動画/ブログ等のリソース集 | reference | references/reference/README.md |
| 1.6 → 1.7 アップグレード・破壊的変更(npx auth upgrade) | guides | references/guides/README.md |
| Auth.js (NextAuth) / Auth0 / Clerk / Supabase / WorkOS からの移行 | guides | references/guides/README.md |
| カスタムプラグイン作成・カスタム DB アダプター作成・パフォーマンス最適化 | guides | references/guides/README.md |
| SAML SSO (Okta)・ブラウザ拡張機能統合・動的ベース URL 詳細 | guides | references/guides/README.md |
| 典型的な使い方・動作するコード例・フレームワーク別セットアップ断片 | samples | samples/README.md |
| インストールコマンド・CLI コマンド・スキーマ生成を知りたい | scripts | scripts/README.md |
| 任务 | 类别 | 参考 README |
|---|---|---|
| 安装、初始设置与创建 auth 实例 | getting-started | references/getting-started/README.md |
| 基本认证模式、邮件/密码认证以及获取会话的概述 | getting-started | references/getting-started/README.md |
| auth.api、客户端、会话管理、Cookie、DB、Hook 与速率限制 | concepts | references/concepts/README.md |
| OAuth 流程、类型安全、插件概念与动态 Base URL | concepts | references/concepts/README.md |
| Prisma / Drizzle / MongoDB / SQLite / PostgreSQL / MySQL 等 DB 适配器 | adapters | references/adapters/README.md |
| 社区开发的第三方 DB 适配器 | adapters | references/adapters/README.md |
| Next.js / Nuxt / SvelteKit / Hono / Express / Fastify / Expo 等框架集成 | integrations | references/integrations/README.md |
| Astro / React Router / TanStack / Convex / Electron / NestJS 等集成步骤 | integrations | references/integrations/README.md |
| 官方分步教程示例(Astro、Next.js、Nuxt、React Router、SvelteKit) | examples | references/examples/README.md |
| Email/Password 认证与社交登录(GitHub、Google、Apple 等) | authentication | references/authentication/README.md |
| 特定社交 Provider(Discord、Microsoft、LINE、Twitter 等)的配置 | authentication | references/authentication/README.md |
| 2FA(TOTP)、Passkey、魔法链接、SMS OTP 与匿名认证 | plugins | references/plugins/README.md |
| Organization、Admin、SSO、SCIM、API Key、JWT 与 Bearer Token | plugins | references/plugins/README.md |
| Stripe / Chargebee / Polar / Autumn 等计费与订阅集成 | plugins | references/plugins/README.md |
| MCP 认证、Agent 认证、SIWE、CAPTCHA 与密码泄露检查 | plugins | references/plugins/README.md |
| 查看社区插件列表 | plugins | references/plugins/README.md |
| 构建 OAuth 2.1 / OIDC Provider、CIMD 与 DPoP | plugins | references/plugins/README.md |
| SCIM 的 groups、roles 与 reference | plugins | references/plugins/README.md |
| Effect HTTP server 集成 | integrations | references/integrations/README.md |
| Better Auth Infrastructure(付费,包含 @better-auth/infra 的 dash / sentinel、审计日志、托管邮件 / SMS) | infrastructure | references/infrastructure/README.md |
| 配置选项列表、安全指南与 FAQ | reference | references/reference/README.md |
| 排查错误代码、OpenTelemetry 与遥测 | reference | references/reference/README.md |
| 贡献指南、社区视频/博客等资源合集 | reference | references/reference/README.md |
1.6 → 1.7 升级与破坏性变更( | guides | references/guides/README.md |
| 从 Auth.js(NextAuth)/ Auth0 / Clerk / Supabase / WorkOS 迁移 | guides | references/guides/README.md |
| 创建自定义插件、自定义 DB 适配器与性能优化 | guides | references/guides/README.md |
| SAML SSO(Okta)、浏览器扩展集成与动态 Base URL 详解 | guides | references/guides/README.md |
| 典型用法、可运行的代码示例与按框架划分的设置片段 | samples | samples/README.md |
| 安装命令、CLI 命令与 Schema 生成 | scripts | scripts/README.md |