CVE-2025-62726:n8n Git 节点裸仓库 RCE 漏洞分析

0. 前言

准备梳理n8n 的漏洞时间轴,该漏洞作为n8n的第一个漏洞,是分析系列的第一篇文章

1. 漏洞简介

n8n 是一款广泛使用的基于节点的工作流自动化工具。在 1.113.0 版本之前,其 Git 节点组件存在一处远程代码执行(RCE)漏洞(CVE-2025-62726)。攻击者可以通过构造恶意的裸仓库(Bare Repository)并诱导 n8n 工作流进行克隆和推送操作,从而触发仓库中潜藏的 Git Hook 脚本,实现沙箱逃逸与任意代码执行。

漏洞本质是 Git 节点对远端仓库的“数据边界”判断错误:

  1. 正常情况 :当你使用 git clone 下载一个仓库时,Git 有严格的安全机制。你下载的是代码( 数据 ),而仓库里的配置脚本(如 .git/hooks 下的钩子)是不会被下载到你本地生效的。这就是“数据”与“执行逻辑”的边界——你可以下载别人的代码,但不能下载别人的“可执行命令”并在自己电脑上跑。
  2. 漏洞情况(边界模糊) :n8n 的 Git 节点允许用户操作 Bare Repository(裸仓库) 。在裸仓库模式下,仓库的“根目录”直接等同于普通仓库的 .git 目录。
  3. 这就导致了一个严重的逻辑漏洞:攻击者可以把恶意的 Hook 脚本伪装成普通文件(数据)提交到仓库里。当 n8n 把这些文件下载下来,并被诱导将其识别为“裸仓库”时,这些原本只是“数据”的文件,瞬间变成了 Git 认可的“可执行 Hook 脚本”,最终实现了RCE。

2. 漏洞概述

  • 漏洞编号: CVE-2025-62726
  • 影响产品: n8n
  • 影响版本: < 1.113.0
  • 漏洞类型: Remote Code Execution (RCE)
  • 利用条件: 攻击者需要有权限创建或修改工作流,并能控制 Git 节点所访问的仓库地址。

3. 环境搭建

本复现环境基于 Docker 和 Docker Compose 构建,所有相关文件均位于 reproduce_env 目录下。

3.1 目录结构说明

拿到 reproduce_env 目录后,你会看到以下核心文件:

  • verify_poc.sh: 一键复现脚本。推荐直接运行此脚本,它会自动完成清理、环境启动、恶意仓库生成、工作流导入、执行与验证全流程。
  • setup_repo.sh: 恶意仓库生成脚本。它会创建一个包含恶意 Hook (pre-push) 的 Git 仓库,并生成两次提交(为了满足后续 Git Push 的触发条件)。
  • workflow.json: 攻击工作流模版。包含触发漏洞的核心逻辑(Clone -> 构造 Bare Repo -> Push)。
  • docker-compose.yml: 靶场环境配置。定义了 vulnerable 的 n8n 服务 (1.112.0)。

3.2 靶场配置 (docker-compose.yml)

我们需要映射必要的目录,以便 n8n 容器能访问到我们生成的恶意仓库,并将攻击结果输出到宿主机进行验证。

version: '3.8'
services:
  n8n:
    image: n8nio/n8n:1.112.0
    container_name: n8n-cve-2025-62726
    ports:
      - "5678:5678"
    environment:
      - N8N_ENCRYPTION_KEY=test-key
      - N8N_SECURE_COOKIE=false
      # Ensure Git is available (it is in the image)
    volumes:
      - ./n8n_data:/home/node/.n8n
      - ./output_check:/tmp/output_check
    user: node

3.3 恶意仓库生成逻辑 (setup_repo.sh)

该脚本的核心是创建一个带有 hooks/pre-push 的 Git 仓库。

关键点解析:

  1. 写入 Hook: 脚本会在 hooks/pre-push 中写入一段 Shell 脚本,执行时会在 /tmp/output_check/ 下创建 pwned_62726 文件。
  2. 双次提交: 脚本会执行两次 commit。这是因为 Git Push 默认只推送有变动的部分。如果我们只提交一次,Push 时可能会提示 "Everything up-to-date" 而不触发 Hook。通过两次提交,我们可以让工作流尝试推送上一次的 Commit(回滚),从而触发 Git 的检查机制并执行 Hook。

