配置方式

whistle的所有操作都可以通过配置实现,配置方式扩展于系统hosts配置方式(ip domain或组合方式ip domain1 domain2 domainN),具有更丰富的匹配模式及更灵活的配置方式。whistle的匹配顺序是从左到右,这与传统hosts从右到左的配置方式不同,但为了兼容传统hosts配置方式,除了pattern和operatorURI都可以为请求url外(这种情况whistle无法自动区分pattern和operatorURI,只能按约定的顺序匹配),其它情况whistle都支持配置两边的位置对调,即:pattern operatorURIoperatorURI pattern等价。

whistle跟传统hosts配置一样也采用#为注释符号

whistle有以下三种配置方式:

  1. 默认方式

    默认是将匹配模式写在左边,操作uri写在右边

    1. pattern operatorURI

    whistle将请求url与pattern匹配,如果匹配到就执行operatorURI对应的操作

  2. 传统方式

    传统方式指的是传统的hosts配置方式,操作URI写在左边

    1. operatorURI pattern

    如果pattern为路径或域名,且operatorURI为域名或路径

    1. www.test.com www.example.com/index.html
    2. http://www.test.com www.example.com/index.html

    这种情况下无法区分pattern和operatorURI,whistle不支持这种传统的方式,只支持默认方式

  3. 组合方式

    传统hosts的配置对多个域名对于同一个ip可以采用这种方式:

    1. 127.0.0.1 www.test1.com www.test2.com www.testN.com

    whistle完全兼容传统hosts配置方式,且支持更多的组合方式:

    1. # 传统组合方式
    2. pattern operatorURI1 operatorURI2 operatorURIN
    3. # 如果pattern部分为路径或域名,且operatorURI为域名或路径
    4. # 这种情况下也支持一个操作对应多个pattern
    5. operatorURI pattern1 pattern2 patternN

whistle v1.13.4及以上版本支持,配置换行:

  1. www.test.com file://(test) filter://*/cgi-bin
  2. # 等价于
  3. line`
  4. www.test.com file://(test)
  5. filter://*/cgi-bin
  6. `
  7. # 或
  8. line`
  9. www.test.com
  10. file://(test)
  11. filter://*/cgi-bin
  12. `

其中,pattern请参考:匹配模式