宝塔面板Nginx网站防火墙使用说明

简介

一直都有用户建议我们开发木马扫描，木马清理模块，但我们认为与其亡羊补牢，不如直接在源头上阻止站点被挂马的事情发生，《宝塔网站防火墙》是基于nginx/apache模块开发的一套应用层防火墙，能有效阻止大部分渗透攻击，且提供高度自由的规则自定义功能，为站点加一道铜墙铁壁，目前宝塔官网、官方论坛已经成为《宝塔网站防火墙》的首个用户，效果良好。

使用场景：

1.遭受CC攻击、部分流量攻击的用户

2.遭受SQL注入、XSS/XSRF之类的渗透攻击的用户

3.遭受恶意上传脚本、webshell等危险行为的用户

4.希望屏蔽境内或境外地区访问自己网站的用户

5.希望通过UA、IP黑白名单管理网站访问规则的用户

6.希望可视化管理网站防御规则的用户

7.希望实时展示防火墙拦截状态的用户

8.适合想要查看攻击来源、被攻击的URI、保护的目录，但又不会看的用户

9.适合网站不需要某些蜘蛛来访，但又不会禁止的用户

10.适合网站被扫描器恶意扫描，但又不会禁止的用户

11.适合网站发文章不想要某些敏感词出现，但又不会设置的用户

12.应用场景包含所有动态网站

兼容性：仅支持主程序Nginx1.18以上的版本使用，如果低于此版本请更换至更高版本。另外，需要LuaJIT组件的支持，安装Nginx时请使用编译安装模式，如果您已经安装的Nginx并非编译安装，请在业务不忙时重新编译安装后再安装Nginx防火墙。

注意：

1、请根据自己的网站环境 选择是支持Nginx还是支持Apache的防火墙

2、如果您不了解正则表达式，请不要随意修改防火墙自带规则

快速预览(仅是图片展示，后文有更详细的插件使用说明)

安装步骤如下：

登录宝塔面板-->软件商店-->【关键词搜索：Nginx防火墙】或【点击专业版插件】-->网站监控报表-->安装

插件使用快速入门：

【概览】

插件安装后可直接点击宝塔面板左侧【防火墙】按钮，即可访问新版防火墙的管理页面。

启动后它展示的默认页是概览页，它将展示的内容有总拦截次数、24小时拦截次数、CC拦截次数以及保护天数。在第二第三栏中更有封锁IP列表、攻击地图、7天拦截趋势图、今日网站拦截TOP5与防御动态展示。

概览页互动操作如下

1.封锁IP列表、攻击地图下攻击IP排行榜、防御动态鼠标滑轮滚动查看;

2.攻击IP排行榜点击IP可直接将IP加入黑名单;

3.防御动态某一条目点击详情可查看拦截的具体信息。

【攻击地图】此页面将展示攻击者的地图详情，图形化展示攻击者的来源以及承受的攻击情况。

初次使用时，请先点击设置，设置您的所在地，以获得最佳体验。

注：地图仅供参考，目前尚在测试阶段，请以实际为准。

【攻击列表】

攻击报表页面将展示保护类型前10万条的数据、攻击IP排行榜、攻击IP报表、被攻击的URI报表与拦截搜索功能。

攻击列表页互动操作如下

1.鼠标移动到保护类型页可显示各类型的数值;

2.点击攻击IP排行榜的IP可直接将IP加入黑名单;

3.在IP报表、URI报表、拦截搜索项中切换。

IP报表

此项功能有：显示所有攻击者的真实IP，可直接点击IP或详情，从而查看该IP对哪些URI进行了攻击。每个URL后面还可以查看URI访问的详情与HTTP。

URI报表

此项功能有：显示所有被攻击的URI列表，可直接点击URI或详情，从而查看该URI被攻击的详细情况。

拦截搜索

此项功能有：可选择所有站点或单个站点搜索包含IP、URI、URL或时间类型的搜索。

注意：如果当前拦截信息为/111.php?uid=1，则URi为/111.php，URL为/111.php?uid=1

例：

【全局设置】

全局设置页面将展示防火墙的所有功能，可在此设置全局规则、各种类型的黑白名单、响应状态码等。当前页面支持导入导出防火墙的配置(仅支持Nginx防火墙内的规则导入导出)，恢复默认防火墙配置、模拟攻击测试等。

开始前请详细阅读下列提示，非常重要、非常重要、非常重要。

