我的书签
添加书签
移除书签WAF规则操作符
WAF规则操作符是指被检查参数与对比值之间的对比方法。
规则操作符可以在添加规则和修改规则时在表单中选择。
数值大于
- 名称：数值大于
- 代号：
gt - 描述：使用数值对比大于，对比值需要是一个数字
示例
比如我们需要判断一个URL某个参数值大于10：
- 参数：
单个URL参数值 - [arg] - 参数名：
value - 操作符：
数值大于 - 对比值：
10
那么：
https://example.com/?value=11 // 匹配https://example.com/?value=10 // 不匹配https://example.com/?value=9 // 不匹配
数值大于等于
- 名称：数值大于等于
- 代号：
gte - 描述：使用数值对比大于等于，对比值需要是一个数字
示例
比如我们需要判断一个URL某个参数值大于等于10：
- 参数：
单个URL参数值 - [arg] - 参数名：
value - 操作符：
数值大于等于 - 对比值：
10
那么：
https://example.com/?value=11 // 匹配https://example.com/?value=10 // 匹配https://example.com/?value=9 // 不匹配
数值小于
- 名称：数值小于
- 代号：
lt - 描述：使用数值对比小于，对比值需要是一个数字
示例
比如我们需要判断一个URL某个参数值小于10：
- 参数：
单个URL参数值 - [arg] - 参数名：
value - 操作符：
数值小于 - 对比值：
10
那么：
https://example.com/?value=11 // 不匹配https://example.com/?value=10 // 不匹配https://example.com/?value=9 // 匹配
数值小于等于
- 名称：数值小于等于
- 代号：
lte - 描述：使用数值对比小于等于，对比值需要是一个数字
示例
比如我们需要判断一个URL某个参数值小于等于10：
- 参数：
单个URL参数值 - [arg] - 参数名：
value - 操作符：
数值小于等于 - 对比值：
10
那么：
https://example.com/?value=11 // 不匹配https://example.com/?value=10 // 匹配https://example.com/?value=9 // 匹配
数值等于
- 名称：数值等于
- 代号：
eq - 描述：使用数值对比等于，对比值需要是一个数字
示例
比如我们需要判断一个URL某个参数值等于10：
- 参数：
单个URL参数值 - [arg] - 参数名：
value - 操作符：
数值等于 - 对比值：
10
那么：
https://example.com/?value=abc // 不匹配https://example.com/?value=10abc // 不匹配https://example.com/?value=11 // 不匹配https://example.com/?value=10 // 匹配https://example.com/?value=10.123 // 不匹配https://example.com/?value=9 // 不匹配
数值不等于
- 名称：数值不等于
- 代号：
neq - 描述：使用数值对比不等于，对比值需要是一个数字
示例
比如我们需要判断一个URL某个参数值不等于10：
- 参数：
单个URL参数值 - [arg] - 参数名：
value - 操作符：
数值不等于 - 对比值：
10
那么：
https://example.com/?value=11 // 匹配https://example.com/?value=10 // 不匹配https://example.com/?value=9 // 匹配
字符串等于
- 名称：字符串等于
- 代号：
eq string - 描述：使用字符串对比等于
示例
比如我们需要判断一个URL路径中是否和 /js 字符串完全一样：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
字符串等于 - 对比值：
/js
那么：
https://example.com/js # 匹配https://example.com/js1 # 不匹配https://example.com/JS # 不匹配https://example.com/static/js # 不匹配
如果要允许 /JS 和 /Js 也都能匹配，可以设置规则中的 不区分大小写。
字符串不等于
- 名称：字符串不等于
- 代号：
neq string - 描述：使用字符串对比不等于
示例
比如我们需要判断一个URL路径中是否和 /js 字符串不一样：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
字符串等于 - 对比值：
/js
那么：
https://example.com/js # 不匹配https://example.com/js1 # 匹配https://example.com/JS # 匹配https://example.com/static/js # 匹配
如果要允许 /JS 和 /Js 也都不匹配，可以设置规则中的 不区分大小写。
正则匹配
- 名称：正则匹配
- 代号：
match - 描述：使用正则表达式匹配，在头部使用(?i)表示不区分大小写，正则表达式语法
示例1
比如我们需要判断一个URL路径中是否包含 /script 或 js：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
正则匹配 - 对比值：
/script|/js（用|符号表示或的关系）
那么：
https://example.com/js # 匹配https://example.com/script # 匹配https://example.com/static/script/search # 匹配https://example.com/static/javascript # 匹配，包含了 scripthttps://example.com/static/scriptfiles # 匹配，包含了 scripthttps://example.com/static/scr # 不匹配https://example.com/static/SCRIPT # 不匹配
如果要允许 /SCRIPT 和 /JS 也都匹配，可以设置规则中的 不区分大小写。
示例2
比如我们需要判断用户的User-Agent中是否包含一些常用的手机浏览器标识：
- 参数：
客户端信息 - [userAgent] - 操作符：
正则匹配 - 对比值：
iPhone|iPad|Android（用|符号表示或的关系）
那么：
Mozilla/5.0 (iPad; CPU OS 12_2 like Mac OS X) AppleWebKit/605.1.15 # 匹配Mozilla/5.0 (iPhone; CPU iPhone OS 16_2 like Mac OS X) AppleWebKit/605.1.15 # 匹配Mozilla/5.0 (Linux; Android 13) AppleWebKit/537.36 # 匹配Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/605.1.15 # 不匹配
如果要允许 iphone 和 android 也都匹配，可以设置规则中的 不区分大小写。
正则不匹配
- 名称：正则不匹配
- 代号：
not match - 描述：使用正则表达式不匹配，在头部使用(?i)表示不区分大小写，正则表达式语法
示例
比如我们需要判断一个URL路径中是否不包含 /script 或 js：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
正则不匹配 - 对比值：
/script|/js（用|符号表示或的关系）
那么：
https://example.com/js # 不匹配https://example.com/script # 不匹配https://example.com/static/script/search # 不匹配https://example.com/static/javascript # 不匹配，包含了 scripthttps://example.com/static/scriptfiles # 不匹配，包含了 scripthttps://example.com/static/scr # 匹配https://example.com/static/SCRIPT # 匹配
如果要允许 /SCRIPT 和 /JS 也都不匹配，可以设置规则中的 不区分大小写。
包含字符串
- 名称：包含字符串
- 代号：
contains - 描述：包含某个字符串，比如Hello World包含了World；每个规则只能填入一个被包含字符串；不能使用正则表达式
示例
比如我们需要判断一个URL路径中是否包含 /js：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
包含字符串 - 对比值：
/js
那么：
https://example.com/js # 匹配https://example.com/static/js/search # 匹配https://example.com/static/jscripts # 匹配，包含了 jshttps://example.com/static/JS # 不匹配https://example.com/static/sj # 不匹配
如果要允许 /JS 和 /Js 也都匹配，可以设置规则中的 不区分大小写。
不包含字符串
- 名称：不包含字符串
- 代号：
not contains - 描述：不包含某个字符串，比如Hello字符串中不包含Hi；每个规则只能填入一个被检查字符串；不能使用正则表达式
示例
比如我们需要判断一个URL路径中是否不包含 /js：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
不包含字符串 - 对比值：
/js
那么：
https://example.com/js # 不匹配https://example.com/static/js/search # 不匹配https://example.com/static/jscripts # 不匹配，包含了 jshttps://example.com/static/JS # 匹配https://example.com/static/sj # 匹配
如果要允许 /JS 和 /Js 也都不匹配，可以设置规则中的 不区分大小写。
包含任一字符串
- 名称：包含任一字符串
- 代号：
contains any - 描述：包含字符串列表中的任意一个，比如/hello/world包含/hello和/hi中的/hello，每行一个字符串
示例
比如我们需要判断一个URL路径中是否包含 /js 或 /script：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
包含任一字符串 对比值：使用换行隔开多个值：
/js/script
那么：
https://example.com/js # 匹配https://example.com/static/js/search # 匹配https://example.com/static/jscripts # 匹配，包含了 js和scripthttps://example.com/static/script # 匹配，包含了 scripthttps://example.com/static/JS # 不匹配https://example.com/static/sj # 不匹配
如果要允许 /SCRIPT 和 /Js 也都匹配，可以设置规则中的 不区分大小写。
包含所有字符串
- 名称：包含所有字符串
- 代号：
contains all - 描述：包含字符串列表中的所有字符串，比如/hello/world必须包含/hello和/world，每行一个字符串
示例
比如我们需要判断一个URL路径中是否同时包含 /js 和 /script：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
包含所有字符串 对比值：使用换行隔开多个值：
/js/script
那么：
https://example.com/js # 不匹配https://example.com/static/js/search # 不匹配https://example.com/js/script # 匹配，同时包含了 js和scripthttps://example.com/static/jscripts # 匹配，同时包含了 js和scripthttps://example.com/static/script # 不匹配https://example.com/static/JS # 不匹配https://example.com/static/sj # 不匹配
如果要允许 /JS/SCRIPT 也都匹配，可以设置规则中的 不区分大小写。
包含前缀
- 名称：包含前缀
- 代号：
prefix - 描述：包含字符串前缀部分，比如/hello前缀会匹配/hello, /hello/world等；每个规则只能填入一个前缀；不能使用正则表达式
示例
比如我们需要判断一个URL路径中是否以 /js 开头：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
包含前缀 - 对比值：
/js
那么：
https://example.com/js # 匹配https://example.com/static/js/search # 不匹配https://example.com/static/JS # 不匹配https://example.com/static/sj # 不匹配
如果要允许 /JS 和 /Js 也都匹配，可以设置规则中的 不区分大小写。
包含后缀
- 名称：包含后缀
- 代号：
suffix - 描述：包含字符串后缀部分，比如/hello后缀会匹配/hello, /hi/hello等；每个规则只能填入一个前缀；不能使用正则表达式
示例
比如我们需要判断一个URL路径中是否以 /js 结尾：
- 参数：
请求路径 - [requestPath]（因为这里我们不需要判断域名，所以没有使用请求完整URL） - 操作符：
包含后缀 - 对比值：
/js
那么：
https://example.com/js # 匹配https://example.com/static/js # 匹配https://example.com/js/search # 不匹配https://example.com/static/JS # 不匹配https://example.com/static/sj # 不匹配
如果要允许 /JS 和 /Js 也都匹配，可以设置规则中的 不区分大小写。
包含二进制数据
- 名称：包含二进制数据
- 代号：
contains binary - 描述：包含一组二进制数据
不包含二进制数据
- 名称：不包含二进制数据
- 代号：
not contains binary - 描述：不包含一组二进制数据
包含索引
- 名称：包含索引
- 代号：
has key - 描述：对于一组数据拥有某个键值或者索引
版本号大于
- 名称：版本号大于
- 代号：
version gt - 描述：对比版本号大于
版本号小于
- 名称：版本号小于
- 代号：
version lt - 描述：对比版本号小于
版本号范围
- 名称：版本号范围
- 代号：
version range - 描述：判断版本号在某个范围内，格式为version1,version2
IP等于
- 名称：IP等于
- 代号：
eq ip - 描述：将参数转换为IP进行对比，只能对比单个IP
在一组IP中
- 名称：在一组IP中
- 代号：
in ip list - 描述：判断参数IP在一组IP内，每行一个IP
示例
比如我们需要判断客户端地址是否在一组IP内：
- 参数：
客户端地址（IP）- [remoteAddr] - 操作符：
在一组IP中 对比值：填入多行，每行一个IP：
192.168.2.40192.168.3.50192.168.4.100
那么：
192.168.2.40 # 匹配192.168.3.50 # 匹配192.168.4.100 # 匹配192.168.2.101 # 不匹配192.168.1.100 # 不匹配
IP大于
- 名称：IP大于
- 代号：
gt ip - 描述：将参数转换为IP进行对比
IP大于等于
- 名称：IP大于等于
- 代号：
gte ip - 描述：将参数转换为IP进行对比
IP小于
- 名称：IP小于
- 代号：
lt ip - 描述：将参数转换为IP进行对比
IP小于等于
- 名称：IP小于等于
- 代号：
lte ip - 描述：将参数转换为IP进行对比
IP范围
注意：在GoEdge v0.6.0以前，”IP范围”操作符对比值中只能填写单个IP范围；在v0.6.0以后可以填写多个IP范围，每行一个。
- 名称：IP范围
- 代号：
ip range - 描述：IP在某个范围之内，范围格式可以是英文逗号分隔的
开始IP,结束IP，比如192.168.1.100,192.168.2.200；或者CIDR格式的ip/bits，比如192.168.2.1/24；或者单个IP。可以填写多行，每行一个IP范围。
示例1 - CIDR
比如我们需要判断客户端地址是否在一个范围内：
- 参数：
客户端地址（IP）- [remoteAddr] - 操作符：
IP范围 - 对比值：
192.168.2.1/24
那么：
192.168.2.40 # 匹配192.168.1.100 # 不匹配
示例2 - IP段
比如我们需要判断客户端地址是否在一个范围内：
- 参数：
客户端地址（IP）- [remoteAddr] - 操作符：
IP范围 - 对比值：
192.168.2.1,192.168.2.100（表示从192.168.2.1到192.168.2.100）
那么：
192.168.2.40 # 匹配192.168.2.101 # 不匹配192.168.1.100 # 不匹配
对比值也可以用中划线分隔，类似于192.168.2.1-192.168.2.100。
示例3 - 多个IP
比如我们需要判断客户端地址是否在一组范围内：
- 参数：
客户端地址（IP）- [remoteAddr] - 操作符：
IP范围 对比值：填入多行，既可以是CIDR格式，也可以是IP段，还可以是单个IP：
192.168.2.40192.168.3.1/24192.168.4.100-192.168.4.200
那么：
192.168.2.40 # 匹配192.168.3.50 # 匹配192.168.4.100 # 匹配192.168.2.101 # 不匹配192.168.1.100 # 不匹配
不在IP范围
注意：在GoEdge v0.6.0以前，”不在IP范围”操作符对比值中只能填写单个IP范围；在v0.6.0以后可以填写多个IP范围，每行一个。
- 名称：不在IP范围
- 代号：
not ip range - 描述：IP不在某个范围之内，范围格式可以是英文逗号分隔的
开始IP,结束IP，比如192.168.1.100,192.168.2.200；或者CIDR格式的ip/bits，比如192.168.2.1/24；或者单个IP。可以填写多行，每行一个IP范围。
具体示例请参考本文的 IP范围。
IP取模10
- 名称：IP取模10
- 代号：
ip mod 10 - 描述：对IP参数值取模，除数为10，对比值为余数
IP取模100
- 名称：IP取模100
- 代号：
ip mod 100 - 描述：对IP参数值取模，除数为100，对比值为余数
IP取模
- 名称：IP取模
- 代号：
ip mod - 描述：对IP参数值取模，对比值格式为：除数,余数，比如10,1
