ngx_waf

# 简介

方便又高性能的 Nginx 防火墙模块。

# 为什么选择 ngx_waf

  • 基础防护：如 IP 或 IP 网段的黑白名单、URI 黑白名单和请求体黑名单等。
  • 使用简单：配置文件和规则文件书写简单，可读性强。
  • 高性能：使用高效的 IP 检查算法和缓存机制。
  • 高级防护：兼容 ModSecurity (opens new window)，因此你可以使用开放式网络应用安全项目（OWASP）® 的核心规则库 (opens new window)。
  • 友好爬虫验证：支持验证 Google、Bing、Baidu 和 Yandex 的爬虫并自动放行，避免错误拦截。
  • 验证码：支持三种验证码：hCaptcha、reCAPTCHAv2 和 reCAPTCHAv3。

# 功能

  • 兼容 ModSecurity (opens new window)。此功能仅限最新的 Current 版本。
  • SQL 注入防护（Powered By libinjection (opens new window)）。
  • XSS 攻击防护（Powered By libinjection (opens new window)）。
  • 支持 IPV4 和 IPV6。
  • 支持开启验证码（CAPTCHA)，支持 hCaptcha (opens new window)、reCAPTCHAv2 (opens new window) 和 reCAPTCHAv3 (opens new window)。
  • 支持识别友好爬虫（如 BaiduSpider）并自动放行（基于 User-Agent 和 IP 的识别）。此功能仅限最新的 Current 版本。
  • CC 防御，超出限制后自动拉黑对应 IP 一段时间或者使用验证码做人机识别。
  • IP 黑白名单，同时支持类似 192.168.0.0/16 和 fe80::/10，即支持点分十进制和冒号十六进制表示法和网段划分。
  • POST 黑名单。
  • URL 黑白名单
  • 查询字符串（Query String）黑名单。
  • UserAgent 黑名单。
  • Cookie 黑名单。
  • Referer 黑白名单。

# 联系方式

# 打赏

打赏就算了，如果您愿意，您可以帮助宣传一下本项目。比如发个贴，推荐给身边有需求的人什么的。

我从来没碰过钱，我对钱没有兴趣。

# 测试套件

本项目使用一个 Perl 开发的数据驱动型的测试套件进行测试。 感谢项目 Test::Nginx (opens new window) 及其开发者们。

你可以通过下列命令来运行测试。

# 这行命令的执行时间比较长，但是以后再测试的时候就不需要运行了。
cpan Test::Nginx

# 你需要指定一个临时目录。
# 如果目录不存在会自动创建。
# 如果目录已经会被存在则会先**删除**再创建。
export MODULE_TEST_PATH=/path/to/temp/dir

# 如果你安装了动态模块则需要指定动态模块的绝对路径，反之则无需执行这行命令。
export MODULE_PATH=/path/to/ngx_http_waf_module.so

cd ./test/test-nginx
sh ./init.sh
sh ./start.sh ./t/*.t

# 性能测试

性能测试

# 闲谈

nginx 防火墙模块开发总结 (opens new window)

欢迎访问我的博客：https://www.addesp.com/ (opens new window)。

# 感谢

版本说明 →