继承：全局设置将在站点配置中自动继承为默认值，现有站点不受全局设置的影响，新增站点才会直接自动继承的应用全局设置。

优先级：IP白名单> IP黑名单 > UA白名单> UA黑名单> URL关键词拦截 > URL白名单 > URL黑名单 > 禁止境外> 禁止境内> > 非浏览器拦截> User-Agent > CC防御 > Cookie > URI过滤 > URL参数 > Thinkphp防御> POST > 网站自定义防御

CC防御

互动操作：设置响应代码、开关防御状态、初始化规则。

注意：全局CC设置的是初始值，新添加站点时将继承，对现有站点无效，已经存在被攻击现象的站点前往站点配置即可。

规则说明：

1.标准模式与增强模式：默认为标准模式，网站正常使用时建议使用标准模式，避免收录时出现问题，增强模式中有人机校验方式设置。

2.请求类型有4种拦截方式，分为URL带参数、URL不带参数、IP、IP+UA

2.1.URL带参数(适用于绝大场景防御效果一般)

例如：设置了URL带参数60秒周期60次频率，此刻Nginx防火墙做出的动作是某个IP在60秒内累计请求同一个URL(带参数)超过60次就会触发拦截。

例如：/index.php/index/login?username=admin，那么他的是代表整个URI去计算的(/index.php/index/login?username=admin)，也就是URL不变的情况下去请求这个URL就会触发拦截。

2.2.URL不带参数(不适用于Thinkphp默认路由)

例如：设置了URL不带参数60秒周期60次频率，此刻Nginx防火墙做出的动作是某个IP60秒内累计请求同一URL(不带参数)超过60次就会触发拦截。

例如：/index.php/index/login?username=admin，那么Nginx防火墙会用URI去计算(/index.php/index/login)，也就是URL(不带参数)不变的情况下去请求这个URL才会触发拦截。

2.3.IP(受到大量攻击的时候适用)

例如：某个IP60秒周期内访问服务器内所有网站的总次数超过60次的频率将会触发拦截，建议在受到攻击的时候开启。注意：不建议一直开启!

2.4.IP+UA(适用于API接口)

例如：某个IP+UA60秒周期内访问服务器内所有网站的总次数超过60次频率将会触发拦截。注意：建议不要开启，只适用于API网站!

3.周期、频率、封锁时间：xx秒周期内累计请求同一URL超过xx次频率，触发CC防御，封锁此IPxx秒，所有时间取1天，最长不会超过86400秒。

例如：60秒周期内累计请求同一URL超过180次频率，触发CC防御，封锁此IP300秒。

注意：IP封锁不等于拉黑名单，需要加黑名单需自行点击添加。请不要设置过于严格的CC规则，以免影响正常用户体验。

4.增强模式-人机校验：可设置自动开启/一直开启，自动开启可设置触发条件，例如60描述被访问600次触发开启人机校验。人机校验有4种校验方式，分为跳转验证、验证码验证、人机验证、滑动验证，只是验证方式不同，看个人喜好开启哪种，如果开启后无法正常显示，手动重启nginx主程序即可。

恶意容忍度

某一IP对网站进行了多少次的恶意请求后，nginx防火墙将进行对该IP的封锁。这不同于CC防御，恶意请求有可能是SQL注入、XSS等恶意传参、CC，当此IP的访问行为达到了设置的阈值，nginx防火墙就会做出封锁动作。

举例：192.168.1.10这个IP对www.bt.cn网站60秒进行了10次恶意攻击(包含SQL注入、XSS)，触发了防火墙设置的阈值，此时防火墙将会对192.168.1.10进行拦截。

注意：全局应用:全局设置当前恶意容忍规则，且覆盖当前全部站点的恶意容忍规则。

IP黑白名单

设置后，所有规则对IP白名单无效，IP白名单前文提到位居规则顶端。IP黑名单设置后既在nginx防火墙禁止此IP访问所有网站。

建议使用场景：自己的服务器间互动、公司内测试、公司的其他服务器IP、需要测试的服务器IP等加入IP白名单(如果没有需求就不用设置IP白名单)。IP黑名单使用场景可以禁止某个或某个段的IP访问、某个段的蜘蛛爬虫，将需要拉黑的IP添加进入即可。

URL黑白名单

设置后，只要是关于添加的URL请求，都是进行URL黑白名单过滤，白名单设置后该URL将会失去大部分防御规则。

