opcache/ngx_waf

ngx_waf

https://github.com/ADD-SP/ngx_waf/workflows/test/badge.svg](https://github.com/ADD-SP/ngx_waf/actions?query=workflow%3Atest) https://github.com/ADD-SP/ngx_waf/actions/workflows/docs.yml/badge.svg]([***] https://github.com/ADD-SP/ngx_waf/actions/workflows/docker.yml/badge.svg](https://github.com/ADD-SP/ngx_waf/actions/workflows/docker.yml) https://app.codacy.com/project/badge/Grade/aebcf93b4b7a4b4b800ceb962479ee3a?branch=master](https://www.codacy.com/gh/ADD-SP/ngx_waf/dashboard?utm_source=github.com&utm_medium=referral&utm_content=ADD-SP/ngx_waf&utm_campaign=Badge_Grade) https://img.shields.io/github/v/release/ADD-SP/ngx_waf?include_prereleases](https://github.com/ADD-SP/ngx_waf/releases) https://img.shields.io/badge/Semantic%20Versioning-2.0.0-blue](https://semver.org/)

https://img.shields.io/badge/Notification-***%20Channel-blue]([] https://img.shields.io/badge/Chat-***%20Group-blue]([]

简体中文 | English

镜像概述

ngx_waf是一款便捷、高性能的Nginx防火墙模块，具备Web应用防火墙的核心功能，无需提前安装其他依赖模块，配置指令简洁易懂，性能损耗极低（极端测试下QPS仅下降约4%）。

核心功能

• SQL注入检测
• 支持IPV4与IPV6
• 防CC***（自动拦截***IP）
• 特定IP例外允许
• 阻止指定IP地址
• 阻止指定请求体
• 特定URL例外允许
• 阻止指定URL
• 阻止指定查询字符串
• 阻止指定UserAgent
• 阻止指定Cookie
• 特定Referer例外允许
• 阻止指定Referer

使用场景

• 保护Web应用免受SQL注入、CC***等常见Web威胁
• 需要快速部署且配置简单的Web服务安全防护
• 对性能要求较高的生产环境Web服务防护

配置说明

详细配置文档请参考：

• 推荐链接：[***]
• 备用链接1：https://add-sp.github.io/ngx_waf/
• 备用链接2：[***]

Docker部署示例

单容器部署

bash
docker run -d --name ngx_waf_container -p 80:80 opcache/ngx_waf

Docker Compose部署（示例）

yaml
version: '3'
services:
  ngx_waf:
    image: opcache/ngx_waf
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf  # 挂载自定义配置文件
    restart: always

联系方式

• 频道：[]
• 群组：[]

许可证

BSD 3-Clause License

致谢

• https://github.com/troydhanson/uthash
• https://github.com/client9/li***jection
• https://github.com/jedisct1/libsodium
• https://github.com/loveshell/ngx_lua_waf
• https://github.com/taobao/nginx-book
• https://github.com/baishancloud/nginx-development-guide