使用 GitHub 单点登录到 Memos

在构建团队协作平台或知识系统时，接入 GitHub 登录是一种常见的低成本单点登录（SSO）方案，既简洁又安全。本教程将手把手教大家如何创建 GitHub OAuth 应用，并将其集成到 [Memos](https://github.com/usememos/memos) 等支持 OAuth 的系统中，帮助用户实现无感登录体验。


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.memos


---

## 一、创建 GitHub OAuth 应用

### 1. 打开 GitHub OAuth 应用配置入口

1. 登录 GitHub，点击右上角头像，选择 **Settings（设置）**
2. 在左侧栏选择 **Developer settings**
3. 点击 **OAuth Apps**，然后点击右侧的 **New OAuth App** 创建新的应用

📷 页面示意：



![创建 OAuth 应用](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/640-20250713224449968-20250713225034801.png)

---

### 2. 填写应用基本信息

在创建页面中填写如下字段：

- **Application Name**：如 `Console SSO`

- **Homepage URL**：建议填写系统主页，例如 `https://memos.name.heiyu.space`

- **Authorization callback URL**：授权成功后的回调地址，格式如下：

  ```
  https://memos.name.heiyu.space/auth/callback
  ```

📷 示例填写界面：

![填写信息](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/image-20250713224139574.png)

---

### 3. 获取 Client ID 和 Client Secret

提交后，GitHub 将生成：

- **Client ID**：用于标识该 OAuth 应用
- **Client Secret**：用于身份验证，请妥善保存，**不要泄露！**

📷 凭证界面如下：

![获取客户端凭证](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/640)

---

## 二、查看和管理 OAuth 应用

创建完成后，返回 OAuth 应用列表，即可看到刚创建的应用。

点击应用名可查看授权信息和应用详情：

📷 应用列表和详情视图：

- 应用列表页面
  ![OAuth 应用列表](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/640-20250713224027323-20250713224450558-20250713225035672)

  然后邮件会收到 Github 绑定 Oauth 的通知。
  ![授权详情](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/bb21e51f43bf5eedd8b6c44ef27e3fd9-20250713225035879.png)

---

### 4. 在 Memos 中配置 GitHub 登录

进入系统设置页面：

1. 点击左下角齿轮图标（设置）
2. 选择 **单点登录（SSO）**
3. 选择 GitHub 作为登录方式，填写刚获取的 Client ID 和 Client Secret

📷 Memos 配置页面示例：

![设置 GitHub 单点登录](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/image-20250713224629619.png)

配置保存后，注销当前账号，登录页面会显示 GitHub 登录按钮。

📷 登录页面展示效果：

![GitHub 登录入口](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/26dac7e6f9531a83010a5cc44e95c71f-20250713225036385.png)

通过以上步骤，我们完成了 GitHub 登录的接入流程：

✅ 创建并配置 GitHub OAuth 应用
✅ 获取并填入凭证
✅ 在 Memos 中启用 OAuth 登录