跳到主要内容

为环境设置源码控制#

将Git仓库关联至n8n实例并配置源码控制。

n8n使用源码控制来提供环境。更多信息请参阅n8n中的环境。

前置要求#​

要在n8n中使用源码控制，您需要具备以下访问方式的Git仓库：

  • SSH访问（使用部署密钥），或
  • HTTPS访问（使用个人访问令牌）

本文档假设您熟悉Git及所用Git服务平台。

步骤1：设置仓库与分支#​

全新设置时：

  1. 创建专用于n8n的新仓库
  2. 创建所需分支。例如：若需为测试和生产配置不同环境，请为每个环境设立独立分支

分支规划建议请参阅分支模式。

步骤2：在n8n中配置Git#​

  1. 进入设置 > 环境
  2. 选择连接方式：
    • SSH：在Git仓库URL中输入仓库SSH地址（例如[email protected]:username/repo.git）
    • HTTPS：在Git仓库URL中输入仓库HTTPS地址（例如https://github.com/username/repo.git）
  3. 根据连接方式配置认证：
    • SSH：n8n支持ED25519和RSA公钥算法，默认使用ED25519。若Git主机要求RSA，请在SSH密钥下选择RSA并复制SSH密钥
    • HTTPS：输入凭据：
      • 用户名：Git服务平台用户名
      • 令牌：Git服务平台提供的个人访问令牌(PAT)

步骤3：设置认证#​

根据所选连接方式配置认证。

SSH认证（使用部署密钥）#​

通过n8n提供的SSH密钥为仓库创建部署密钥（需写入权限）。

具体步骤因Git服务平台而异，常见平台指南：

HTTPS认证（使用个人访问令牌）#​

创建具备仓库访问权限的个人访问令牌(PAT)。

常见平台令牌创建指南：

令牌所需权限：

  • 仓库读写权限
  • 内容读写权限（GitHub）
  • 源代码拉取/推送权限（GitLab）

步骤4：连接n8n并配置实例#​

  1. 在n8n的设置 > 环境中选择连接，n8n将连接至Git仓库
  2. 在实例设置中为当前n8n实例选择使用分支
  3. 可选：勾选受保护实例禁止用户在此实例中编辑工作流（适用于保护生产环境）
  4. 可选：为实例选择标识颜色（将显示在源码控制推送/拉取按钮旁），便于用户识别当前所处实例
  5. 选择保存设置