1. 漏洞简介

n8n 的 Git 节点提供了一个 Add Config 操作,允许用户向 Git 仓库写入配置项。在 CVE-2025-65964 修复之前,该功能未对配置键名(Key)进行限制。攻击者可以利用这一缺陷,将 Git 的 core.hooksPath 配置项指向仓库内的一个受控目录(包含恶意 Hook 脚本)。当工作流后续执行 Git 操作(如 Commit)时,Git 会加载该目录下的 Hook 脚本,从而实现远程代码执行(RCE)。

1.1 核心成因

漏洞的核心在于 n8n 的 Git 节点允许用户通过 addConfig 操作设置任意 Git 配置项,且没有建立黑名单机制。

在 Git 中,core.hooksPath 是一个非常敏感的配置项。它允许用户指定一个自定义的目录作为 Hooks 目录,以替代默认的 .git/hooks。这个功能本意是方便统一管理 Hooks,但在 n8n 的场景下,它打破了“Clone 下来的代码不能直接执行”的安全假设。

1.2 与 CVE-2025-62726 的差异及绕过

CVE-2025-65964 可以被视为对 CVE-2025-62726 修复方案的绕过,两者在利用手法上有本质区别:

  1. 依赖机制不同:
  • CVE-2025-62726 利用的是 Git 裸仓库 (Bare Repository) 的特性。攻击者通过克隆裸仓库,使得仓库目录直接包含 Hooks 文件(如 hooks/pre-push),并在推送时触发。
  • CVE-2025-65964 不依赖裸仓库,适用于标准的 非裸仓库 (Non-Bare Repository)。它利用 n8n 允许配置任意 Git 参数的缺陷,通过修改 core.hooksPath 改变 Git 寻找 Hooks 的默认路径。
  1. 绕过逻辑:
  • 针对 CVE-2025-62726,官方的修复方案是引入 N8N_GIT_NODE_DISABLE_BARE_REPOS 环境变量,禁止 Git 节点操作裸仓库。
  • 然而,CVE-2025-65964 操作的是完全合法的非裸仓库,因此能够完美避开针对裸仓库的检测防御。攻击者只需将 Hooks 脚本放在仓库的任意子目录(如 evil_hooks/),然后通过 Add Config 将 core.hooksPath 指向该目录,即可在后续 Git 操作中触发恶意代码。

简单来说,攻击者“告诉” Git:“不要去默认的 .git/hooks 找钩子了,去我指定的目录找吧”,而那个目录里正躺着攻击者准备好的恶意脚本。

2. 漏洞概述

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

3. 环境搭建

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

3.1 目录结构说明

核心文件说明:
其中:

  • verify_poc.sh与CVE-2025-62726中的核心逻辑没啥变化
  • 重点是setup_repo.sh 和workflow.json与CVE-2025-62726中不同
  • verify_poc.sh: 一键复现脚本。自动完成环境清理、启动、恶意仓库生成、工作流导入及验证。
  • setup_repo.sh: 恶意仓库生成脚本。创建一个包含 evil_hooks/pre-commit 脚本的 Git 仓库。
  • workflow.json: 攻击工作流模版。包含完整的攻击链路(Clone -> Config -> Commit)。
  • docker-compose.yml: 靶场环境配置。使用受影响的 n8nio/n8n:1.114.0 版本。

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

使用 1.114.0 版本的 n8n 镜像,并挂载必要的目录以供验证。

version: '3'
services:
  n8n:
    image: n8nio/n8n:1.114.0
    container_name: n8n-cve-2025-65964
    ports:
      - "5678:5678"
    volumes:
      - ./malicious_repo_src:/malicious-repo
      - ./workflow.json:/tmp/workflow.json
      - ./n8n_data:/home/node/.n8n
      - ./output_check:/tmp
    environment:
      - N8N_ENCRYPTION_KEY=test-key
    command: start

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

与 CVE-2025-62726 不同,这里的恶意 Hook 并不放在标准的 .git/hooks 下(因为 clone 不会下载它),而是放在仓库的一个普通子目录 evil_hooks 中。

# 创建恶意 Hooks 目录
mkdir -p evil_hooks
cat <<EOF > evil_hooks/pre-commit
#!/bin/sh
echo "Vulnerability Exploited!"
touch /tmp/pwned_success
EOF
chmod +x evil_hooks/pre-commit

这样,evil_hooks/pre-commit 只是仓库里的一个普通文件,可以被正常 Clone 下来。

4. 漏洞复现

运行 verify_poc.sh 脚本,即可看到复现结果。

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

预期输出:

[+] Verifying results...
SUCCESS: Vulnerability Reproduced!
File 'pwned_success' was created in output_check/

4.1 攻击链路详解 (workflow.json)

