You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ngx_lua_waf/README.md

2.6 KiB

##ngx_lua_waf

ngx_lua_waf是我刚入职趣游时候开发的一个基于ngx_lua的web应用防火墙。

代码很简单,开发初衷主要是使用简单,高性能和轻量级。

现在开源出来.其中包含我们的过滤规则。如果大家有什么建议和想fa欢迎和我一起完善。

###用途:

防止sql注入本地包含部分溢出fuzzing测试xss,SSRF等web攻击
防止svn/备份之类文件泄漏
防止ApacheBench之类压力测试工具的攻击
屏蔽常见的扫描黑客工具,扫描器
屏蔽异常的网络请求
屏蔽图片附件类目录php执行权限
防止webshell上传

###效果图如下:

sec

###推荐安装:

请自行给nginx安装ngx_lua模块需要lujit做lua支持

请提前新建/data/logs/hack/目录攻击日志并赋予nginx用户对该目录的写入权限。

###配置部分:

编辑init.lua配置部分
logpath='/data/logs/hack/'
rulepath='/usr/local/nginx/conf/wafconf/'
syslogserver='127.0.0.1'
如果需要开启syslog传输请取消掉log函数部分的注释

在nginx.conf的http段添加
lua_need_request_body on;开启post请求	
init_by_lua_file  /usr/local/nginx/conf/init.lua; 
access_by_lua_file /usr/local/nginx/conf/waf.lua;

注意:第一次安装配置好需要重启nginx

###规则更新:

考虑到正则的缓存问题动态规则会影响性能所以暂没用共享内存字典和redis之类东西做动态管理。

规则更新可以把规则文件放置到其他服务器通过crontab任务定时下载来更新规则nginx reload即可生效。以保障ngx lua waf的高性能。

只记录过滤日志不开启过滤在代码里在check前面加上--注释即可,如果需要过滤,反之

###一些说明:

过滤规则在wafconf下可根据需求自行调整每条规则需换行,或者用|分割

	global是全局过滤文件里面的规则对post和get都过滤		
	get是只在get请求过滤的规则		
	post是只在post请求过滤的规则		
	whitelist是白名单里面的url匹配到不做过滤		
	user-agent是对user-agent的过滤规则


默认开启了get和post过滤需要开启cookie过滤的编辑waf.lua取消部分--注释即可

日志文件名称格式如下:虚拟主机名_sec.log

###关于

欢迎大家到http://bbs.linuxtone.org 多多交流

weibo: @ppla

感谢ngx_lua模块的开发者@agentzh,春哥是我所接触过开源精神最好的人