匹配原则

whistle的协议比较多,具体参见:协议列表,这些协议的匹配优先级及同时可匹配规则个数遵循以下四个原则:

  1. 相同协议规则的默认优先级从上到下,即前面的规则优先级匹配高于后面,如:

    1. www.test.com 127.0.0.1:9999
    2. www.test.com/xxx 127.0.0.1:8080

    请求 https://www.test.com/xxx/index.html 按从上到下的匹配顺序,只会匹配 www.test.com 127.0.0.1:9999,这个与传统的hosts配置后面优先的顺序相反。

    如果想跟系统hosts匹配顺序一致,可以在界面通过 Rules -> Settings -> Back rules first 修改,但这个规则只对在页面里面配置的规则生效,对插件里面自带的规则及通过@方式内联的远程规则不生效。

  2. ruleproxy对应规则除外,可以同时匹配不同协议的规则
    1. www.test.com 127.0.0.1:9999
    2. www.test.com/xxx 127.0.0.1:8080
    3. www.test.com proxy://127.0.0.1:8888
    4. www.test.com/xxx socks://127.0.0.1:1080
    5. www.test.com pac://http://www.pac-server.com/test.pac
    6. www.test.com/xxx http://www.abc.com
    7. www.test.com file:///User/xxx/test
    请求 https://www.test.com/xxx/index.html 按从上到下的匹配顺序,及第二点原则,会匹配以下规则:
    1. www.test.com 127.0.0.1:9999
    2. www.test.com proxy://127.0.0.1:8888
    3. www.test.com pac://http://www.pac-server.com/test.pac
    4. www.test.com/xxx http://www.abc.com

    proxyhttp-proxyhttps-proxysocks都属于proxyhtmlfile等都属于rule,所以这两个对应的协议只能各种匹配其中优先级最高的一个。

  3. 一些属于不同协议,但功能有冲突的规则,如 rulehostproxy,按常用优先级为 rule > host > proxy,如:
    1. www.test.com 127.0.0.1:9999
    2. www.test.com/xxx 127.0.0.1:8080
    3. www.test.com proxy://127.0.0.1:8888
    4. www.test.com/xxx socks://127.0.0.1:1080
    5. www.test.com file:///User/xxx/test
    6. www.test.com/xxx http://www.abc.com
    上述同时匹配filehostproxy,但只会执行本地替换file
  4. 部分相同协议会匹配及合并所有可以匹配的规则,如:
    1. www.test.com 127.0.0.1:9999
    2. www.test.com/xxx 127.0.0.1:8080
    3. www.test.com proxy://127.0.0.1:8888
    4. www.test.com/xxx socks://127.0.0.1:1080
    5. www.test.com pac://http://www.pac-server.com/test.pac
    6. www.test.com/xxx http://www.abc.com
    7. www.test.com file:///User/xxx/test
    8. www.test.com/xxx reqHeaders://{test.json}
    9. www.test.com reqHeaders:///User/xxx/test.json
    10. www.test.com/xxx htmlAppend:///User/xxx/test.html
    11. www.test.com htmlAppend://{test.html}
    12. www.test.com/xxx reqHeaders:///User/xxx/test2.json
    13. www.test.com htmlAppend://{test2.html}
    请求 https://www.test.com/xxx/index.html 会匹配以下规则:
    1. www.test.com 127.0.0.1:9999
    2. www.test.com proxy://127.0.0.1:8888
    3. www.test.com pac://http://www.pac-server.com/test.pac
    4. www.test.com/xxx http://www.abc.com
    5. www.test.com/xxx reqHeaders://{test.json}
    6. www.test.com reqHeaders:///User/xxx/test.json
    7. www.test.com/xxx htmlAppend:///User/xxx/test.html
    8. www.test.com htmlAppend://{test.html}
    9. www.test.com/xxx reqHeaders:///User/xxx/test2.json
    10. www.test.com htmlAppend://{test2.html}
    其中,所有匹配的reqHeaders协议的规则会将其对应的json合并后再合并到请求headers里,而所有匹配htmlAppend的html内容会通过换行符 \n 合并并追加到响应的html内容里面,其它可以合并的协议如下(主要涉及json、注入内容、属性设置对应的协议):