ModSecurity CRS Docker 项目教程

ModSecurity CRS Docker 项目教程

modsecurity-crs-docker Official ModSecurity Docker + Core Rule Set (CRS) images 项目地址: https://gitcode.com/gh_mirrors/mo/modsecurity-crs-docker

1. 项目目录结构及介绍

ModSecurity CRS Docker 项目的目录结构如下：

modsecurity-crs-docker/
├── github/workflows/
├── src/
├── .gitignore
├── LICENSE
├── README-containers.md
├── README.md
├── REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf
├── RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf
├── docker-bake.hcl
├── docker-compose.yaml
└── renovate.json

目录结构介绍

• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• src/: 包含项目的源代码文件。
• .gitignore: 指定 Git 版本控制系统忽略的文件和目录。
• LICENSE: 项目的开源许可证文件。
• README-containers.md: 关于容器化部署的说明文档。
• README.md: 项目的主说明文档。
• REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf: 在 CRS 规则之前应用的排除规则配置文件。
• RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf: 在 CRS 规则之后应用的排除规则配置文件。
• docker-bake.hcl: Docker 构建配置文件。
• docker-compose.yaml: Docker Compose 配置文件，用于定义和运行多容器 Docker 应用程序。
• renovate.json: Renovate 配置文件，用于自动化依赖更新。

2. 项目启动文件介绍

项目的启动文件主要是 docker-compose.yaml 和 docker-bake.hcl。

docker-compose.yaml

docker-compose.yaml 文件定义了如何启动和管理多个 Docker 容器。以下是一个示例：

version: '3.8'
services:
  modsecurity:
    image: owasp/modsecurity-crs
    ports:
      - "8080:8080"
    environment:
      - PARANOIA=4
      - BACKEND=http://example.com
    volumes:
      - ./rules:/opt/owasp-crs/rules:ro

docker-bake.hcl

docker-bake.hcl 文件用于定义 Docker 构建的多平台和多架构配置。以下是一个示例：

target "nginx" {
  context = "."
  dockerfile = "Dockerfile"
  platforms = ["linux/amd64", "linux/arm64"]
}

3. 项目配置文件介绍

项目的配置文件主要包括 REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf 和 RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf。

REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf

该文件包含在 CRS 规则之前应用的排除规则。这些规则用于在处理请求时排除某些特定的条件或行为。

RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf

该文件包含在 CRS 规则之后应用的排除规则。这些规则用于在处理响应时排除某些特定的条件或行为。

通过这些配置文件，用户可以根据自己的需求定制 ModSecurity 的行为，以适应不同的应用场景。

modsecurity-crs-docker Official ModSecurity Docker + Core Rule Set (CRS) images 项目地址: https://gitcode.com/gh_mirrors/mo/modsecurity-crs-docker