工作流包含以下关键节点:

  1. Git Clone: 将恶意仓库(包含 evil_hooks 目录)克隆到 /tmp/target-repo。
  2. Write File: 在仓库中写入一个文件 trigger.txt,以便后续可以执行 Commit。
  3. Git Config User/Email: 设置提交所需的用户名和邮箱。
  4. Git Config Hooks (关键):
  • Node: Git 节点
  • Operation: addConfig
  • Key: core.hooksPath
  • Value: /tmp/target-repo/evil_hooks
  • 原理: 将当前仓库的 Hooks 路径指向刚才 Clone 下来的恶意目录。
  1. Git Commit:
  • Operation: commit
  • 原理: 执行提交操作。由于 core.hooksPath 已被修改,Git 会去 evil_hooks 目录下寻找并执行 pre-commit 脚本,从而触发 RCE。

5. 漏洞分析

5.1 代码层面分析

以下是 n8n v1.114.0 容器环境中的真实代码片段(位于 /usr/local/lib/node_modules/n8n/node_modules/n8n-nodes-base/dist/nodes/Git/Git.node.js),展示了 addConfig 操作的实现逻辑:

                else if (operation === 'addConfig') {
                    // ----------------------------------
                    //         addConfig
                    // ----------------------------------
                    // 1. 直接获取用户输入的 key 和 value,未进行任何过滤
                    const key = this.getNodeParameter('key', itemIndex, '');
                    const value = this.getNodeParameter('value', itemIndex, '');
                    let append = false;
                    if (options.mode === 'append') {
                        append = true;
                    }
                    // 2. 调用 simple-git 的 addConfig 方法,将配置写入仓库
                    await git.addConfig(key, value, append);
                    returnItems.push({
                        json: {
                            success: true,
                        },
                        pairedItem: {
                            item: itemIndex,
                        },
                    });
                }

可以看到,代码直接将用户可控的 key 和 value 传递给了 git.addConfig() 方法。由于缺乏对敏感配置项(如 core.hooksPath)的黑名单检查,攻击者可以随意修改 Git 配置。

5.2 触发流程

  1. 准备阶段: 攻击者构造一个仓库,将 Hook 脚本放入仓库文件系统(如 evil_hooks/pre-commit)。
  2. Clone 阶段: n8n 将仓库下载到本地,恶意脚本以普通文件形式存在。
  3. 配置阶段: 攻击者利用 Git 节点的 addConfig 功能,执行 git config core.hooksPath <恶意目录>。
  4. 执行阶段: 攻击者利用 Git 节点的 commit 功能触发 Git 钩子流程。Git 读取配置,加载并执行恶意脚本。

6. 补丁分析

官方在 n8n 1.113.0 及后续版本中修复了此漏洞(Commit d5a1171)。

与单纯的黑名单过滤不同,官方采用了更彻底的策略:默认禁用所有 Git 节点的 Hooks 执行权限。

6.1 修复逻辑

修复方案的核心是引入了一个新的安全配置项 N8N_GIT_NODE_ENABLE_HOOKS,其默认值为 false。当该选项关闭时,n8n 会在每次执行 Git 命令时,通过命令行参数强制覆盖 core.hooksPath 为 /dev/null。

由于 Git 的命令行参数(-c)优先级高于仓库下的配置文件(.git/config),因此即使攻击者通过 addConfig 修改了仓库的 core.hooksPath,Git 进程在运行时依然会忽略该配置,从而彻底阻断 RCE 通道。

6.2 代码实现

以下是修复后的关键代码片段(基于 Commit d5a1171):

// packages/cli/src/SecurityConfig.ts
export class SecurityConfig {
    // ...
    /**
     * Whether to enable hooks (like pre-commit hooks) for the Git node.
     * Default: false
     */
    @Env('N8N_GIT_NODE_ENABLE_HOOKS')
    enableGitNodeHooks: boolean = false;
}

// packages/nodes-base/nodes/Git/Git.node.ts
// ...
const enableHooks = securityConfig.enableGitNodeHooks;

// 如果未显式开启 Hooks 支持,强制将 hooksPath 指向 /dev/null
if (!enableHooks) {
    gitConfig.push('core.hooksPath=/dev/null');
}

// 初始化 simple-git 实例,将 config 数组作为参数传递
// 这相当于执行 git -c core.hooksPath=/dev/null ...
const gitOptions: Partial<SimpleGitOptions> = {
    baseDir: repositoryPath,
    config: gitConfig,
};
const git = (0, simple_git_1.default)(gitOptions)
    .env('GIT_TERMINAL_PROMPT', '0');

这种修复方式不仅防御了 addConfig 注入,也防御了类似 CVE-2025-62726 的裸仓库 Hooks 攻击(如果裸仓库检测被绕过),因为它从根本上禁用了 Hook 的执行能力。

7. 修复建议

  1. 升级版本: 升级 n8n 至最新版本(至少高于 1.64.3)。
  2. 最小权限: 运行 n8n 容器时,避免使用 root 用户(虽然 n8n 默认使用 node 用户,但需确保容器隔离性)。
  3. 审查工作流: 检查现有工作流中是否存在异常的 Git 节点配置操作,特别是涉及 addConfig 的部分。

8. 参考链接

  1. Git Documentation - core.hooksPath
  2. n8n Commit - Fix: Disable Git Hooks by Default