• headerReplace
    • 过滤规则

    headerReplace

    通过替换字符的方式修改请求或响应投稿,配置方式:

    1. # 通过替换的方式修改请求头
    2. pattern headerReplace://req.header-name:pattern1=replacement1&pattern2=replacement2
    3. # 通过替换的方式修改响应头
    4. pattern headerReplace://res.header-name:pattern3=replacement3

    pattern参见匹配模式,更多模式请参考配置方式。

    例子:

    1. www.test.com headerReplace://req.cookie:/a(.)/=$1&test=a%20bc headerReplace://res.set-cookie:/\bdomain=[^;]%2b(;|\s*$)/=

    上述是将所有 www.test.com 的请求头cookie字段里面的值的 ax 替换成 x 、test替换成 a bc注意:同时多个 str.replace(p1, r1).replace(p2, r2) 通过 & 分开,whistle会通过 querystring.parse的方式转成相应的对象 (会对 %xx 进行转义)正则里面的 + 号要用 %2b 代替

    过滤规则

    需要确保whistle是最新版本:更新whistle

    如果要过滤指定请求或指定协议的规则匹配,可以用如下协议:

    1. ignore:忽略指定规则
    2. filter:过滤指定pattern,支持根据请求方法、请求头、请求客户端IP过滤

    例子:

    1. # 下面表示匹配pattern的同时不能为post请求且请求头里面的cookie字段必须包含test(忽略大小写)、url里面必须包含 cgi-bin 的请求
    2. # 即:过滤掉匹配filter里面的请求
    3. pattern operator1 operator2 excludeFilter://m:post includeFilter://h:cookie=test includeFilter:///cgi-bin/i
    4. # 下面表示匹配pattern1、pattern2的请求方法为post、或请求头里面的cookie字段不能包含类似 `uin=123123` 且url里面必须包含 cgi-bin 的请求
    5. operator pattern1 pattern2 includeFilter://m:post excludeFilter://h:cookie=/uin=o\d+/i excludeFilter:///cgi-bin/i
    6. # 下面表示匹配pattern的请求忽略除了host以外的所有规则
    7. pattern ignore://*|!host
    8. # 下面表示匹配pattern的请求忽略file和host协议的规则
    9. pattern ignore://file|host