NAXSI 安装与配置完全指南

2026-01-20 02:15:18作者：申梦珏Efrain

项目基础介绍及主要编程语言

NAXSI（Nginx Anti XSS & SQL Injection）是一款高性能且维护成本低的Web应用防火墙（WAF），专为Nginx设计。它作为一个第三方模块，可以在多数UNIX类系统上作为包安装。NAXSI通过一组简单的规则来防御常见的网站漏洞，如XSS攻击和SQL注入。这些规则默认覆盖了99%已知的风险模式。不同于依赖签名库的传统WAF，NAXSI更注重动态学习和自适应调整，强化其防御未知威胁的能力。该项目主要使用C语言编写。

关键技术和框架

核心技术：基于正则表达式的模式匹配，自学习机制。
框架：直接集成于Nginx，无需外部服务或复杂的架构支持。
依赖：主要依赖于libpcre（Perl兼容正则表达式库）进行高效的模式匹配。

准备工作和详细安装步骤

环境准备

确保你的服务器或开发环境已经安装了以下软件：

Nginx: 最新版或者一个兼容NAXSI的稳定版本。
GCC: 编译工具链。
Autoconf: 配合编译过程。
Automake: 同样用于编译流程自动化。
Libpcre: 提供正则表达式处理能力。
Git: 用于从GitHub下载NAXSI源代码。

你可以通过包管理器安装这些依赖，例如在Ubuntu上可以运行：

sudo apt-get update
sudo apt-get install nginx build-essential autoconf automake libpcre3-dev git

下载与编译NAXSI

克隆NAXSI仓库 (考虑到原仓库已归档，我们建议使用活跃分支的仓库地址，这里展示的是假设路径，实际应查看最新维护仓库)
```
git clone https://github.com/wargio/naxsi.git
cd naxsi
```

配置与编译NAXSI模块。首先确认你的Nginx源码路径，然后执行以下命令来准备构建NAXSI模块：

# 这里的/path/to/nginx/source应该替换为你实际的Nginx源代码路径
./configure --with-nginx=/path/to/nginx/source
make

安装NAXSI到Nginx

复制模块文件，找到编译好的.so文件并将其复制到Nginx的modules目录中，通常路径类似下面这样：
```
sudo cp objs/ngx_http_naxsi_module.so /usr/local/nginx/modules/
```

修改Nginx配置，打开Nginx的配置文件（通常是/etc/nginx/nginx.conf或/usr/local/nginx/conf/nginx.conf），添加对NAXSI模块的支持，并引入规则集。你需要在http块中增加NAXSI配置，并在server块中应用它：

http {
    ...
    include /path/to/naxsi_core_rules;
    include /path/to/naxsi_extended_rules;
    
    server {
        listen 80;
        server_name your.server.name;
        
        location / {
            # 开启NAXSI WAF保护
            naxsi_rules;
            # 其他Nginx配置...
        }
    }
    ...
}

注意替换/path/to/naxsi_core_rules和/path/to/naxsi_extended_rules为实际的规则文件路径。