n8n Git 节点裸仓库 Hook 执行:克隆数据被识别为可执行 Hook 导致认证用户 RCE(CVE-2025-62726)
web/nodejs · verified
一句话结论
n8n 1.113.0 之前的 Git 节点允许把用户指定的 repositoryPath 当作任意仓库使用且不拒绝裸仓库(bare repository);拥有工作流编辑权限的攻击者可让该路径下的 hooks/pre-push 等文件被 Git 当作可执行 Hook,在执行 git push 时以 n8n 进程用户身份运行任意命令。
原理
- Git 的安全边界建立在“数据”与“可执行逻辑”的区分上:
git clone只把对方仓库的工作树文件下载为数据,不会把.git/hooks下的钩子安装到本地并执行,因此克隆不受信仓库通常不等于执行对方代码。 - 裸仓库打破了这个边界:裸仓库没有工作树,仓库根目录本身就是 Git 目录,
hooks/直接位于根目录下。Git 在该目录执行操作时会按正常机制查找并运行hooks/pre-push等钩子。 - n8n Git 节点的
repositoryPath完全取自节点参数,并直接作为 simple-git 的baseDir;代码只设置了GIT_TERMINAL_PROMPT=0,没有校验该路径是否是裸仓库,也没有阻止其读取仓库本地配置。 - 因此攻击者可以先让恶意仓库中的
hooks/pre-push(可执行位可由 Git 跟踪)和config(内容含bare = true)作为普通文件被克隆到 n8n 可写目录;当 Git 节点以该目录为repositoryPath执行 push 等操作时,Git 将其识别为裸仓库并运行根目录下的 Hook,Hook 的内容从此前“克隆下来的数据”变为“被执行的命令”。 - 该链的危害边界是工作流编辑权限:Git 节点以 n8n 进程的操作系统用户身份调起系统 git,Hook 命令继承该用户权限;若该用户是容器内 node 用户或宿主服务账号,攻击者即从“能编工作流”升级为“能在 n8n 主机执行命令”。
触发条件
- n8n 版本低于 1.113.0,Git 节点可用(未被
NODES_EXCLUDE禁用)。 - 攻击者持有有效账号并能创建、修改并执行工作流(不要求管理员)。
- 工作流能控制 Git 节点的
repositoryPath与仓库地址,或能通过其他节点(如 Read/Write File、Execute Command)在 n8n 进程可写目录构造出裸仓库布局。 - 目标目录对 n8n 进程用户可写;Hook 文件可执行(经 Git 克隆保留可执行位,或由命令节点 chmod)。
- 随后触发的 Git 操作会运行 Hook(如 push;原文用 push 触发
pre-push)。
利用步骤
- 攻击者准备恶意仓库:仓库工作树中包含裸仓库布局所需文件,核心是根目录下可执行的
hooks/pre-push,脚本内容为要执行的命令;并提交至少两次,避免 push 时因 “Everything up-to-date” 不进入 Hook 执行路径。 - 工作流第一步用 Git 节点 Clone,把恶意仓库克隆到 n8n 进程可写的临时目录(如
/tmp/clone)。此时hooks/pre-push只是普通文件。 - 把克隆内容布置为裸仓库形态:原文用 Execute Command 节点将
/tmp/clone复制到/tmp/bare,并修改/tmp/bare/config写入bare = true。 - 同一工作流用 Git 节点对
/tmp/bare执行 Push;Git 按裸仓库语义读取根目录hooks/pre-push并执行。 - Hook 以 n8n 进程用户身份运行(原文脚本
touch /tmp/output_check/pwned_62726),通过写入文件或回连验证;攻击者也可替换为反弹 shell、读取环境变量/密钥等命令。 - 变体:若环境禁用 Execute Command 但允许 Git 节点,可把
config、HEAD、objects/、refs/、hooks/pre-push作为被跟踪文件直接放在恶意仓库里,Clone 后该工作树即具备裸仓库识别所需的文件结构,再以同一路径执行 push,减少对命令节点的依赖(此变体未在原文实测,confidence: low)。
PoC
原文提供了一键脚本与手动流程,核心节点参数如下(未在本机执行):
# 恶意仓库 hooks/pre-push(需可执行)
#!/bin/sh
touch /tmp/output_check/pwned_62726
# n8n 工作流(原文 PoC 路径)
1) Git 节点:Clone 源仓库 -> /tmp/clone
2) Execute Command 节点:cp -r /tmp/clone /tmp/bare
并修改 /tmp/bare/config 设置 bare = true
3) Git 节点:Push repositoryPath = /tmp/bare
验证:宿主机挂载目录出现 output_check/pwned_62726,说明 Hook 已以 n8n 进程权限执行。
变体与关联
- 变体:Hook 类型可换为
pre-commit、post-checkout、post-merge等,配合 Git 节点的 commit/checkout/pull 操作触发;命令可改为反弹 shell 或读取N8N_ENCRYPTION_KEY等敏感环境变量。 - 变体:与 Write File 节点组合直接写入裸仓库布局,不依赖 Execute Command;能否写入可执行 Hook 取决于文件节点是否保留权限位与目标目录权限。
- 关联:[[web-nodejs-n8n-git-node-gitconfig-sshcommand-rce]](CVE-2026-27498,写
.git/config注入core.sshCommand)、[[web-nodejs-n8n-git-clone-arbitrary-file-write-rce]](CVE-2026-21877,Clone 任意文件写入)、[[web-nodejs-n8n-authenticated-execute-command-workflow-rce]](工作流编辑权限直接执行命令)。三条链的共同边界都是:工作流编辑者不应等于宿主机命令执行者。 - 边界:1.113.0 起 Git 节点在启用防护时调用
checkIsRepo('bare')并拒绝裸仓库;N8N_GIT_NODE_DISABLE_BARE_REPOS=true可强制开启防护。若 Execute Command 与 Git 节点均被禁用、或 n8n 以严格低权限容器运行且无可写目录,链不成立。
检测与防御
- 升级 n8n 至 1.113.0 或更高版本;无法升级时设置
N8N_GIT_NODE_DISABLE_BARE_REPOS=true,并限制Execute Command、Read/Write File 等高危节点的使用权限。 - 将工作流创建/编辑权限收紧到可信用户;n8n 服务以低权限容器运行,限制可写目录、出站网络与凭据挂载。
- 检测:审计 Git 节点出现异常
repositoryPath(尤其指向/tmp且仓库根目录含config、hooks/、HEAD、objects/);工作流中 Clone 后紧接 push 到同一临时目录;n8n 进程派生的git子进程随后执行 shell 或touch/curl/bash等命令。 - 排查:检查 n8n 数据目录与临时目录下可疑的裸仓库布局、
hooks/pre-push内容与可执行位;关注工作流变更记录中对 Git 节点路径与仓库地址的修改。