CVE-2025-62726:n8n Git 节点裸仓库 RCE 漏洞分析
准备梳理n8n 的漏洞时间轴,该漏洞作为n8n的第一个漏洞,是分析系列的第一篇文章
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 节点对远端仓库的“数据边界”判断错误:
- 正常情况 :当你使用 git clone 下载一个仓库时,Git 有严格的安全机制。你下载的是代码( 数据 ),而仓库里的配置脚本(如 .git/hooks 下的钩子)是不会被下载到你本地生效的。这就是“数据”与“执行逻辑”的边界——你可以下载别人的代码,但不能下载别人的“可执行命令”并在自己电脑上跑。
- 漏洞情况(边界模糊) :n8n 的 Git 节点允许用户操作 Bare Repository(裸仓库) 。在裸仓库模式下,仓库的“根目录”直接等同于普通仓库的 .git 目录。
- 这就导致了一个严重的逻辑漏洞:攻击者可以把恶意的 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: node3.3 恶意仓库生成逻辑 (setup_repo.sh)
该脚本的核心是创建一个带有 hooks/pre-push 的 Git 仓库。
关键点解析:
- 写入 Hook: 脚本会在
hooks/pre-push中写入一段 Shell 脚本,执行时会在/tmp/output_check/下创建pwned_62726文件。 - 双次提交: 脚本会执行两次 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_627264.1 攻击链路详解
- Clone: 工作流首先把
malicious_repo_src克隆到容器内的/tmp/clone。此时,恶意的pre-push脚本只是作为一个普通文件躺在/tmp/clone/hooks/目录下。 - 构造 Bare Repo: 工作流通过
Execute Command节点,把/tmp/clone的内容复制到/tmp/bare。 - 欺骗 Git: 工作流修改
/tmp/bare/config,设置bare = true。 - 触发 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 目录直接位于根目录下。
攻击链路如下:
- Bypass Clone Restriction: 正常 Clone 无法带 Hook 执行,但可以带 Hook 文件。
- Layout Transformation: 将“文件”移动到 Git 认为的 Hook 路径位置(
/hooks)。 - Mode Switch: 修改配置
bare = true,激活 Hook 执行路径。 - Execution: 触发 Git 操作(Push),执行 Hook。
6. 补丁分析
官方在 1.113.0 版本中修复了此漏洞(Commit 5bf3db5b)。
主要修复措施包括:
- 引入环境变量
N8N_GIT_NODE_DISABLE_BARE_REPOS,允许禁用对裸仓库的操作支持。 - 在 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. 修复建议
- 升级版本: 尽快升级 n8n 至 1.113.0 或更高版本。
- 配置防护: 如果无法立即升级,确保 n8n 运行环境无法访问不可信的 Git 仓库,并限制
Execute Command节点的使用权限。 - 环境变量: 在新版本中,保持默认配置(即禁用 Bare Repos),不要手动设置
N8N_GIT_NODE_DISABLE_BARE_REPOS=false。
8. 参考链接
n8n Git节点因未校验裸仓库,使恶意Hook脚本被误执行,导致RCE。
由 AI 根据全文自动生成,仅供参考,以原文为准