Skip to content

OAuth 配置 ​

Google、GitHub 和 Apple 第三方认证设置。

Google OAuth ​

变量名默认值敏感说明
OAUTH_GOOGLE_ENABLEDfalse否启用 Google OAuth。
OAUTH_GOOGLE_CLIENT_ID(空)否Google OAuth 客户端 ID。
OAUTH_GOOGLE_CLIENT_SECRET(空)是Google OAuth 客户端密钥。

GitHub OAuth ​

变量名默认值敏感说明
OAUTH_GITHUB_ENABLEDfalse否启用 GitHub OAuth。
OAUTH_GITHUB_CLIENT_ID(空)否GitHub OAuth 客户端 ID。
OAUTH_GITHUB_CLIENT_SECRET(空)是GitHub OAuth 客户端密钥。

Apple OAuth ​

变量名默认值敏感说明
OAUTH_APPLE_ENABLEDfalse否启用 Apple OAuth。
OAUTH_APPLE_CLIENT_ID(空)否Apple OAuth 客户端 ID(Service ID)。
OAUTH_APPLE_CLIENT_SECRET(空)是Apple OAuth 客户端密钥。
OAUTH_APPLE_TEAM_ID(空)否Apple Team ID。
OAUTH_APPLE_KEY_ID(空)否Apple Key ID。

设置指南 ​

Google OAuth ​

  1. 前往 Google Cloud Console
  2. 创建新项目或选择现有项目
  3. 导航到 APIs & Services > Credentials
  4. 创建 OAuth 2.0 Client ID(Web 应用)
  5. 添加回调 URI:https://your-domain.com/api/auth/oauth/google/callback

GitHub OAuth ​

  1. 前往 GitHub Developer Settings
  2. 点击 New OAuth App
  3. 设置 Authorization callback URL:https://your-domain.com/api/auth/oauth/github/callback

Apple OAuth ​

  1. 前往 Apple Developer
  2. 在 Certificates, Identifiers & Profiles 中注册 Services ID
  3. 为你的域名配置 Sign in with Apple

示例 ​

bash
# Google
OAUTH_GOOGLE_ENABLED=true
OAUTH_GOOGLE_CLIENT_ID=your-google-client-id.apps.googleusercontent.com
OAUTH_GOOGLE_CLIENT_SECRET=GOCSPX-your-secret

# GitHub
OAUTH_GITHUB_ENABLED=true
OAUTH_GITHUB_CLIENT_ID=Ov23lixxxxxxxxx
OAUTH_GITHUB_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx