00 / 00

Magic Link 登录

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

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

当前配置

  • Magic Link 插件在 products/muse/packages/auth/src/index.ts 中配置
  • AUTH_ENABLE_MAGIC_LINKS=true 时前端展示入口并允许发起 Magic Link 登录
  • 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 登录,将 AUTH_ENABLE_MAGIC_LINKS=false 或删除该变量即可。注意这不会移除插件代码,只影响前端入口和登录能力开关。

想和其他创造者交流?

这篇文档有问题?