Magic Link 登录

无密码邮件链接登录配置指南

Magic Link(魔法链接)是一种无密码登录方式:用户输入邮箱后,系统发送一封包含登录链接的邮件,用户点击链接即自动登录,无需记忆密码。

当前配置

  • Magic Link 已在 auth-config.ts 中启用
  • disableSignUp: true 表示 Magic Link 仅用于已注册用户的登录,不支持通过 Magic Link 直接注册新账户
  • 登录链接由邮件服务(Resend 或 Zeabur Email)发送,模板 ID 为 magicLink

前端使用

在登录页面通过 authClient.signIn.magicLink({ email }) 发起请求:

import { authClient } from "@/lib/auth/client";

// 发送 Magic Link
await authClient.signIn.magicLink({ email: "user@example.com" });

用户收到邮件后点击链接即可完成登录。

如果不想使用 Magic Link 登录,可在 apps/01mvp-web/src/lib/config/index.ts 中将 auth.enableMagicLink 设为 false。注意这不会移除插件,只影响前端是否展示该选项。