MuseMVP 文档
社交登录

Google OAuth

配置 MuseMVP 的 Google OAuth 登录。

MuseMVP 通过 Better Auth 的社交 Provider 支持 Google OAuth。用户可直接使用 Google 账号一键登录或注册。

配置步骤

创建 Google OAuth 凭据

前往 Google Cloud Console 创建或选择项目。 Google Cloud Console Google Cloud Console

提示

如果你之前没有设置过 Google OAuth 应用 Google OAuth App Callback URL

Google OAuth App Callback URL

创建 OAuth 2.0 Client ID

APIs & Services → Credentials 创建 OAuth client ID,应用类型选择 Web application,并设置 Authorized redirect URI 为:<your-site-url>/api/auth/callback/google Google OAuth App Callback URL

Client ID 和 Client Secret

将两者添加到 .envGoogle OAuth App Client ID and Client Secret

GOOGLE_CLIENT_ID="3asfasdfasdfasdftest.apps.googleusercontent.com"
GOOGLE_CLIENT_SECRET="GOCSPX-FSADFASDFFASDuJjNxyMTV-hvj"
NEXT_PUBLIC_GOOGLE_ONE_TAP_CLIENT_ID="3asfasdfasdfasdftest.apps.googleusercontent.com"

确保 src/config/index.tsconfig.auth.gates.allowSocialSignIntrue


功能开关

可通过配置关闭社交登录:

// src/config/index.ts
auth: {
  gates: {
    allowSocialSignIn: false,  // 禁用 Google 与 GitHub
  },
},