配置目的
还在手动备份 n8n 工作流吗?
担心误操作覆盖了重要修改?本教程帮你解决这个问题。
通过配置 GitPassword 凭证,你的 n8n 工作流就能安全地和远程代码仓库(如 GitHub)通信。
这能让你自动推送本地的修改,实现工作流的版本控制。
前置准备
开始前,请确保你已经拥有一个 GitHub 账号。
我们将使用 Personal Access Token (PAT) 作为密码进行验证。
这种方式比直接用账号密码更安全、更专业。
获取GitHub PAT
PAT(个人访问令牌)是连接 n8n 和 GitHub 的安全钥匙。
下面我们一步步来获取它。
第一步:进入创建页面
登录你的 GitHub 账号。
点击右上角的个人头像,在下拉菜单中选择 Settings。
在左侧导航栏的底部,找到并点击 Developer settings。
接着,在新的左侧导航栏中,点击 Personal access tokens,然后选择 Tokens (classic)。
点击页面右上方的 Generate new token 按钮,并选择 Generate new token (classic)。
第二步:配置令牌信息
Note (备注):给你的令牌起一个好记的名字,比如 n8n-workflow-push。
Expiration (有效期):建议选择一个有效期,比如90天。也可以选“No expiration”(无期限),但从安全角度不推荐。
Select scopes (选择权限):这是最关键的一步!请勾选 repo 这一项。
勾选它,就给了 n8n 读写你代码仓库的全部权限。
第三步:生成并复制
滚动到页面底部,点击 Generate token 按钮。
页面会生成一串以 ghp_ 开头的字符,这就是你的 PAT。
请立即复制并保存好它!这个令牌只会显示一次。
关闭页面后,你将无法再次看到完整的令牌。
配置n8n凭证
拿到 PAT 后,我们回到 n8n 界面来完成最后的配置。
在你的工作流中,找到需要验证的 Git 节点(比如 Push 操作)。
在节点的 Credential for Git 选项中,点击下拉菜单并选择 Create New。
关键参数填写
Credential Name (凭证名称):可以命名为 My GitHub PAT。
User (用户名):填写你的 GitHub 用户名。
Password / PAT (密码/令牌):请粘贴刚才复制的 PAT,而不是你的 GitHub 账户密码!
点击 Save 保存凭证。
现在,你的 n8n 工作流就已经具备了向 GitHub 推送代码的能力。
常见错误排查
配置后遇到认证失败或 403 错误?
别担心,通常是以下几个原因造成的:
PAT 权限不足:最常见的问题。请检查你的 PAT 是否勾选了 repo 权限范围。
PAT 已过期:检查你设置的 PAT 有效期是否已过。
用户名或 PAT 错误:确保填写的 GitHub 用户名无误,且 PAT 粘贴正确,没有多余的空格。

