写在前面
想用N8N自动化操作GitHub仓库,却卡在授权配置上?
别担心,这篇教程就是为你准备的!
无需任何代码基础,跟着做就能轻松搞定。
让我们告别手动操作,让工作流自动跑起来!
配置目的
让 n8n 工作流可以自动操作你的 GitHub 仓库。
比如自动备份数据、更新网站内容,或者定时提交代码。
配置好后,这些繁琐任务都能交给 n8n 自动完成。
前置条件
你只需要一个 GitHub 账号。
如果你还没有,可以免费注册一个。
授权所需的凭证,我们会在下面一步步教你创建。
账号平台准备
n8n 连接 GitHub 有两种方式。
一种是“个人访问令牌”,最简单,推荐新手使用。
另一种是“OAuth应用”,适合自部署n8n的用户。
获取访问令牌(PAT)
这是最快、最直接的方式,我们以此为例。
1. 登录 GitHub,点击右上角头像,选择 Settings。
2. 在左侧菜单滑到最下方,找到并点击 Developer settings。
3. 接着点击 Personal access tokens,然后选择 Tokens (classic)。
4. 点击 Generate new token,选择 Generate new token (classic)。
5. 在 Note 字段给令牌起个名字,比如 n8n-automation,方便识别。
6. 选择 Expiration(有效期),新手可选 No expiration(永不过期)。
7. 关键一步!在 Select scopes(选择权限范围)里,务必勾选 repo 这一项。
这个权限能让 n8n 读写你的仓库文件。
8. 点击页面底部的 Generate token 生成令牌。
9. 立刻复制 生成的令牌!这个令牌只会显示一次,关掉页面就找不回了。
创建OAuth应用
如果你用的是n8n官方云服务,可以跳过这部分。
自部署 n8n 的用户请按以下步骤操作。
1. 在 n8n 里,先创建 GitHub 凭证,选择 OAuth2 方式。
你会看到一个 OAuth Redirect URL(OAuth重定向URL),先复制它。
2. 回到 GitHub 的 Developer settings,这次选择 OAuth Apps。
3. 点击 New OAuth App。
4. 填写应用名称,比如 n8n-integration。
5. Homepage URL 填写你 n8n 实例的首页地址。
6. 将第1步复制的URL,粘贴到 Authorization callback URL 输入框里。
7. 点击 Register application。
8. 在新页面里,你就能看到 Client ID 和 Client Secret 了,复制它们备用。
关键参数说明
拿到凭证信息后,我们回到 n8n 界面填写。
令牌配置(PAT)
在 n8n 凭证界面:
1. Authentication 选择 Access Token。
2. 在 Access Token 字段,粘贴你刚才复制的个人访问令牌(PAT)。
3. 点击 Save 保存即可。
OAuth2应用配置
在 n8n 凭证界面:
1. Authentication 选择 OAuth2。
2. Client ID 字段,粘贴你获取的 客户端ID。
3. Client Secret 字段,粘贴对应的 客户端密钥。
4. 点击 Connect my account,会跳转到 GitHub 授权页面。
5. 点击授权,即可完成连接。
常见错误提示
配置过程中遇到问题别慌,常见错误就这几个。
授权范围不足
如果你看到 “Not Found” 或权限相关的错误。
很可能是创建个人访问令牌(PAT)时,忘记勾选 repo 权限。
回到 GitHub 修改令牌权限,或重新创建一个即可。
凭证过期问题
如果之前用得好好的,突然报错了。
检查一下你的个人访问令牌(PAT)是否设置了有效期并且已过期。
如果是,重新生成一个令牌并更新到 n8n 凭证里。

