n8n Git 节点 Clone 任意文件写入:repositoryPath 未校验导致覆盖敏感目录并 RCE(CVE-2026-21877)
web/nodejs · verified
一句话结论
n8n 的 Git 节点 Clone 操作直接信任用户传入的 Repository Path,只做 access/mkdir 后把它作为 simple-git 的 baseDir 执行 git clone sourceRepository .;拥有工作流编辑权限的攻击者可以把包含 WebShell、authorized_keys 或配置文件的恶意仓库克隆到 Web 静态目录、.ssh 等敏感位置,实现任意文件写入并进一步 RCE(CVSS 9.8)。
原理
- 入口:n8n 的 Git 节点提供
Clone操作,参数包括repositoryPath(新仓库路径)与sourceRepository(源仓库地址)。工作流作者可自由填写两者。 - 缺失路径校验:受影响版本的
Git.node.ts逻辑为: repositoryPath = this.getNodeParameter('repositoryPath', itemIndex, '');- 若目录不存在则
mkdir(repositoryPath),存在则access通过; gitOptions = { baseDir: repositoryPath, config: gitConfig },用 simple-git 初始化;sourceRepository = await prepareRepository(sourceRepository),然后git.clone(sourceRepository, '.')。 代码只关心“目录是否存在”,不检查路径是否在允许的工作区、是否是 n8n 自身目录、是否指向 Web 根/.ssh/配置目录,也不做realpath/白名单。- 本地源仓库:
sourceRepository支持本地路径(如/tmp/git_source)。攻击者可以在 n8n 进程可读的临时目录/挂载目录准备一个裸仓库,再让 Git 节点从该路径克隆,避免依赖外部网络。 - 写入位置即危害:
git clone会把仓库工作树文件写到repositoryPath下。若目标为 n8n 的 Web 静态资源目录(如/home/node/.cache/n8n/public/assets/<dir>),文件可通过/assets/<dir>/...访问;若目标为.ssh且写入authorized_keys,可获得 SSH 免密登录;若目标为其他服务的配置目录,可覆盖配置或写入计划任务/启动脚本。目标目录必须是空目录或不存在(Git clone 要求),否则 clone 失败。 - 权限边界:文件以 n8n 进程用户(容器内通常为
node)权限写入;能创建工作流的认证用户因此获得该用户可写路径的任意文件写入,进一步可执行命令/登录主机。 - 与配置注入的区别:CVE-2025-65964 通过
addConfig修改core.hooksPath诱导 Git 执行脚本;CVE-2026-21877 是clone直接把文件写到任意目录,属于文件系统写入,不依赖 Git hook 执行。 - 修复逻辑:补丁在 clone 前调用
this.helpers.resolvePath(repositoryPath)得到绝对路径,再用isFilePathBlocked(resolvedRepositoryPath)检查:受限路径(n8n 配置目录、staticCacheDir、二进制数据目录等,默认开启N8N_BLOCK_FILE_ACCESS_TO_N8N_FILES)、文件模式黑名单(N8N_BLOCK_FILE_PATTERNS)、可选白名单(N8N_ALLOW_FILE_ACCESS_TO_FILES);命中则抛Access to the repository path is not allowed。
触发条件
- n8n 版本在
0.123.0 ≤ n8n < 1.121.3。 - 攻击者拥有可创建/编辑并执行工作流的账号(不要求管理员)。
- Git 节点未被
NODES_EXCLUDE禁用。 - n8n 进程对目标路径有写权限,且目标目录不存在或为空(Git clone 要求)。
sourceRepository可指向攻击者准备的本地仓库,或可访问的远程仓库。- 目标路径能带来实际危害:Web 静态目录可访问、
.ssh可写、服务配置/启动目录可写等。
利用步骤
- 准备恶意仓库:在攻击者可控目录创建仓库并提交恶意文件(如
pwn.txt、WebShell、authorized_keys):bash mkdir -p tmp_git_repo && cd tmp_git_repo git init echo "hacked" > pwn.txt git add pwn.txt git -c user.email=attacker@example.com -c user.name=Attacker commit -m "Initial commit" cd .. && git clone --bare tmp_git_repo git_source chmod -R 777 git_source - 让 n8n 能读到源仓库:把
git_source放到 n8n 容器可读路径(如挂载到/tmp/git_source),或使用攻击者控制的远程 Git URL。 - 创建工作流:登录 n8n,新建工作流,添加 Git 节点,
Operation=Clone,New Repository Path填目标敏感路径(示例/home/node/.cache/n8n/public/assets/vulnn_proof,该目录下的文件可通过 Web 访问),Source Repository填/tmp/git_source。 - 执行节点/工作流:点击 Execute step 或通过
/rest/workflows/{id}/run触发;成功时节点返回success: true,目标目录出现仓库文件。 - 验证写入:访问
http://<n8n>/assets/vulnn_proof/pwn.txt看到hacked,证明任意文件写入。 - 升级危害:把目标换成 Web 根目录可执行脚本位置、用户
.ssh(写authorized_keys)、其他服务配置目录或计划任务目录;根据目标权限与目录是否为空选择路径。 - API 自动化:注册/登录获取会话,创建含 Git Clone 节点的工作流,调用
/rest/workflows/{id}/run执行,再通过 Web 访问验证写入文件(原文 PoC 即此流程)。
PoC
恶意仓库最小准备(防御研究用,未在本机执行):
mkdir -p tmp_git_repo && cd tmp_git_repo
git init
echo "hacked" > pwn.txt
git add pwn.txt
git -c user.email=attacker@example.com -c user.name=Attacker commit -m "Initial commit"
cd .. && git clone --bare tmp_git_repo git_source
n8n 节点参数:
Operation: Clone
New Repository Path: /home/node/.cache/n8n/public/assets/vulnn_proof
Source Repository: /tmp/git_source
验证:
GET http://<n8n-host>:5678/assets/vulnn_proof/pwn.txt
响应:hacked
变体与关联
- 变体:目标改为
.ssh/authorized_keys所在目录、Web 根目录、反向代理配置、systemd/计划任务目录;源仓库改为远程 URL 或带子模块的仓库;用git clone的--depth/分支选项影响写入内容。 - 变体:与 n8n 其他节点组合(Read/Write File、Git 配置注入)扩大写入范围或触发执行。
- 关联:[[web-nodejs-n8n-git-node-gitconfig-sshcommand-rce]](CVE-2026-27498,Git 配置注入)、[[web-nodejs-n8n-expression-sandbox-escape-rce]](CVE-2025-68613)、[[web-nodejs-n8n-with-scope-constructor-ast-bypass-cve-2026-1470]](CVE-2026-1470);n8n 的裸仓库/配置注入前作可参考同系列卡片。
检测与防御
- 升级:升级到 n8n 1.121.3 或更高;确认 Git 节点 clone 前调用
resolvePath与isFilePathBlocked。 - 权限:限制工作流创建/编辑权限,只授予可信用户;不需要 Git 节点时通过
NODES_EXCLUDE禁用。 - 配置:保持
N8N_BLOCK_FILE_ACCESS_TO_N8N_FILES默认开启;配置N8N_BLOCK_FILE_PATTERNS与N8N_ALLOW_FILE_ACCESS_TO_FILES白名单,限制可写目录。 - 运行隔离:n8n 运行在低权限容器,不挂载宿主机
/root、/etc、/var/run/docker.sock等敏感目录;只挂载必要工作目录,限制 Web 静态目录写权限。 - 日志检测:审计 Git 节点 clone 的
repositoryPath是否位于工作区外、是否指向.ssh/Web 根/配置目录;监控/rest/workflows创建与/run高频调用;监控 n8n 进程对敏感目录的文件写入与git clone子进程。 - 完整性:对 Web 根、
.ssh、服务配置目录做文件完整性监控;发现异常文件立即隔离并排查工作流。 - 响应:删除恶意工作流与写入文件,检查
.ssh/authorized_keys、WebShell、计划任务与配置是否被篡改;轮换可能泄露的凭据;升级并收紧权限。