Skip to content
guaidao2Public

About

A Chinese-first web fuzzer in Go with FUZZ placeholders (wfuzz / ffuf style), built around diff judgement: dynamic content is normalised and echoed values restored, so only payloads that really changed the page are reported. | 用 Go 编写、面向中文用户的 Web Fuzz 工具(wfuzz / ffuf 风格的 FUZZ 占位符),核心是差异判定:归一化动态内容、还原回显参数,只报真正让页面发生变化的 payload。

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

fastfuzz

智能 Web 渗透测试 Fuzz 工具 —— 自动识别"哪些 payload 发出去之后和原本页面不同"

开发者:coolmoon & guaidao2

fastfuzz 是一款用 Go 编写的、面向中文用户的 Web Fuzz 工具。它和 wfuzz / ffuf 一样用 FUZZ 关键字标记注入点,支持 GET / POST、参数 fuzz、目录探测、字典爆破等常见玩法;但它的核心卖点 是智能差异识别:

传统 Fuzz 工具只看"状态码 / 响应长度 / 词数",遇到带时间戳、CSRF token、随机 ID、会话 标识的动态页面就会满屏误报。fastfuzz 会先把这些动态噪声归一化掉,再把被回显的参数值还原成 基线值,最后用多维度相似度判断"页面到底变没变",因此只报真正有差异的 payload。


目录


核心能力

能力 说明
FUZZ 占位符 URL、请求头、请求体里都可以写 FUZZ,也支持 FUZZ0、FUZZ1 编号写法
GET / POST 命令行或直接粘贴 Burp 的原始请求文件
智能差异识别 归一化动态内容 + 还原参数回显 + 多维度相似度 + 敏感关键字检测
参数 fuzz 参数值 fuzz、参数名 fuzz,还能自动提取 URL/正文中的所有参数逐个 fuzz
多注入点 clusterbomb(笛卡尔积)、pitchfork(同步推进)、sniper(单点注入)
编码支持 none / url / urlall / double,避免含空格、引号的 payload 被服务器直接判 400
结果复核 --verify N 对命中项重放 N 次,排除偶发抖动造成的误报
内置字典 12 份常用字典内嵌在二进制里,离线可用
结果导出 JSON / CSV(带中文表头,Excel 友好)/ TXT / curl 重放脚本 / raw 请求文件
全中文 帮助、报错、进度、报告、代码注释全部中文

编译与安装

直接使用发布包

到 Releases 下载对应平台的文件,解压即用(每个包里含 fastfuzz 二进制和 本 README):

平台 架构 文件
Linux x86-64 / arm64 / 386 fastfuzz_<版本>_linux_<架构>.tar.gz
macOS Intel / Apple Silicon fastfuzz_<版本>_darwin_<架构>.tar.gz
Windows x86-64 / arm64 fastfuzz_<版本>_windows_<架构>.zip
tar -xzf fastfuzz_1.0.0_linux_amd64.tar.gz
cd fastfuzz_1.0.0_linux_amd64 && chmod +x fastfuzz
./fastfuzz -h

校验完整性(可选):

sha256sum -c sha256sums.txt

自己编译

需要 Go 1.25 或更高版本(开发环境为 go1.26)。

# 编译本机平台
make build          # 输出 bin/fastfuzz

# 或者
go build -o fastfuzz .

# 一次性交叉编译全部平台并打包(产物在 dist/)
make release

如果拉取依赖超时,可以设置国内镜像: go env -w GOPROXY=https://goproxy.cn,direct

make release 会编译以下 7 个平台,并生成 tar.gz / zip 压缩包与 sha256sums.txt 校验和, 可直接上传到 GitHub Release:

dist/fastfuzz_1.0.0_linux_amd64.tar.gz
dist/fastfuzz_1.0.0_linux_arm64.tar.gz
dist/fastfuzz_1.0.0_linux_386.tar.gz
dist/fastfuzz_1.0.0_darwin_amd64.tar.gz
dist/fastfuzz_1.0.0_darwin_arm64.tar.gz
dist/fastfuzz_1.0.0_windows_amd64.zip
dist/fastfuzz_1.0.0_windows_arm64.zip
dist/sha256sums.txt

上传到 GitHub Release:

