很多网站会提供「使用 GitHub 登录」功能,用户不用单独注册账号,只需要授权 GitHub,就可以快速进入网站。下面按步骤说明如何配置。
先登录 GitHub,进入:
Settings → Developer settings → OAuth Apps → New OAuth App
填写以下信息:
填写你的网站名称,例如:
My Website
填写你的网站首页地址,例如:
https://example.com
本地开发可以先填写:
http://localhost:3000
这是最重要的一项,表示 GitHub 授权成功后跳回你网站的地址。
常见格式:
https://example.com/api/auth/callback/github
如果你使用的是 NextAuth / Auth.js,本地开发一般是:
http://localhost:3000/api/auth/callback/github
填写完成后,点击:
Register application

2



创建成功后,GitHub 会生成一个:
Client ID
然后点击:
Generate a new client secret
生成:
Client Secret
这两个值后面要配置到网站环境变量里。
注意:Client Secret 只显示一次,建议立即复制保存。

在项目根目录创建或修改 .env 文件。
以 Next.js / Auth.js 为例:
AUTH_GITHUB_ID=你的_Client_IDAUTH_GITHUB_SECRET=你的_Client_SecretAUTH_SECRET=随机生成的一串密钥AUTH_URL=http://localhost:3000
如果是生产环境:
AUTH_URL=https://example.com
AUTH_SECRET 可以用下面命令生成:
openssl rand -base64 32