List

list 适配器能够用来执行简单的黑白名单校验工作。可以把列表内容直接配置到适配器中,也可以要求适配器在指定 URL 中抓取列表内容。列表元素可以是简单的字符串、IP 地址或者正则表达式。

该适配器支持 listentry 模板

参数

list 适配器的配置格式。

字段类型描述
providerUrlstring从哪里找到列表内容进行检查。如果使用本地列表,则可以省略该字段
refreshIntervalgoogle.protobuf.Duration用于更新列表的频率
ttlgoogle.protobuf.Duration列表的生效时间。一般来说 TTL 的值应该明显(两倍以上)超过 refreshInterval,从而确保操作的持续性
cachingIntervalgoogle.protobuf.Duration该适配器的调用者可以将一个查询结果写入本地缓存,在这一字段所规定的时间之内无需再次向适配器进行查询
cachingUseCountint32该适配器的调用者可以将一个查询结果写入本地缓存,在这一字段所规定的次数之内无需再次向适配器进行查询
overridesstring[]在处理来自服务器的列表之前,首先查询该列表
entryTypeListEntryType决定列表的类型
blacklistbool如果为真,这一列表的操作符就是是黑名单,反之则是白名单

ListEntryType

列表的类型。

字段描述
STRINGS普通字符串列表
CASE_INSENSITIVE_STRINGS不区分大小写的字符串列表
IP_ADDRESSESIP 地址和范围的列表
REGEXre2 规范的正则表达式