配置 GitHub 身份验证
创建 GitHub App
- 前往 GitHub 开发者设置
- 填写 GitHub App name 和 Homepage URL
配置回调 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。访问令牌在用户撤销、应用撤销或一年未使用前会一直有效。