
waf-checker v1.2.0
自动化 WAF 评估工具,可检测防火墙厂商,使用高级规避载荷测试 19 种攻击类别,并通过 CLI、Cloudflare Worker 或 Docker 提供颜色编码的绕过分析。
WAF 检测器
本项目可帮助你检查你的 Web 应用防火墙(WAF)对常见 Web 攻击的防护效果。它既可以作为 Cloudflare Worker 运行(内置交互式 Web UI),也可以作为独立的 Node.js CLI 工具运行。
🧪 测试覆盖率与状态
所有包均通过自动化单元测试、集成测试、基于属性的测试(fast-check 模糊测试)、网络韧性测试和逆向工程测试套件进行了全面测试(100% SSRF 安全合规、协议规避技术和报告格式化器):
| 包 | 行覆盖率 | 语句 | 函数 | 测试套件 |
|---|---|---|---|---|
@waf-checker/core | 93.0% 🟢 | 92.6% | 96.4% | 🟢 282 项通过 |
@waf-checker/cli | 93.5% 🟢 | 92.8% | 96.7% | 🟢 54 项通过 |
@waf-checker/worker | 通过 🟢 | — | — | 🟢 30 项通过 |
| 单仓库测试套件总计 | 93.2% | 92.7% | 96.6% | 🟢 366 项测试通过 |
功能特性
核心测试
- 输入目标 URL,选择 HTTP 方法(GET、POST 等)和攻击类别。
- 发送携带攻击载荷的请求(位于参数、请求头或文件路径中)。
- 终端和 Web 结果采用颜色编码:🟢 403/BLOCKED = 已拦截,🔴 2xx/5xx = 可能存在绕过,🟠 3xx = 重定向。
- 结果以可筛选的表格展示,并附有每个载荷的详细信息。
🕵️ WAF 逆向工程与 CRS 矩阵(--reverse)
- OWASP 核心规则集(CRS v3/v4)映射:审计启用与禁用的规则 ID(
920xxx、921xxx、930xxx、931xxx、932xxx、933xxx、934xxx、941xxx、942xxx、943xxx、944xxx)及其偏执等级(PL1-PL4)。 - 检查请求体限制检测:通过二分搜索探测(8KB – 128KB,精度约 1KB)识别缓冲区截断边界。
- 异常评分模式检测:探测协作评分模式与严格正则拦截模式,并识别评分阈值。
- 安全速率限制探测:安全地逐步提升至最高 30 req/s,一旦收到 HTTP 429 立即提前终止,并提取
Retry-After。
🛡️ WAF 虚拟补丁与自动修复(--patch / patch 命令)
- 即时缓解:自动将检测到的 WAF 绕过(HTTP 200)转换为可直接部署的防火墙规则、反向代理配置和基础设施即代码(Terraform HCL / Cloud CLI)。
- 支持的平台(11 种方言):
- Cloudflare WAF:Wirefilter 表达式(
http.request.uri.query contains .../matches ...)及cloudflare_rulesetTerraform HCL。 - AWS WAF v2:原生 JSON 规则语句(
ByteMatchStatement、RegexPatternSet、OrStatement)及aws_wafv2_rule_groupTerraform HCL。 - Google Cloud Armor:CEL 表达式(
request.path.matches(...)、request.headers[...])、gcloud compute security-policiesCLI 命令及 Terraformgoogle_compute_security_policy。 - Azure WAF(Front Door 与 App Gateway):自定义规则 JSON 定义、
az network front-door waf-policyCLI 命令及 Terraformazurerm_cdn_frontdoor_firewall_policy。 - ModSecurity 与 OWASP Coraza:兼容 OWASP CRS 的
SecRule指令(SecLang),支持@pm令牌折叠。通过--patch modsecurity或--patch coraza支持。 - NGINX:原生
location ~* \.(ext)$ { return 403; }、location ~ /\.(git|svn)及map配置块。 - HAProxy:高性能原生 ACL(
path_end -i、path_beg -i、query -m sub -i、req.hdr())配合http-request deny deny_status 403。 - Caddy Server:地道的 Caddyfile 命名匹配器(
@waf_patch_*),配合 CEL 表达式(expression {http.request.uri.query}.matches(...))和respond 403。 - Apache HTTP Server:用于
httpd.conf、<VirtualHost>或.htaccess的mod_rewrite规则(RewriteCond %{QUERY_STRING}/%{REQUEST_URI}/%{HTTP_USER_AGENT}+RewriteRule ^ - [F,L])。通过--patch apache支持。 - Envoy Proxy:通过 RE2
safe_regex匹配:path/请求头的路由条目,配合direct_response: 403(或在模拟模式下转发并标记),用于 route_configuration 的 virtual_host。通过--patch envoy支持。 - Kubernetes Ingress(K8s):生产就绪的
kind: IngressYAML 清单,带有nginx.ingress.kubernetes.io/server-snippet注解。
- Cloudflare WAF:Wirefilter 表达式(
- 双层防御:
- 严格热修复:精确令牌签名,0% 误报风险,用于即时零日事件响应。
- 启发式模式:覆盖整个漏洞类别结构的通用正则表达式。
- Web UI 修复工作室:交互式仪表盘模态框,提供所有厂商的实时预览、一键复制到剪贴板、格式切换和文件导出。
攻击类别(共 28 种)
SQL 注入、XSS、命令注入、路径遍历、SSRF、本地文件包含、敏感文件、开放重定向、SSTI、XXE、NoSQL 注入、GraphQL 注入、JWT 攻击(Header)、JWT 攻击(Param)、原型污染(JSON Body)、原型污染(URL/Param)、LDAP 注入、XPath 注入、电子表格公式注入、Log4Shell(JNDI)、CRLF 注入、HTTP 参数污染、User-Agent、IP 绕过、HTTP 请求走私、Web 缓存投毒、UTF8/Unicode 绕过、WAF 检查限制绕过(填充)。
WAF 检测
- 测试前自动检测 WAF 类型(Cloudflare、AWS WAF、OWASP Coraza、BunkerWeb、ModSecurity、Akamai、Imperva、F5 BIG-IP 等)。
- 根据检测到的 WAF 建议特定的绕过技术。
- 可自动切换为针对特定 WAF 的高级载荷。
高级载荷与编码
- WAF 绕过载荷 — 双重编码、unicode、大小写混合、注释注入、多语言载荷。
- 增强载荷 — 现代规避技术。
- 编码变体 — URL、Unicode、HTML 实体、Hex、八进制、Base64 编码及自动组合。
- 针对 Cloudflare、AWS WAF、ModSecurity 的特定 WAF 绕过。
HTTP 协议操纵
- HTTP 动词篡改 — 测试不常见的 HTTP 方法。
- 参数污染 — 在查询/正文中重复和拆分参数。
- Content-Type 混淆 — 使用替代内容类型绕过规则。
- 请求走私头部。
- Host 头部注入变体。
- 通过头部覆盖 HTTP 方法(
X-HTTP-Method-Override等)。
批量测试
- 一次测试多个 URL。
- 可配置的并发数和请求间延迟。
- 实时进度跟踪。
🔀 回归差异对比(--compare / --fail-on-regression)
- 将扫描结果与之前保存的 JSON 报告进行差异对比,以呈现新的绕过(之前被阻止,现在未被阻止)、新被阻止的载荷,以及新增/移除的测试。
- CI 门禁(
--fail-on-regression),仅在 WAF 态势恶化时失败,而非在完整结果列表上失败 — 非常适合捕获托管规则集的漂移。
项目结构
该项目采用 NPM Workspaces monorepo 结构:
packages/core/:核心安全测试库、载荷定义、WAF 指纹识别签名和混淆编码器。packages/worker/:Cloudflare Worker 包,提供静态 HTML/JS Web UI 和 JSON API 端点。packages/cli/:Node.js 命令行界面工具,用于直接从终端执行审计。
安装与构建
从根目录安装依赖并构建所有工作区:
npm install
npm run build
如何运行
1. Web 版本(Cloudflare Worker)
要在本地运行 Worker 开发服务器(需要 Wrangler):
npm run dev:worker
Web UI 可通过 http://localhost:8787 访问(如果 8787 端口被占用,则使用其他端口)。
要将 Worker 部署到 Cloudflare:
npx wrangler deploy --workspace=packages/worker
Worker 需要 Workers Paid 计划:扫描和审计页面的规模是按照每次请求 10,000 个子请求来设计的(wrangler.toml 中的 [limits] subrequests,packages/core/src/check.ts 中的 WORKER_SUBREQUEST_LIMIT)。Free 计划每次请求只允许 50 个外部子请求:一个扫描页面如果启用了 User-Agent 绕过测试(UI 中默认开启)或跟随重定向,就会超出该限制。
2. CLI 版本(Node.js)
将其安装为全局 waf-checker 命令(推荐)
在仓库根目录执行 npm install && npm run build 之后,链接 CLI,使其可以从任意目录运行——无需 cd 进入仓库,也无需使用冗长的 node .../dist 路径:
# Expose `waf-checker` on your PATH from the built workspace
npm link --workspace @waf-checker/cli
# …now, from anywhere:
waf-checker --help
waf-checker check https://example.com
# Uninstall later with:
npm rm -g @waf-checker/cli
已发布的包已捆绑其代码,因此你也可以在没有仓库的情况下全局安装打包构建:npm pack --workspace @waf-checker/cli,然后 npm i -g ./waf-checker-cli-*.tgz。
Shell 补全(bash / zsh / fish)
waf-checker completion <shell> 会打印补全脚本(省略 <shell> 则从 $SHELL 自动检测):
# bash
waf-checker completion bash | sudo tee /etc/bash_completion.d/waf-checker
# or, without root: echo 'source <(waf-checker completion bash)' >> ~/.bashrc
# zsh (into a directory on your $fpath)
waf-checker completion zsh > "${fpath[1]}/_waf-checker"
# fish
waf-checker completion fish > ~/.config/fish/completions/waf-checker.fish
无需全局安装即可运行
你始终可以直接调用构建后的入口点:
# Print general CLI help and usage
node packages/cli/dist/index.js --help
# Print check command help (lists all methods, categories, and WAF vendors)
node packages/cli/dist/index.js check --help
# Discover detectable WAF vendors and payload categories (JSON for automation)
node packages/cli/dist/index.js list-wafs --json
node packages/cli/dist/index.js list-categories --json
WAF 检测
检测目标 URL 背后的 WAF 厂商:
node packages/cli/dist/index.js detect <url>
漏洞载荷审计
针对目标 URL 运行审计:
# Default check (GET method, all payload categories)
node packages/cli/dist/index.js check https://example.com
# Custom check with specific methods, categories, and WAF evasion enabled
node packages/cli/dist/index.js check https://example.com -m GET,POST -c "SQL Injection,XSS" --auto-detect-waf --encoding-variations
批量审计
对文件中定义的 URL 列表运行批量审计:
node packages/cli/dist/index.js batch targets.txt --concurrency 3