github
/
ngx_lua_waf
mirror of https://github.com/loveshell/ngx_lua_waf
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update README.md

distributed
loveshell 2013-03-27 09:36:51 +08:00
parent 1060a0b32f
commit f8cb5af58b
1 changed files with 7 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
README.md
View File

@ -1,26 +1,17 @@
##ngx_lua_waf ##ngx_lua_waf
ngx_lua_waf是我刚入职趣游时候开发的一个基于ngx_lua的web应用防火墙。 ngx_lua_waf是我刚入职趣游时候开发的一个基于ngx_lua的web应用防火墙。
代码很简单，开发初衷主要是使用简单，高性能和轻量级。 代码很简单，开发初衷主要是使用简单，高性能和轻量级。
现在开源出来.其中包含我们的过滤规则。如果大家有什么建议和想fa，欢迎和我一起完善。 现在开源出来.其中包含我们的过滤规则。如果大家有什么建议和想fa，欢迎和我一起完善。
###用途： ###用途：
用于过滤post，get，cookie方式常见的web攻击 用于过滤post，get，cookie方式常见的web攻击
防止sql注入，本地包含，部分溢出，fuzzing测试，xss,SSRF等web攻击 防止sql注入，本地包含，部分溢出，fuzzing测试，xss,SSRF等web攻击
防止svn/备份之类文件泄漏 防止svn/备份之类文件泄漏
防止ApacheBench之类压力测试工具的攻击 防止ApacheBench之类压力测试工具的攻击
屏蔽常见的扫描黑客工具，扫描器 屏蔽常见的扫描黑客工具，扫描器
屏蔽异常的网络请求 屏蔽异常的网络请求
屏蔽图片附件类目录php执行权限 屏蔽图片附件类目录php执行权限
防止webshell上传 防止webshell上传
###效果图如下： ###效果图如下：
@ -30,18 +21,14 @@ ngx_lua_waf是我刚入职趣游时候开发的一个基于ngx_lua的web应用
###推荐安装: ###推荐安装:
请自行给nginx安装ngx_lua模块，推荐lujit2.0做lua支持 请自行给nginx安装ngx_lua模块，推荐lujit2.0做lua支持
请提前新建/data/logs/hack/目录攻击日志，并赋予nginx用户对该目录的写入权限。 请提前新建/data/logs/hack/目录攻击日志，并赋予nginx用户对该目录的写入权限。
###配置文件添加： ###配置文件添加：
在http段添加 在http段添加
lua_need_request_body on;（开启post请求） lua_need_request_body on;（开启post请求）
init_by_lua_file /usr/local/nginx/conf/init.lua; init_by_lua_file /usr/local/nginx/conf/init.lua;
access_by_lua_file /usr/local/nginx/conf/waf.lua; access_by_lua_file /usr/local/nginx/conf/waf.lua;
编辑init.lua配置部分 编辑init.lua配置部分
@ -52,9 +39,7 @@ ngx_lua_waf是我刚入职趣游时候开发的一个基于ngx_lua的web应用
###规则更新： ###规则更新：
考虑到正则的缓存问题，动态规则会影响性能，所以暂没用共享内存字典和redis之类东西做动态管理。 考虑到正则的缓存问题，动态规则会影响性能，所以暂没用共享内存字典和redis之类东西做动态管理。
规则更新可以把规则文件放置到其他服务器，通过crontab任务定时下载来更新规则，nginx reload即可生效。以保障ngx lua waf的高性能 规则更新可以把规则文件放置到其他服务器，通过crontab任务定时下载来更新规则，nginx reload即可生效。以保障ngx lua waf的高性能
只记录过滤日志，不开启过滤，在代码里在check前面加上--注释即可，如果需要过滤，反之 只记录过滤日志，不开启过滤，在代码里在check前面加上--注释即可，如果需要过滤，反之
###一些说明： ###一些说明：
@ -62,13 +47,9 @@ ngx_lua_waf是我刚入职趣游时候开发的一个基于ngx_lua的web应用
过滤规则在wafconf下，可根据需求自行调整，每条规则需换行,或者用|分割 过滤规则在wafconf下，可根据需求自行调整，每条规则需换行,或者用|分割
global是全局过滤文件，里面的规则对post和get都过滤 global是全局过滤文件，里面的规则对post和get都过滤
get是只在get请求过滤的规则 get是只在get请求过滤的规则
post是只在post请求过滤的规则 post是只在post请求过滤的规则
whitelist是白名单，里面的url匹配到不做过滤 whitelist是白名单，里面的url匹配到不做过滤
user-agent是对user-agent的过滤规则 user-agent是对user-agent的过滤规则