modsecurity nginx

### 如何在Nginx中配置和使用ModSecurity

#### 安装后的文件结构
安装完成后，在`/etc/nginx`目录下会新增一些重要文件用于支持ModSecurity功能[^1]。这些文件包括但不限于：

- `/etc/nginx/modsecurity.conf`: WAF的主要配置文件。
- `/etc/nginx/nginx.conf.modsecurity`: 提供了一个基于Nginx的示例配置来集成ModSecurity。

此外，还有模块文件位于`/usr/lib64/nginx/modules/ngx_http_modsecurity_module.so`以及额外的配置样例存放在`/usr/share/nginx/modules/mod-modsecurity.conf`内。

#### 主要配置文件说明
对于Nginx而言，主要涉及两个位置的配置文件设置：一是全局性的安全策略定义；二是具体到Web服务端口上的应用层防护规则设定。前者通常由`/etc/nginx/modsecurity.conf`负责管理，而后者则通过修改默认的Nginx站点配置实现，即编辑`nginx.conf`或其衍生版本中的特定部分以加载并启用ModSecurity模块[^2]。

# 加载modsecurity模块至nginx配置中
load_module modules/ngx_http_modsecurity_module.so;
...
http {
    ...
    include modsecurity.conf; # 引入modsecurity主配置
}

#### 启用与测试
为了使上述更改生效，需重启Nginx服务。之后可以通过访问受保护的应用程序页面来进行初步的功能验证。如果一切正常工作，则表示已经成功集成了ModSecurity作为网站的安全屏障之一。

#### 日志记录路径
当遇到问题时可以查看如下几个关键的日志文件以便于排查错误原因：
- 调试信息存储于`/var/log/httpd/modsec_debug.log`
- 报警事件会被写入到`/var/log/httpd/modsec_audit.log`中[^3]