# 用 gh 命令行(需先 gh auth login)
gh release create v1.0.0 dist/*.tar.gz dist/*.zip dist/sha256sums.txt \
  --title "fastfuzz v1.0.0" --notes-file README.md

其它命令

make test        # 全部单元测试 + 端到端测试
make test-race   # 竞态检测
make check       # 格式化 + 静态检查 + 测试
make clean       # 清理 bin/ 与 dist/

运行:

./fastfuzz -h               # 完整中文帮助
./fastfuzz --version        # 版本与署名
./fastfuzz --list-builtin   # 查看内置字典

快速开始

# 1. 目录 / 文件探测:只有真正存在的路径会报出来,其他 404 页面(含随机 token)会被自动忽略
fastfuzz -u "http://target/FUZZ" -w builtin:dirs

# 2. GET 参数值 fuzz(URL 注入建议加 --encode urlall)
fastfuzz -u "http://target/news.php?id=FUZZ" -w builtin:sqli --encode urlall

# 3. POST 表单 fuzz
fastfuzz -u "http://target/login.php" -X POST -d "user=FUZZ&pass=123" -w builtin:users

# 4. 参数名发现
fastfuzz -u "http://target/api?FUZZ=1" -w builtin:params

# 5. 自动提取参数并逐个 fuzz
fastfuzz -u "http://target/api?id=1&name=admin" -w builtin:sqli --auto-params values

# 6. 直接复用 Burp 的原始请求(右键 → Copy to file 保存)
fastfuzz -r request.txt -w builtin:xss --show-diff

# 7. 导出 CSV 并对命中项复核两次
fastfuzz -u "http://target/FUZZ.php" -w builtin:files -o out.csv --verify 2 --table

一次典型输出:

[命中] 相似度 0.452 │ 状态码变化、敏感关键字、页面标题变化、长度突变 │ 状态 500 (基线 200)
       载荷: a'b
       长度: 474 (+35)  耗时: 2ms  方法: GET
       原因: 状态码 200 → 500;响应中出现新的敏感特征:SQL 语法错误(MySQL);标题 "正常页面" → "数据库错误"

智能差异识别是怎么做的

这是 fastfuzz 与其它工具最本质的区别。判定一个响应"是否与基线不同"要经过四步:

1. 归一化:把"每次都变"的内容抹平成占位符

内置规则(可用 --norm-disable 关闭任意一条,或用 --norm-rule 追加自己的规则):

规则名 处理对象 例子
uuid UUID 550e8400-e29b-41d4-a716-446655440000 → <UUID>
httpdate HTTP 日期 Mon, 06 May 2024 12:33:44 GMT → <HTTPDATE>
datetime 日期时间 2024-05-06 12:33:44 → <DATETIME>
time 时间 12:33:44 → <TIME>
epochms 毫秒时间戳 1714998821000 → <TS>
token CSRF token / session id 字段 csrf_token=xxx → csrf_token<TOKEN>
hex 长十六进制串 32 位 md5 → <HEX>
base64 长 base64 串 → <B64>
random 随机串(大小写+数字混排的长串) XbheR9nAUh4WWYPSA296PaiHSMR2ZIc8 → <RAND>
longnum 超长数字 14 位以上 → <NUM>

此外,相似度计算时还会把 4 位以上的数字统一替换成 <N>,这样页面里的随机数、计数器、 偏移量不会影响判定;而数字位数的变化会体现为长度差异,由长度判定负责捕捉,两者互补。

2. 还原参数回显

很多页面(尤其是参数 fuzz 场景)会把参数值原样回显到 HTML 里。这时每个 payload 都会让页面 看起来"变了",只比长度或全文的工具会全量误报。

fastfuzz 的做法是:把响应中出现的注入值替换回基线值,于是回显被还原成基线的样子,只有 页面结构/内容真正改变时才会凸显出来。同时会自动识别 payload 的多种写法(原样 / URL 编码 / URL 解码 / HTML 转义)。

  • 想反过来利用回显(找反射型 XSS 点):--reflect detect
  • 完全不想处理:--reflect off

3. 多维度相似度

对归一化后的文本计算三路相似度并加权:

维度 权重 作用
字符三元组余弦相似度 0.5 反映整体内容重合度
字符三元组 Jaccard 相似度 0.2 对新增/缺失片段敏感
SimHash 汉明相似度 0.3 快速近似判重,捕捉大范围改写

短文本(不足 32 字节)会退化成精确比较,避免三元组统计失真。

4. 判定与解释

判定完全基于与基线的比较,任一维度越界即认为"不同",并给出中文原因:

  • 状态码变化:200 → 500
  • 跳转目标变化:Location 或最终落地地址变了(默认不跟随跳转,正是为了观察这一点)
  • 响应类型变化:文本 ↔ 二进制
  • 页面标题变化
  • 长度突变:归一化长度差超过容忍度(默认 2% 或 16 字节,取较大者)
  • 内容突变:综合相似度低于阈值(灵敏度 3 时是 0.96)
  • 敏感关键字:响应中新出现了 SQL 报错、异常栈、/etc/passwd 内容、目录列表等 45 类特征
  • 参数回显:仅在 --reflect detect 下作为信号

命中项按差异强度(强 / 中 / 弱)和相似度排序输出。


参数说明

目标

参数 说明
-u, --url 目标 URL,用 FUZZ 标记注入点
-X, --method 请求方法,默认 GET(带 --data 时默认 POST)
-d, --data 请求体
--data-file 从文件读取请求体
-H, --header 自定义请求头,可重复
-b, --cookie Cookie
-r, --raw Burp 原始请求文件
--raw-https 原始请求强制走 https

字典

参数 说明
-w, --wordlist 字典文件或内置字典(builtin:名字),可重复;给多个时按注入点顺序一一对应
--list-builtin 列出全部内置字典

请求控制

参数 默认 说明
-t, --threads 20 并发数
--rate 0 每秒请求上限,0 表示不限速
--timeout 10s 单请求超时,支持 10s / 500ms / 1m
--retry 0 失败重试次数
-L, --follow 关 跟随跳转
--max-redirects 10 最大跳转次数
--proxy 无 支持 http:// 与 socks5://
-k, --insecure 关 跳过 TLS 校验
-a, --user-agent 内置 自定义 UA
--random-ua 关 每次请求随机 UA

注入方式

参数 默认 说明
--mode clusterbomb clusterbomb / pitchfork / sniper
-e, --encode none none / url / urlall / double
--baseline-value 1 构造基线请求时用来填充 FUZZ 的值
--baseline-mode value value(用上面的值填充)/ empty(把 FUZZ 置空)
--auto-params 关 values / names / both:自动提取参数并逐个 fuzz
--max-requests 0 请求总数上限,超过则拒绝执行(防组合爆炸)

智能判定

参数 默认 说明
-s, --sensitivity 3 灵敏度 1~5,越大越容易报出差异
--similarity 按灵敏度 自定义内容相似度阈值
--len-tolerance 按灵敏度 自定义长度容忍度,可写 5%
--reflect filter filter 抹平回显 / detect 把回显当信号 / off
--norm-rule 无 追加归一化规则,格式 正则=>替换
--norm-disable 无 禁用内置规则,可重复或逗号分隔
--norm-numbers 关 把普通数字也归一化(数字密集的动态页)
--no-normalize 关 完全关闭归一化,退化为原始内容比对
--keywords 无 追加敏感关键字,支持 关键字=中文名
--no-default-keyword 关 不使用内置关键字表
--verify 0 命中项重放次数,全部仍然不同才算命中
--ignore-status / --ignore-length / --ignore-keyword 关 忽略对应维度

输出

参数 默认 说明
-o, --output 无 输出路径(raw 格式时是目录)
--of 按扩展名 json / csv / txt / curl / raw
-q, --quiet 关 只输出命中行
--table 关 结束后打印结果表格
--show-diff 关 打印命中项的差异内容
--diff-lines 20 差异内容最多显示多少行
--no-progress / --no-color 关 关闭进度显示 / 彩色输出

内置字典

用 -w builtin:<名字> 或直接 -w <名字> 引用(若磁盘上存在同名文件则优先用文件)。

名字 说明
common 综合 fuzz 小字典(分隔符、边界值、编码变形)
dirs 常见目录与路径
params 常见参数名(参数发现)
files 敏感文件与配置文件
ext 备份文件后缀
sqli SQL 注入 payload
xss XSS payload
lfi 路径穿越与文件包含 payload
ssrf SSRF 内网与回环地址
ssti 模板注入 payload
users 常见用户名
passwords 常见弱口令样本

自定义字典就是纯文本,一行一个,空行与 # 开头的行会被忽略。


典型使用场景

目录探测:让"看起来一样"的 404 页面安静下来

fastfuzz -u "http://target/FUZZ" -w builtin:dirs --table

即便站点的 404 页面里带着随机 CSRF token、时间戳、随机请求 ID,fastfuzz 也只会报出真正存在 的路径。

参数 fuzz:避开"参数被回显"的坑

fastfuzz -u "http://target/search.php?q=FUZZ" -w builtin:sqli -e urlall

q 的值会被回显在搜索结果里,普通工具会把每个 payload 都报成"长度变化";fastfuzz 会先把回显 还原,只留下真正的报错页、跳转、内容变化。

参数名发现

# 对比"带该参数"与"不带该参数"的页面差异
fastfuzz -u "http://target/api?FUZZ=1" -w builtin:params --baseline-mode value

直接复用 Burp 请求

fastfuzz -r req.txt -w builtin:xss --show-diff --verify 2 -o xss.json

命中项还能导出成 raw 请求文件(--of raw),直接贴回 Burp Repeater 复现。

多注入点

# clusterbomb:2 × 3 = 6 种组合
fastfuzz -u "http://target/a.php?x=FUZZ&y=FUZZ" -w w1.txt -w w2.txt

# pitchfork:两个字典同步推进
fastfuzz -u "http://target/a.php?user=FUZZ&pass=FUZZ" -w builtin:users -w builtin:passwords --mode pitchfork

# sniper:每次只替换一个位置
fastfuzz -u "http://target/a.php?x=FUZZ&y=FUZZ" -w w1.txt --mode sniper

调优与排错

命中太多(误报)

  1. 页面有大量随机内容没被识别?用 --norm-numbers,或加自定义规则: --norm-rule '随机字段=\S+=>随机字段=<X>'
  2. 页面把 payload 回显到很多地方?确认没有加 --reflect detect。
  3. 降低灵敏度:-s 2 或 -s 1。

命中太少(漏报)

  1. 提高灵敏度:-s 4、-s 5。
  2. 差异只体现在很细微的地方(比如多了一个空格、一个数字)?试试 --no-normalize, 用最原始的方式比较。
  3. 加上 --show-diff 观察差异内容,判断是不是归一化把关键信息抹掉了。
  4. 确认关键内容没被 random / hex 规则误伤,必要时 --norm-disable random。

大量请求返回 400

多半是 payload 里的空格、单引号没编码。加 -e urlall。

状态码全是 403 / 429

目标有 WAF 或限速,降低并发与速率:-t 5 --rate 10,必要时加 --random-ua。

想看真实差异片段

--show-diff --diff-lines 40。


与 wfuzz / ffuf 的差异

维度 fastfuzz wfuzz / ffuf
差异判定 归一化动态内容 + 回显还原 + 三路相似度 + 敏感关键字 主要看状态码 / 长度 / 词数 / 行数
动态页面 只报真实差异 容易全量误报
参数回显 自动还原,可选检测 不处理
结果解释 给出中文差异原因与相似度分值 只给数值
参数名发现 --auto-params 自动提取 需要手工拼接
命中复核 --verify 重放确认 无
界面语言 全中文 英文

项目结构

fastfuzz/
├── main.go                     程序入口
├── Makefile                    构建 / 测试 / 交叉编译
├── internal/
│   ├── config/                 命令行解析与中文帮助
│   ├── fuzz/                   FUZZ 模板解析、请求渲染、注入点迭代
│   ├── dict/                   字典加载(文件 + 内置)
│   ├── payloads/               内置字典(go:embed)
│   ├── httpx/                  HTTP 客户端(并发 / 限速 / 代理 / 重试 / 跳转)
│   ├── analyze/                归一化、指纹、相似度、判定引擎、diff
│   ├── rawreq/                 Burp 原始请求解析
│   ├── runner/                 任务调度、基线、自动参数、复核
│   └── output/                 中文输出、表格、结果导出
└── internal/payloads/data/     字典数据文件

开发命令:

make test        # 全部单元测试 + 端到端测试
make test-race   # 竞态检测
make check       # 格式化 + 静态检查 + 测试

端到端测试会用 httptest 起一个带随机 token、时间戳、随机数字的靶场,专门验证两件事: 相同的动态页面不能被误报、真实的差异不能被漏报。


免责声明

本工具仅供获得合法授权的安全测试、CTF 比赛与教学研究使用。请勿用于未授权目标, 使用者需自行承担因不当使用产生的一切后果。


许可证

本项目采用 MIT 许可证 发布,版权归 coolmoon & guaidao2 所有。

说明:仓库内只保留源码,编译好的各平台二进制与校验和文件放在 Releases 页面单独发布,不随源码提交。

About

A Chinese-first web fuzzer in Go with FUZZ placeholders (wfuzz / ffuf style), built around diff judgement: dynamic content is normalised and echoed values restored, so only payloads that really changed the page are reported. | 用 Go 编写、面向中文用户的 Web Fuzz 工具(wfuzz / ffuf 风格的 FUZZ 占位符),核心是差异判定:归一化动态内容、还原回显参数,只报真正让页面发生变化的 payload。

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages