特性

• 与 ffuf 无缝集成
• 自动建议相关的文件扩展名用于模糊测试
• 支持 OpenAI 和 Anthropic 的 AI 模型
• 传递所有 ffuf 参数

先决条件

• Python 3.6+
• ffuf（已安装并可在 PATH 中访问）
• OpenAI API 密钥或 Anthropic API 密钥

安装

1. 克隆本仓库：

   git clone https://github.com/jthack/ffufai
   cd ffufai
   

2. 安装所需的 Python 包：

   pip install requests openai anthropic
   

3. 将脚本设置为可执行：

   chmod +x ffufai.py
   

4. （可选）若想在任何地方使用 ffufai，可以在 PATH 路径下的目录中创建一个符号链接。例如：

   sudo ln -s /full/path/to/ffufai.py /usr/local/bin/ffufai
   

   请将“/full/path/to/ffufai.py”替换为你克隆仓库的实际完整路径。

5. 将 API 密钥设置为环境变量： 对于 OpenAI：

   export OPENAI_API_KEY='your-api-key-here'
   

   或者对于 Anthropic：

   export ANTHROPIC_API_KEY='your-api-key-here'
   

   你可以将这些行添加到 ~/.bashrc 或 ~/.zshrc 文件中，使其永久生效。

使用方法

使用 ffufai 的方式与使用 ffuf 相同，只需将 ffuf 替换为 python3 ffufai.py（如果你已创建符号链接，则直接使用 ffufai）：

python3 ffufai.py -u https://example.com/FUZZ -w /path/to/wordlist.txt

或者如果你已创建符号链接：

ffufai -u https://example.com/FUZZ -w /path/to/wordlist.txt

ffufai 会根据 URL 自动建议扩展名，并将其添加到 ffuf 命令中。

参数

ffufai 接受 ffuf 的所有参数，此外还提供了一些额外的选项：

• --ffuf-path：指定 ffuf 可执行文件的路径。默认值为 'ffuf'。 示例：ffufai --ffuf-path /usr/local/bin/ffuf -u https://example.com/FUZZ -w wordlist.txt

• --max-extensions：设置建议的最大扩展名数量。默认值为 4。 示例：ffufai --max-extensions 6 -u https://example.com/FUZZ -w wordlist.txt

• -u：指定目标 URL。此参数为必填项，且需包含 FUZZ 关键字。 示例：ffufai -u https://example.com/FUZZ -w wordlist.txt

• -w：指定用于模糊测试的单词列表。这是 ffuf 的标准参数。 示例：ffufai -u https://example.com/FUZZ -w /path/to/wordlist.txt

其他所有 ffuf 参数均可正常使用。有关 ffuf 参数的完整列表，请参阅 ffuf 文档。

注意事项

• ffufai 需要将 FUZZ 关键字放在 URL 路径的末尾，以便准确地建议扩展名。如果未按此要求，工具会发出警告。
• 所有 ffuf 参数都会被传递给 ffuf，因此你可以将任何 ffuf 选项与 ffufai 一起使用。
• 如果同时设置了 OpenAI 和 Anthropic 的 API 密钥，ffufai 会优先使用 OpenAI 的密钥。

特别鸣谢 zlz，又名 Sam Curry，提出了这个项目的绝妙想法。他提出建议后仅两小时，这个项目就诞生了 :)

故障排除

• 如果遇到“命令未找到”的错误，请确保你使用的是 python3 ffufai.py，或者已正确设置了符号链接。
• 如果出现 API 密钥错误，请确认你已正确设置了 OPENAI_API_KEY 或 ANTHROPIC_API_KEY 环境变量。
• 如果看到“import: command not found”错误，说明脚本正在被 shell 解释，而不是 Python 解释。请确保你使用 python3 ffufai.py 运行脚本，或者检查脚本顶部的 shebang 行是否正确。

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

ffufai 快速上手指南

ffufai 是一款基于 AI 的 Web 模糊测试（Fuzzing）增强工具，它是流行工具 ffuf 的智能包装器。它能根据目标 URL 和响应头，自动利用 OpenAI (GPT) 或 Anthropic (Claude) 模型推荐最相关的文件扩展名，从而提升 fuzzing 效率。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux 或 macOS（Windows 需使用 WSL 或 Git Bash）。
• Python 版本：Python 3.6 或更高版本。
• 核心依赖：
  • ffuf：必须已安装并配置在系统环境变量 (PATH) 中。
  • API Key：您需要拥有有效的 OpenAI API Key 或 Anthropic API Key。
• Python 库：requests, openai, anthropic。

安装步骤

1. 克隆项目

将代码仓库克隆到本地并进入目录：

git clone https://github.com/jthack/ffufai
cd ffufai

2. 安装 Python 依赖

使用 pip 安装所需的第三方库。 (注：国内用户如遇下载缓慢，可添加 -i https://pypi.tuna.tsinghua.edu.cn/simple 使用清华镜像源)

pip install requests openai anthropic

3. 赋予执行权限

chmod +x ffufai.py

4. 配置全局命令（可选）

为了方便在任何目录下直接调用 ffufai，可以创建软链接（请将 /full/path/to/ffufai.py 替换为实际绝对路径）：

sudo ln -s /full/path/to/ffufai.py /usr/local/bin/ffufai

5. 设置 API 密钥

将您的 API Key 导出为环境变量。您可以根据需要选择 OpenAI 或 Anthropic。

使用 OpenAI:

export OPENAI_API_KEY='your-api-key-here'

使用 Anthropic:

export ANTHROPIC_API_KEY='your-api-key-here'

提示：可将上述命令添加到 ~/.bashrc 或 ~/.zshrc 文件中以永久生效。

基本使用

ffufai 的使用方式与原生 ffuf 几乎完全一致，它会自动分析 URL 并注入推荐的扩展名。

注意：URL 中的 FUZZ 关键字必须位于路径末尾，以便工具准确推断扩展名。

最简单的使用示例

假设您已配置好软链接，直接运行以下命令即可：

ffufai -u https://example.com/FUZZ -w /path/to/wordlist.txt

如果您未配置软链接，请使用 python 执行：

python3 ffufai.py -u https://example.com/FUZZ -w /path/to/wordlist.txt

常用参数说明

除了支持所有原生 ffuf 参数外，ffufai 还提供以下特有参数：

• --max-extensions: 限制 AI 推荐的最大扩展名数量（默认值为 4）。

  ffufai --max-extensions 6 -u https://example.com/FUZZ -w wordlist.txt
  

• --ffuf-path: 指定 ffuf 可执行文件的具体路径（默认为 ffuf）。

  ffufai --ffuf-path /usr/local/bin/ffuf -u https://example.com/FUZZ -w wordlist.txt
  

所有其他 ffuf 标准参数（如 -t, -H, -mc 等）均可照常传递使用。