本项目可帮助你检查你的 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 项测试通过 |
--reverse)920xxx、921xxx、930xxx、931xxx、932xxx、933xxx、934xxx、941xxx、942xxx、943xxx、944xxx)及其偏执等级(PL1-PL4)。Retry-After。--patch / patch 命令)http.request.uri.query contains ... / matches ...)及 cloudflare_ruleset Terraform HCL。ByteMatchStatement、RegexPatternSet、OrStatement)及 aws_wafv2_rule_group Terraform HCL。request.path.matches(...)、request.headers[...])、gcloud compute security-policies CLI 命令及 Terraform google_compute_security_policy。az network front-door waf-policy CLI 命令及 Terraform azurerm_cdn_frontdoor_firewall_policy。SecRule 指令(SecLang),支持 @pm 令牌折叠。通过 --patch modsecurity 或 --patch coraza 支持。location ~* \.(ext)$ { return 403; }、location ~ /\.(git|svn) 及 map 配置块。path_end -i、path_beg -i、query -m sub -i、req.hdr())配合 http-request deny deny_status 403。@waf_patch_*),配合 CEL 表达式(expression {http.request.uri.query}.matches(...))和 respond 403。httpd.conf、<VirtualHost> 或 .htaccess 的 mod_rewrite 规则(RewriteCond %{QUERY_STRING} / %{REQUEST_URI} / %{HTTP_USER_AGENT} + RewriteRule ^ - [F,L])。通过 --patch apache 支持。safe_regex 匹配 :path/请求头的路由条目,配合 direct_response: 403(或在模拟模式下转发并标记),用于 route_configuration 的 virtual_host。通过 --patch envoy 支持。kind: Ingress YAML 清单,带有 nginx.ingress.kubernetes.io/server-snippet 注解。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 检查限制绕过(填充)。
X-HTTP-Method-Override 等)。--compare / --fail-on-regression)--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
要在本地运行 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 中默认开启)或跟随重定向,就会超出该限制。
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。
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
检测目标 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