00 / 00
认证系统
Better Auth 配置、OAuth 提供商设置、手机号登录、Magic Link、2FA 和微信登录集成指南
会员专属文章
概览
项目使用 Better Auth 作为认证框架。Better Auth 是一个开源的 TypeScript 认证库，帮你处理用户注册、登录、会话管理等核心功能，无需从零实现。
- 配置位置:
products/muse/packages/auth/src/index.ts - 环境变量:
products/muse/packages/config/.env，跨产品共享配置为packages/config/.env
登录方式一览
项目支持以下登录方式，默认已开启邮箱 + 密码登录，其余方式需配置对应环境变量后才会生效。微信登录还需要显式设置 AUTH_ENABLE_WECHAT=true。
| 登录方式 | 所需环境变量 | 默认状态 |
|---|---|---|
| 邮箱 + 密码 | BETTER_AUTH_SECRET, DATABASE_URL | 已开启 |
| GitHub OAuth | GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET | 未配置则隐藏 |
| Google OAuth | GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET | 未配置则隐藏 |
| 微信扫码 (PC) | AUTH_ENABLE_WECHAT, WECHAT_WEBSITE_APP_ID, WECHAT_WEBSITE_APP_SECRET | 未开启或未配置则隐藏 |
| 微信授权 (手机) | AUTH_ENABLE_WECHAT, WECHAT_SERVICE_ACCOUNT_APP_ID, WECHAT_SERVICE_ACCOUNT_APP_SECRET | 未开启或未配置则隐藏 |
| 微信小程序 | WECHAT_MINIPROGRAM_APP_ID, WECHAT_MINIPROGRAM_APP_SECRET | 未配置则隐藏 |
| 手机号 + 短信验证码 | ALIBABA_CLOUD_ACCESS_KEY_ID, ALIBABA_CLOUD_ACCESS_KEY_SECRET | 已开启（默认使用阿里云 PNVS） |
| Magic Link（邮件链接） | AUTH_ENABLE_MAGIC_LINKS, ZEABUR_EMAIL_API_KEY, EMAIL_FROM | 默认关闭 |
| 用户名登录 | 无需额外配置 | 已开启 |
| 双因素认证 (2FA) | AUTH_ENABLE_TWO_FACTOR | 已开启 |
环境变量配置
这篇文档有问题？