LobeHub
LobeHub

配置 GitHub 身份验证

创建 GitHub App

  1. 前往 GitHub 开发者设置
  2. 填写 GitHub App name 和 Homepage URL
创建 GitHub App

配置回调 URL

回调 URL 格式:

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

按需设置 Webhook URL(不需要可禁用)。

填写其他字段

配置权限

设置读取用户邮箱地址的权限:

设置所需权限
设置读取邮件地址权限

设置公开访问还是仅自己访问。

设置访问权限

点击 Create GitHub App。

生成客户端密钥

创建成功后,点击 Generate a new client secret。

创建客户端密钥

保存 Client ID 和 Client Secret。

保存凭证

配置环境变量

环境变量类型描述
AUTH_SECRET必选会话加密密钥,使用 openssl rand -base64 32 生成
AUTH_SSO_PROVIDERS必选填写 github
AUTH_GITHUB_ID必选GitHub App 的 Client ID
AUTH_GITHUB_SECRET必选GitHub App 的 Client Secret

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

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

常见问题

email_not_found 错误

这通常是因为 GitHub App 没有邮箱读取权限。前往应用设置,导航到 Permissions & events > Account permissions > Email addresses,设置为 Read-only。

没有 Refresh Token

GitHub OAuth 不发放 refresh token。访问令牌在用户撤销、应用撤销或一年未使用前会一直有效。

相关资源