OAuth 第三方登录

配置 GitHub、Google、Gitee 三种第三方账号登录。用户无需注册，直接使用第三方账号一键登录。

适用场景

• 降低注册门槛，提升用户转化率
• 减少用户记忆密码的负担
• 避免邮箱注册的验证步骤

GitHub 登录配置

第一步：创建 OAuth App

1. 登录 GitHub，进入 Settings → Developer settings → OAuth Apps
2. 点击 New OAuth App
3. 填写以下信息：
   • Application name：你的站点名称（如 AiBBS）
   • Homepage URL：你的站点地址（如 https://your-domain.com）
   • Authorization callback URL：https://your-domain.com/users/auth/github/callback
4. 点击 Register application

第二步：获取凭据

1. 创建成功后会显示 Client ID
2. 点击 Generate a new client secret 生成 Client Secret
3. 立即复制 Client Secret（只显示一次）

第三步：填入系统设置

1. 进入系统设置，找到「GitHub OAuth 登录」卡片
2. 填入 Client ID
3. 填入 Client Secret
4. 保存设置

提示

设置页面会自动生成回调地址，你可以直接复制该地址到 GitHub OAuth App 的回调 URL 中，确保两者一致。

---

Google 登录配置

第一步：创建 OAuth 凭据

1. 进入 Google Cloud Console
2. 创建项目（或选择已有项目）
3. 进入 APIs & Services → Credentials
4. 点击 Create Credentials → OAuth client ID
5. 应用类型选择 Web application
6. 填写名称（如 AiBBS Login）

第二步：配置授权重定向 URI

在 OAuth client ID 创建页面中：

1. 在 Authorized redirect URIs 中添加： https://your-domain.com/users/auth/google_oauth2/callback
2. 点击 Create

第三步：获取凭据并填入

1. 复制 Client ID 和 Client Secret
2. 进入系统设置，找到「Google OAuth 登录」卡片
3. 填入对应字段并保存

---

Gitee 登录配置

第一步：创建第三方应用

1. 登录 Gitee，进入 设置 → 第三方应用
2. 点击 创建应用
3. 填写以下信息：
   • 应用名称：你的站点名称
   • 应用主页：你的站点地址
   • 应用回调地址：https://your-domain.com/users/auth/gitee/callback
   • 权限：勾选 users_info（获取用户基本信息）

第二步：获取凭据并填入

1. 创建成功后获取 Client ID 和 Client Secret
2. 进入系统设置，找到「Gitee OAuth 登录」卡片
3. 填入对应字段并保存

---

验证配置

配置完成后，回到前台登录页面，确认第三方登录按钮已显示。点击按钮测试是否能正常跳转和回调。

注意

回调地址必须使用 HTTPS。如果使用 HTTP，第三方平台会拒绝回调请求。