EasyStarter logoEasyStarter
认证服务

邮箱密码登录

配置 Better Auth 邮箱密码注册与登录

邮箱密码登录

EasyStarter 使用 Better Auth 作为认证方案,内置了邮箱 + 密码登录。

服务端配置位于 apps/server/src/lib/auth.ts

如果你启用了邮箱注册验证或忘记密码,还需要先完成 邮件服务 配置。

所需环境变量

BETTER_AUTH_SECRET=

获取 BETTER_AUTH_SECRET

BETTER_AUTH_SECRET 用于 Better Auth 签名和加密会话数据,必须是一个足够长的随机字符串。

你可以直接自己生成一个,例如:

openssl rand -base64 32

复制生成结果,填到:

apps/server/.dev.vars
BETTER_AUTH_SECRET=your-random-secret
apps/server/.env.production
BETTER_AUTH_SECRET=your-random-secret

填入环境变量

本地开发建议统一放到 apps/server/.dev.vars

apps/server/.dev.vars
BETTER_AUTH_SECRET=your-long-random-secret

生产部署时,敏感值放到 apps/server/.env.production

apps/server/.env.production
BETTER_AUTH_SECRET=your-long-random-secret

邮箱密码认证功能

EasyStarter 当前的邮箱密码认证配置负责:

  • 邮箱密码注册和登录
  • 邮箱验证
  • 忘记密码
  • 基于 Cookie 的会话管理

核心配置文件:

apps/server/src/lib/auth.ts