Skip to content

disable

通过规则禁用 HTTPS、隐藏请求、终止请求等功能。

规则语法

txt
pattern disable://action1|action2|... [filters...]

# 等效于:
pattern disable://action1 disable://action2 ... [filters...]
参数描述详细文档
pattern匹配请求 URL 的表达式匹配模式文档
action具体动作,详见下面的说明
filters可选过滤器,支持匹配:
• 请求URL/方法/头部/内容
• 响应状态码/头部
过滤器文档
  • 301:禁止 301 跳转,301 强制转 302(也可以用 replaceStatus
  • abort:禁用 abort 功能,详见:enable
  • abortReq:禁用 abortReq 功能,详见:enable
  • abortRes:禁用 abortRes 功能,详见:enable
  • authCapture:禁用 authCapture 功能,详见:enable
  • auto2http:禁用 auto2http 功能,详见:enable
  • autoCors:使用 file 协议替换请求时,如果 Whistle 检测到该请求属于跨域请求,会自动添加必要的 CORS (跨域资源共享) 头信息,可以通过 disable://autoCors 禁用
  • ajax: 删除请求头 x-requested-with
  • bigData:禁用 bigData 功能,详见:enable
  • capturehttps:禁用 Enable HTTPS,详见:enable
  • captureIp:禁用 captureIp 功能,详见:enable
  • captureStream:禁用 captureStream 功能,详见:enable
  • clientCert:禁用 clientCert 功能,详见:enable
  • clientId:删除请求头 x-whistle-client-id
  • clientIp:删除请求头 x-forwarded-for
  • customParser:禁用 customParser 功能,详见:enable
  • cache: 禁用缓存
  • dnsCache: 禁止 DNS 缓存
  • csp: 禁用 CSP
  • cookies: 禁用请求和响应的 cookie
  • reqCookies: 禁用请求的 cookie
  • resCookies: 禁用响应的 cookie
  • flushHeaders:禁用 flushHeaders 功能,详见:enable
  • forHttp:禁用 forHttp 功能,详见:enable
  • forHttps:禁用 forHttps 功能,详见:enable
  • forceReqWrite:禁用 forceReqWrite 功能,详见:enable
  • forceResWrite: 禁用 forceResWrite 功能,详见:enable
  • gzip:禁止压缩响应内容
  • h2:禁用 h2 功能,详见:enable

    禁用:Whistle 代理 -xx-> 服务器启用 HTTP2

  • http2:禁用 http2 功能,详见:enable

    禁用:浏览器 -xx-> Whistle 代理 -xx-> 服务器全部启用 HTTP2

  • httpH2:禁用 httpH2 功能,详见:enable

    禁用:Whistle 代理 -xx-> 服务器的 HTTP 请求启用 HTTP2

  • hide:禁用 hide 功能,详见:enable
  • hideComposer:禁用 hideComposer 功能,详见:enable
  • hideCaptureError:禁用 hideCaptureError 功能,详见:enable
  • interceptConsole:禁用 interceptConsole 功能,详见:enable
  • internalProxy:禁用 internalProxy 功能,详见:enable
  • proxyFirst:禁用优先使用 proxy 规则
  • proxyHost:禁用 proxyHost 功能,详见:enable
  • proxyTunnel:禁用 proxyTunnel 功能,详见:enable
  • keepCSP:禁用 keepCSP 功能,详见:enable
  • keepAllCSP:禁用 keepAllCSP 功能,详见:enable
  • keepCache:禁用 keepCache 功能,详见:enable
  • keepAllCache:禁用 keepAllCache 功能,详见:enable
  • keepAlive:禁止缓存请求连接
  • keepClientId:禁用 keepClientId 功能,详见:enable
  • keepH2Session:无需每个 TUNNEL 连接对应一个 HTTP2 连接(默认 ,建议使用默认即可)
  • safeHtml:禁用 safeHtml 功能,详见:enable
  • strictHtml:禁用 strictHtml 功能,详见:enable
  • proxyConnection:通过 proxy、socks 等代理协议转发请求时设置 proxy-connection: close
  • ua: 删除请求头 user-agent
  • proxyUA:通过 proxy、socks 等代理协议转发请求时删除请求头 user-agent
  • referer: 禁用 referer
  • rejectUnauthorizedrejectUnauthorized 设置为 true
  • requestWithMatchedRules:禁用 requestWithMatchedRules 功能,详见:enable
  • responseWithMatchedRules:禁用 responseWithMatchedRules 功能,详见:enable
  • secureOptions:禁用建立 HTTP2 连接的默认 options
  • timeout:禁用请求超时设置
  • trailerHeader:删除响应头 trailer
  • trailers:删除 trailers
  • tunnelAuthHeader:删除代理鉴权头 proxy-authorization
  • tunnelHeadersFirst:禁用 tunnelHeadersFirst 功能,详见:enable
  • useLocalHost:禁用 useLocalHost 功能,详见:enable
  • useSafePort:禁用 useSafePort 功能,详见:enable
  • userLogin:禁用设置 statusCode://401 时显示登录框
  • weakRule:禁用 weakRule 功能,详见:enable

配置示例

txt
# 禁用请求的缓存,同时删除请求和响应头的缓存字段
# 跟 cache 协议的区别是,cache 只是用来设置响应的缓存头
wwww.example.com/path disable://cache

# 禁用请求和响应的 cookies
wwww.example.com/path disable://cookies

# 只禁用请求的 cookies
wwww.example.com/path disable://reqCookies

# 只禁用响应的 cookies
wwww.example.com/path disable://resCookies

# 删除 user-agent
wwww.example.com/path disable://ua

# 删除 referer
wwww.test.com/path disable://referer

# 删除csp策略
wwww.test.com/path disable://csp

# 禁用 timeout,默认情况下 Whistle 对每个请求如果 36s 内没有发生数据传输,会认为请求超时
wwww.test.com/path disable://timeout

# 把 301 转成 302,防止 cache
wwww.test.com/path disable://301

# 禁用 HTTPS 拦截
wwww.test.com/path disable://capture

# 不缓存 DNS 结果
wwww.test.com/path disable://dnsCache

# 禁用代理服务器请求链接复用
wwww.test.com/path disable://keepAlive

# 删除请求头 `x-requested-with`
wwww.test.com/path disable://ajax

# 也可以同时禁用多个
www.example.com/path disable://cache|cookies|ua|referer|csp|timeout|301|intercept|dnsCache|keepAlive|autoCors

关联操作:enable