4. 漏洞复现

我们提供两种复现方式:全自动脚本(推荐)和手动分步操作(适合理解原理)。

方式一:全自动一键复现(推荐)

直接运行 verify_poc.sh 脚本,它会自动完成所有步骤并输出结果。

cd reproduce_env
chmod +x verify_poc.sh setup_repo.sh
./verify_poc.sh

预期输出:
当看到如下输出时,说明复现成功:

[+] Verifying result...
SUCCESS: CVE-2025-62726 Reproduced!
-rw-r--r-- 1 test test 0 Jan 26 08:09 output_check/pwned_62726

方式二:手动分步复现

如果你想深入了解每一步发生了什么,可以按照以下步骤操作。

第一步:初始化恶意仓库

在宿主机运行生成脚本,创建带有恶意 Hook 的 Git 仓库。

cd reproduce_env
chmod +x setup_repo.sh
./setup_repo.sh

执行后,目录下会生成 malicious_repo_src 文件夹(恶意仓库)和 commit_hash.txt(最新提交的 Hash)。

第二步:准备工作流 Payload

由于工作流需要回滚到上一次提交来触发 Push,我们需要把 commit_hash.txt 里的 Hash 填入工作流。

# 读取 Hash
HASH=$(cat commit_hash.txt)
# 替换 workflow.json 中的占位符,生成最终的 workflow_run.json
sed "s/HASH_PLACEHOLDER/$HASH/g" workflow.json > workflow_run.json

第三步:启动 n8n 靶场

启动 Docker 容器。

# 确保目录存在且有权限
mkdir -p n8n_data output_check
chmod 777 n8n_data output_check

# 启动容器
docker-compose up -d

第四步:导入工作流

我们需要把准备好的 workflow_run.json 导入到 n8n 中。

docker exec -i n8n-cve-2025-62726 n8n import:workflow < workflow_run.json

注:如果导入报错,请检查 workflow_run.json 是否包含数组结构 []。

第五步:执行工作流

