LobeHub
LobeHub

配置 Google 身份验证

创建 Google OAuth 凭证

  1. 前往 Google Cloud Console
  2. 创建新项目或选择现有项目
  3. 点击 Create Credentials > OAuth client ID
  4. 如果是首次创建,需先配置 OAuth 同意屏幕(见下方步骤)
  5. 选择 Web application 作为应用类型
  6. 添加授权重定向 URI(见下方回调 URL 配置)
  7. 点击创建,保存 Client ID 和 Client Secret

配置 OAuth 同意屏幕

  1. 前往 APIs & Services > OAuth consent screen
  2. 选择用户类型:
    • External:适用于任何 Google 账户
    • Internal:仅限 Google Workspace 组织用户
  3. 填写应用名称、用户支持邮箱等必填信息
  4. 添加授权范围:email 和 profile
  5. 如果处于测试模式,需添加测试用户

配置回调 URL

在授权重定向 URI 中添加:

回调 URL 格式:

  • 本地开发: http://localhost:3210/api/auth/callback/google
  • 生产环境: https://your-domain.com/api/auth/callback/google

配置环境变量

环境变量类型描述
AUTH_SECRET必选会话加密密钥,使用 openssl rand -base64 32 生成
AUTH_SSO_PROVIDERS必选填写 google
AUTH_GOOGLE_ID必选Google Cloud Console 中的 Client ID
AUTH_GOOGLE_SECRET必选Google Cloud Console 中的 Client Secret

前往 📘 环境变量 可查阅相关变量详情。

部署成功后,用户将可以通过 Google 身份认证并使用 LobeHub。

常见问题

redirect_uri_mismatch 错误

确保 Google Cloud Console 中配置的回调 URL 与实际部署地址完全匹配,包括协议(http/https)和端口号。

测试模式限制

如果 OAuth 同意屏幕处于测试模式,只有添加为测试用户的 Google 账户才能登录。

相关资源