注意格式：例如误拦截的url如下： /index/index/aaa.php?id=eradasa&adas，只需要填写它的URL，不需要添加它的参数。

有添加URL黑白名单的需求是，操作如下：^/index/index/aaa.php，只需要添加^/index/index/aaa.php到URL黑白名单即可。

UA黑白名单

设置后，UA白名单查询到关键词直接跳过任何拦截，UA黑白名单初始化阶段在客户端UA中查找关键词，谨慎使用。UA白名单默认为空，没有就一直保持空即可。建议使用场景：例如可以禁用Google蜘蛛的UA到黑名单中，可以禁止某个浏览器UA访问，例如safari等。

非浏览器拦截

拦截非浏览器请求，通过UA判断是否是爬虫，此功能不会拦截真实的蜘蛛爬虫。

建议使用场景：此开关将应用所有网站，建议开启。另外如果使用了微信小程序外部调用，建议关闭此功能，因为微信那边验证网站也是非浏览器行为。

HTTP请求过滤

可选择过滤的请求类型、请求头过滤、语义分析开关等。

请求类型包含：POST、GET、OPTIONS、DELETE等;如果您只想允许POST和GET类型使用，其他的都不要，除了POST和GET其他的都关闭即可。

请求头包含：origin、content-type、accept、user-agent、cookie等;请求头过滤是过滤的请求头的字段长度。

例如：请求头中的cookie头部只能500字节以内，那么超过这个长度就被视为恶意的请求触发拦截。

语义分析开关：POST传参XSS防御、POST传参SQL注入防御、GET传参XSS防御、GET传参SQL注入防御。

建议使用场景：默认既全部开启，不建议关闭、不建议关闭、不建议关闭。

GET(GET-URL)、POST、UA(User-Agent)过滤、Cookie过滤、常见扫描器

GET-参数过滤 --> 对GET类型的参数进行过滤

GET-URL过滤 --> 对URI 进行过滤

User-Agent过滤--> 对客户端的UA进行过滤

POST过滤-->对POST传递的参数进行过滤

Cookie过滤--> 对客户端传递的Cookie进行过滤

常见扫描器-->对已知的扫描器进行封锁

建议：保持默认即可，不建议修改;需要自定义规则时，建议添加新的规则，不建议改动原来的，全部支持正则表达式。

GET(GET-URL)

GET参数和GET-URL的区别

例如：/index.php?id=1&id2=1，id=1&id2=1是过滤的参数和值，index.php是URI。

那么GET参数过滤只会取GET传递的参数，进行判断是否是恶意的参数;而GET-URL这块主要拦截的是一个备份文件被非法下载、sql文件被下载等。

UA(User-Agent)过滤

这里是对用户的恶意UA 进行了拦截，例如拦截go的UA直接填入go即可，支持正则。

POST、Cookie过滤、常见扫描器

这里是对POST的传递参数、用户提交的Cookie进行过滤，常见扫描器是对扫描器的特征去匹配。

禁止境内外访问

字面意思，设置后可禁止境内或境外访问，用户可自行点击设置设置IP，境外IP库可同步云端。

注意：不建议两个都开启，两个都开启后只能本地访问。

From-data协议、HTTP包、蜘蛛池、URL关键词拦截、违禁词拦截、API接口防御

Webshell查杀-->动态查杀webshell

From-data协议-->针对文件上传格式传输数据进行规范

蜘蛛池--->蜘蛛IP进行整合

URL关键词拦截-->针对URL某些关键词进行拦截(不记录日志)

违禁词拦截-->针对用户传递的文字进行拦截，例如用户发帖的违禁词进行拦截

API接口防御-->针对已经加入白名单的接口进行单独防御

From-data协议

协议是multipart传输数据的一种格式规范，不符合规范的将会触发拦截。

HTTP包

默认拦截的HTTP日志只会记录1M 之内的记录，如果超过1M的HTTP包默认不会记录，如果您在日志中发现了大于1M的包希望记录它，您可以开启此功能。

注意：此功能默认关闭。

蜘蛛池

云端有存储百度、谷歌、360、搜狗、雅虎、必应、头条的蜘蛛池，除了这些，用户可以对蜘蛛池自行增删蜘蛛。

API接口防御

API防御指的是部分API在白名单的情况下有需要对某些接口进行CC防御，API书写格式例如：^/api/getuserinfo$，写法需注意一定得用^开头和$结尾。

模拟攻击

模拟攻击为：模拟黑客进行SQL注入获取数据库权限，不会影响业务的正常运行。