你可以登录 Web 界面 (http://localhost:5678) 点击执行,也可以使用 CLI 执行。

提示:首次访问 Web 界面时会进入 Setup Wizard(初始化向导)。你需要创建一个管理员账户(邮箱/密码可任意填写)才能进入主界面。如果遇到 "Secure Cookie" 相关报错,请确保 docker-compose.yml 中已配置 N8N_SECURE_COOKIE=false。

这里使用 CLI 执行:

# 获取刚才导入的工作流 ID
WORKFLOW_ID=$(docker exec n8n-cve-2025-62726 n8n export:workflow --all | grep -o '"id":"[^"]*"' | head -n 1 | cut -d'"' -f4)

# 执行工作流
docker exec n8n-cve-2025-62726 n8n execute --id "$WORKFLOW_ID"

第六步:验证结果

检查宿主机的 output_check 目录,看是否存在标志文件。

ls -l output_check/pwned_62726

4.1 攻击链路详解

  1. Clone: 工作流首先把 malicious_repo_src 克隆到容器内的 /tmp/clone。此时,恶意的 pre-push 脚本只是作为一个普通文件躺在 /tmp/clone/hooks/ 目录下。
  2. 构造 Bare Repo: 工作流通过 Execute Command 节点,把 /tmp/clone 的内容复制到 /tmp/bare。
  3. 欺骗 Git: 工作流修改 /tmp/bare/config,设置 bare = true。
  4. 触发 RCE: 工作流对 /tmp/bare 执行 Git Push。
  • Git 读取配置,发现是 Bare 仓库。
  • Git 自动寻找根目录下的 hooks/pre-push。
  • 发现 Hook 存在且可执行,于是运行它。
  • Hook 脚本执行 touch /tmp/output_check/pwned_62726,完成攻击。

5. 漏洞分析

5.1 代码层面分析

n8n 的 Git 节点底层调用了 simple-git 库或直接执行 git 命令。在未修复版本中,Git 节点并未限制用户指定 repositoryPath 为一个裸仓库,也未对仓库中的配置文件(如 config)进行严格校验。

以下是 n8n v1.112.0 容器环境中的真实代码片段(位于 /usr/local/lib/node_modules/n8n/node_modules/n8n-nodes-base/dist/nodes/Git/Git.node.js):

// 1. 获取用户输入的 repositoryPath
const repositoryPath = this.getNodeParameter('repositoryPath', itemIndex, '');

// ... (省略部分逻辑)

// 2. 初始化 simple-git,直接使用用户提供的路径作为 baseDir
const gitOptions = {
    baseDir: repositoryPath,
};
const git = (0, simple_git_1.default)(gitOptions)
    .env('GIT_TERMINAL_PROMPT', '0');

// ... (省略部分逻辑)

// 3. 执行 push 操作,未检查 baseDir 是否为裸仓库
else if (operation === 'push') {
    if (options.repository) {
        const targetRepository = await prepareRepository(options.targetRepository);
        await git.push(targetRepository);
    }
    // ...
}

可以看到,代码直接将用户可控的 repositoryPath 用于初始化 Git 实例,并在后续的 push 操作中直接调用 git.push()。由于缺乏对裸仓库(Bare Repo)的检查,当 repositoryPath 指向一个包含恶意 Hook 的裸仓库时,Git 就会在执行 Push 前触发 Hook。如果攻击者能够通过文件操作节点(Read/Write File)或命令执行节点(Execute Command)修改仓库的 config 文件,将 bare 字段置为 true,Git 就会转变行为模式。

5.2 触发逻辑

在标准 Git 仓库中,Hooks 位于 .git/hooks 目录,且通常不会随代码 clone 下来(客户端安全机制)。但在裸仓库中,仓库的根目录即为 Git 目录,hooks 目录直接位于根目录下。

攻击链路如下:

  1. Bypass Clone Restriction: 正常 Clone 无法带 Hook 执行,但可以带 Hook 文件。
  2. Layout Transformation: 将“文件”移动到 Git 认为的 Hook 路径位置(/hooks)。
  3. Mode Switch: 修改配置 bare = true,激活 Hook 执行路径。
  4. Execution: 触发 Git 操作(Push),执行 Hook。

6. 补丁分析

官方在 1.113.0 版本中修复了此漏洞(Commit 5bf3db5b)。

主要修复措施包括:

  1. 引入环境变量 N8N_GIT_NODE_DISABLE_BARE_REPOS,允许禁用对裸仓库的操作支持。
  2. 在 Git 节点操作执行前,检查目标仓库是否为裸仓库,如果是则抛出异常。
  • 如果启用了防护,调用 simple-git 的 checkIsRepo('bare') 方法检测当前仓库是否为裸仓库。
  • 如果是裸仓库,则抛出 NodeOperationError 阻断操作。

以下是修复后的逻辑代码(基于官方补丁):

// packages/nodes-base/nodes/Git/Git.node.ts

// ... 初始化 git 实例后 ...

// 检查是否禁用裸仓库支持
// 在云端版本默认禁用,自托管版本可通过环境变量 N8N_GIT_NODE_DISABLE_BARE_REPOS=true 开启防护
const disableBareRepos = config.getEnv('gitNode.disableBareRepos') || 
                         process.env.N8N_GIT_NODE_DISABLE_BARE_REPOS === 'true';

if (disableBareRepos) {
    // 使用 simple-git 的 checkIsRepo 方法检测是否为 'bare' 仓库
    const isBare = await git.checkIsRepo('bare');
    if (isBare) {
        throw new NodeOperationError(this.getNode(), 'Bare repositories are not supported for security reasons', {
            description: 'Please use a non-bare repository.',
        });
    }
}

7. 修复建议

  1. 升级版本: 尽快升级 n8n 至 1.113.0 或更高版本。
  2. 配置防护: 如果无法立即升级,确保 n8n 运行环境无法访问不可信的 Git 仓库,并限制 Execute Command 节点的使用权限。
  3. 环境变量: 在新版本中,保持默认配置(即禁用 Bare Repos),不要手动设置 N8N_GIT_NODE_DISABLE_BARE_REPOS=false。

8. 参考链接

  1. GitHub Advisory: GHSA-xgp7-7qjq-vg47
  2. n8n Commit 5bf3db5b