bit3/nginx-waf

nginx WAF Docker镜像

![repository]([***]

![pipeline status]([***]

镜像概述和主要用途

该Docker镜像包含nginx Web服务器、Web应用防火墙（ModSecurity 3）以及预配置的OWASP ModSecurity核心规则集（CRS）。基于标准（非alpine）https://hub.docker.com/_/nginx/%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%BC%80%E7%AE%B1%E5%8D%B3%E7%94%A8%E7%9A%84Web%E5%BA%94%E7%94%A8%E5%AE%89%E5%85%A8%E9%98%B2%E6%8A%A4%E8%83%BD%E5%8A%9B%E3%80%82

核心功能和特性

• 集成nginx Web服务器，提供稳定的HTTP/HTTPS服务能力
• 内置ModSecurity 3 Web应用防火墙，实现深度安全检测
• 预配置OWASP ModSecurity核心规则集（CRS），覆盖常见Web***防护
• 基于官方标准nginx镜像构建，兼容性良好

使用场景和适用范围

适用于需要为Web应用提供安全防护的各类场景，可有效防御SQL注入、跨站脚本（XSS）、跨站请求伪造（CSRF）等常见Web***。适合部署在生产环境或测试环境中，作为前端Web服务器同时提供安全防护功能。

使用方法和配置说明

可选Gradle属性

可通过以下属性定义nginx、ModSecurity和OWASP CRS的版本。若未设置，将使用最新版本。

bash
./gradlew -P NGINX_VERSION=1.14.0 -P MOD_SECURITY_VERSION=3.0.1 -P MOD_SECURITY_NGINX_VERSION=1.0.0 -P OWASP_VERSION=3.0.0

必填Gradle属性

推送镜像到仓库时需要配置以下属性，需在~/.gradle/gradle.properties文件中设置：

properties
CI_REGISTRY_USER=us3r
CI_REGISTRY_PASSWORD=s3cr3t
CI_REGISTRY=docker.io
GITHUB_ACCESS_TOKEN=s3cr3t