n8n 中文文档

通用 Git

通用 Git(Generic Git)提供商通过 URL 将环境连接到任意 Git 仓库,包括 GitHub 和 Bitbucket 上的仓库。它使用 SSH 密钥或用户名和访问令牌进行身份验证。

提示

Preview status 预览状态

环境功能处于 Preview 阶段,未来版本中可能会发生变化。在为生产实例设置之前,请先在测试实例上试用。

通用 Git 支持的功能

功能 是否支持
身份验证 SSH 密钥,或用户名和访问令牌
从列表中选择仓库和分支 否。你需要输入仓库 URL 和分支。
将每次推广推送到功能分支 是
推广审查 否。由某人在 Git 托管平台上手动合并功能分支。

使用 SSH 密钥连接

  1. 在 Connect Generic Git 连接通用 Git 对话框中,输入 Name 名称,并将 Authentication 身份验证 设置为 SSH key SSH 密钥。
  2. 选择 SSH key type SSH 密钥类型。n8n 会生成密钥对。
  3. 选择 Continue 继续,然后选择 Copy deploy key 复制部署密钥。
  4. 在你的 Git 托管平台上,将该密钥作为具有写入权限的部署密钥添加到仓库。

Bitbucket Cloud 只提供只读的仓库访问密钥,因此请使用用户名和访问令牌连接 Bitbucket Cloud,或者将部署密钥添加到 Bitbucket 账户而不是仓库。账户密钥会让 n8n 访问该账户能访问的所有仓库,因此请使用专用账户。

警告

请使用以 ssh:// 开头的 SSH 仓库 URL,例如 ssh://[email protected]/acme/n8n.git。Environments (Classic) 接受的 [email protected]:acme/n8n.git 格式在这里无效。

要更换密钥,请编辑提供商并选择 Generate a new key 生成新密钥。将新密钥添加到你的 Git 托管平台,然后在那里移除旧密钥。

使用用户名和访问令牌连接

  1. 在 Connect Generic Git 连接通用 Git 对话框中,输入 Name 名称,并将 Authentication 身份验证 设置为 Username and password 用户名和密码。
  2. 输入 Username 用户名,并在 Password or access token 密码或访问令牌 中输入一个对仓库具有写入权限的访问令牌。
  3. 选择 Continue 继续。

请使用不含凭据的 HTTPS 仓库 URL,例如 https://github.com/acme/n8n.git。

令牌需要哪些权限

通用 Git 只运行 Git 命令,不会调用 Git 托管平台的 API。令牌需要对仓库代码具有读写权限。如果你将每次推广推送到功能分支,它还需要创建分支的权限。

常见 Git 托管平台:

Git 托管平台 用户名 令牌
GitHub 你的 GitHub 用户名 针对该仓库的细粒度个人访问令牌(fine-grained personal access token),权限为 Contents:Read and write。这也涵盖创建分支。
GitLab 你的 GitLab 用户名 具有 write_repository 范围的个人、群组或项目访问令牌。如果使用细粒度个人访问令牌,请添加 Code:Download、Push,以及 Branch:Create。
Bitbucket Cloud 你的 Bitbucket 用户名 具有 read:repository:bitbucket 和 write:repository:bitbucket 范围的 API 令牌。

你无法更改提供商的身份验证方式。要切换,请创建另一个提供商。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。