如果您的IP在IP白名单中测试则无效果。

如需测试其他的网站可使用(http://网站域名/?id=/etc/passwd)进行攻击。

返回拦截信息则表示拦截成功，如发现未拦截，建议更新至最新版。

导出导入配置

仅导出全局配置(CC配置、恶意容忍度配置、IP黑白名单、UA黑白名单、URL黑白名单、敏感文字替换、URL关键词拦截)，不包含站点配置。

GET、POST、URL、UA、Cookie仅导出响应码和开关状态，不包含内部规则。

建议使用复制或下载按钮，选中复制有可能遗漏密钥，导致导入或导出时失败。

恢复默认配置

将会清除所有配置、恢复到默认配置、包括URL黑白名单、IP黑白名单等所有规则项。

【站点设置】

站点设置页面将所有已有站点展示在此，可在此设置页面对某一个网站进行单独的规则设置。此页可直接对GET、POST、UA、Cookie、禁止境内外、CDN、CC防御以及主防御开关进行设置。

批量操作互动如下：开关Get拦截、开关Post拦截、开关UA操作、开关CC防御、开关Cookie拦截、开关禁国外拦截、开关禁国内拦截、开关CDN拦截、开关状态。

CDN选项

开启了云WFA，比如阿里云、云锁之类的第三方安全软件，需要开启CDN选项。兼容阿里云、又拍云、Cloud Flare、阿里云WAF、和其他的CDN。

另外，对于百度云CDN兼容方案如下：CDN设置-->开启兼容百度CDN-->即可获取百度云CDN传递过来的客户端真实IP。

注意：当网站部署了CDN之后，一定得开启CDN按钮，不然会拦截CDN的节点IP。

拦截记录

此页面将展示某个站点今日、昨日、近7天、近30天或自定义时间的拦截记录。

互动操作如下：

1.用户可点击IP加入IP黑名单;

2.用户可点击误报，将URL加入URL白名单;(慎点，确定需要点才点)

3.用户可查看请求的详情以及HTTP原文。

【设置】

禁止执行PHP的URL：禁止指定的URL运行PHP脚本

禁止访问的URL：禁止访问指定的URL

禁止扩展名：禁止访问指定的扩展名

禁止上传的文件类型：禁止上传指定的文件类型

受保护的URL

通过自定义参数加密URL地址，参数错误将被拦截。

支持正则表达式，可用于保护网站后台地址，API接口等非公众URI地址不被渗透，参数名与参数值对大小写敏感，设置受保护的URL，访问该URL时必需带有指定的参数名和参数值，否则将被防火墙拦截。

假设URI地址：^/admin/admin.php，参数名：test，参数值：bt.cn

正确的访问方式：/admin/admin.php?test=bt.cn

URL专用过滤

为特定URL地址设置过滤规则，可用于加强登录入口、回帖评论等接口的保护，快速修补第三方程序安全漏洞，参数名与参数值对大小写敏感。

注意：本过滤器同时作用于GET和POST参数。

防盗链

防盗链设置，默认允许资源被直接访问，即不限制HTTP_REFERER为空的请求，多个URL后缀与域名请使用英文状态下的逗号(,)隔开，如：png,jpeg,zip,js

当触发防盗链时，将直接返回404状态。

【木马查杀】

此页功能为：当前扫描内容为疑似木马文件，扫描方式基于当前规则库，可自行添加扫描规则。

扫描出来的文件，都需要使用宝塔检测与第三方检测来检测当前文件是否有问题，如有一方检测为webshell文件，请立即删除此问题。

另外需要特别注意：最终决定权在用户手上，可能当前的规则误报了您的文件，规则是死的人是活的，您需要自行检查文件代码是否真的有问题，如无问题，请点击误报。

【封锁记录】

此页面将展示每个站点的封锁记录，记录了有时间、IP、站点、封锁的原因、封锁时常等。

用户可互动操作如下

1.对拦截记录点击误报;

2.对拦截的IP进行拉黑;

3.解封当前拦截;

4.可查看拦截详情和HTTP请求;5.用户可选择每页展示多少条记录。

【操作日志】

此页面记录所有Nginx防火墙的功能性操作，比如设置CC规则、给某个IP添加了黑白名单、URL黑白名单等等，所有操作记录都会记录在此。

以上则是 宝塔面板Nginx网站防火墙使用说明的全部内容，希望对您有所帮助！