摘要:跨平台网络抓包调试工具简介是一款跨平台的网络抓包调试工具,基于开发。支持抓包,重放,替换,修改等方式来调试请求,也可以作为普通的代理。
whistle--跨平台网络抓包调试工具
[TOC]
简介whistle是一款跨平台的网络抓包调试工具,基于node开发。支持抓包,重放,替换,修改等方式来调试http(s),WebSocket请求,也可以作为普通的http代理。其功能和常用的fiddler(windows),Charles(Mac)工具功能相同,不过对于开发者更加友好,操作和调试更加方便,还支持node模块的插件。
快速上手 安装npm install -g whistle // 全局安装whistle启动
w2 start //启动whistle配置代理 (推荐使用浏览器插件)
127.0.0.1:8899配置规则
浏览器访问http://local.whistlejs.com 打开whistle界面,在rule里面配置:
jd.com 127.0.0.1 taobao.com 127.0.0.1 tmall.com 127.0.0.1
OK,就是这么简单
安装使用首先需要安装好node,官方推荐使用最新的LTS版本node
安装whistlenode环境配置成功后开始安装whistle,非root用户加sudo
npm install -g whistle
安装完成后,执行命令whistle help或者w2 help可以查看whistle的帮助信息,有输出则证明已安装成功
$ w2 help Usage: whistle启动whistle[options] Commands: run Start a front service start Start a background service stop Stop current background service restart Restart current background service help Display help information Options: -h, --help output usage information -D, --baseDir [baseDir] the base dir of config data -A, --ATS generate Root CA for iOS ATS (Node >= 6 is required) -z, --certDir [directory] custom certificate path -l, --localUIHost [hostname] local ui host (local.whistlejs.com by default) -n, --username [username] the username of whistle -w, --password [password] the password of whistle -N, --guestName [username] the guest name -W, --guestPassword [password] the guest password -s, --sockets [number] max sockets (60 by default) -S, --storage [newStorageDir] the new local storage directory -C, --copy [storageDir] copy storageDir to newStorageDir -c, --dnsCache [time] the cache time of DNS (30000ms by default) -H, --host [host] whistle listening host(:: or 0.0.0.0 by default) -p, --port [port] whistle listening port (8899 by default) -P, --uiport [uiport] whistle ui port (8900 by default) -m, --middlewares [script path or module name] express middlewares path (as: xx,yy/zz.js) -M, --mode [mode] the whistle mode (as: pureProxy|debug|multiEnv) -u, --uipath [script path] web ui plugin path -t, --timeout [ms] request timeout (66000 ms by default) -e, --extra [extraData] extra data for plugin -f, --secureFilter [secureFilter] the script path of secure filter -R, --reqCacheSize [reqCacheSize] the cache size of request data (512 by default) -F, --frameCacheSize [frameCacheSize] the cache size of socket frames (512 by default) -V, --version output the version number
新版本的whistle支持三种等价命令whistle,w2,wproxy
启动whistle
w2 start
重启whistle
w2 stop
停止whistle
w2 stop
启动调试模式(启动了一个前台服务,主要用于查看whistle的异常及插件开发)
w2 run配置代理
代理服务器,如果在本地则为127.0.0.1,如果部署在远程服务器或者虚拟机上,就改成对应IP即可。
默认端口为8899,如果端口被占用,要修改端口号,可以通过 -p来指定新的端口号
代理方式
直接配置系统代理
Windows
Mac
安装浏览器代理插件,推荐方式
Chrome插件:SwitchyOmega
Firefox插件: ProxySelector
移动端需要配置当前WIFI的代理
如何使用通过w2 start启动后,访问http://local.whistlejs.com 即可打开whistle界面。
所有通过whistle的篡改操作,都可以用过下面的配置方式实现
pattern operatorURL
pattern为匹配请求URL,支持域名,路径,正则,通配符等多种方式
operatorURI为对应的操作,由协议和值组成(operatorURL = opProtocol://opValue)
支持的协议类型:协议列表
PS; {value} 则对应工具栏Values下的文件
两边结合一下:
# 域名匹配IP www.example.com 127.0.0.1 # 带端口的域名匹配 www.example.com:6666 127.0.0.1 # 带协议的域名,支持:http、https、ws、wss、tunnel http://www.example.com 127.0.0.1 # 路径匹配,同样支持带协议、端口 www.example.com/test http://127.0.0.1:9090 https:/www.exapmle.com/test http://127.0.0.1:9090 https:/www.exapmle.com:6666/test http://127.0.0.1:9090 # 正则匹配 /^https?://www.example.com/test/(.*)/ referer://http://www.test.com/$1 # 通配符匹配 ^www.example.com/test/*** referer://http://www.test.com/$1功能详解
whistle功能概括:
pattern proxy://ip:port # 加用户名密码 pattern proxy://username:password@ip:port www.jd.com proxy://test:123@127.0.0.1:8888
pattern socks://ip:port # 加用户名密码 pattern socks://username:password@ip:port www.jd.com socks://test:123@127.0.0.1:8888
pattern pac://filepath /./ pac://https://raw.githubusercontent.com/imweb/node-pac/master/test/scripts/normal.pac
区别于正向代理,具体可参考 正向代理与反向代理
whistle作为反向代理只支持http访问,启动whistle时设置监听的端口为6060:
w2 start -p 6060 #或 w2 restart -p 6060
非root用户需要加sudo w2 start -p 6060。 根据域名、或路径、或正则表达式配置带端口的host:
localhost:6060/aa host://10.8.43.82:8080 localhost:6060/bb host://10.8.43.82:8081
这样访问localhost:6060的请求会自动转到8080或8181端口,实现无端口访问。 PS:如果要用IP访问,可以采用 http://127.0.0.1/-/xxx 或 http://127.0.0.1/_/xxx,whistle会自动转成 http://127.0.0.1/xxx
移动端调试移动端调试的时候需要在同一个局域网内,涉及到https的连接需要开启https拦截。
如果要拦截https和websockets请求,必须安装根证书和开启https拦截。
在工具栏=>https 下载 RootCA, 并勾选 intercept HTTPS CONNECTs 选项
具体参见:安装根证书
设置 => 无线局域网 => 找到对应局域网点击感叹号 => HTTP代理 配置代理 => 选择手动 => 填写whistle服务的IP和端口号
PS: 如果配置完代理,手机无法访问,可能是whistle所在的电脑防火墙限制了远程访问whistle的端口,关闭防火墙或者设置白名单: http://jingyan.baidu.com/arti...
whistle集成了weinre的功能,只需要简单配置pattern weinre://id即可使用。
然后点击工具栏的weinre,选择对应的ID打开weinre界面
相对于PC调试,移动端调试会常遇到以下问题
无法通过console输出错误,也无法看到页面的js报错
无法查看和修改页面的DOM和样式
无法debug
whistle可以通过类似console的log平台,来捕获页面的错误和log
www.jd.com log:// # 如果你想同时注入js脚本,可以用下面一种方式 # 在mac或linux中 www.jd.com log:////Users/willhu/work/whistle-test/log-test.js # 在windows中 www.jd.com log://D:xxx est.js # 直接从whistle的Values配置的key-value里面获取脚本 www.jd.com log://{log-test.js}
集成了weinre的功能,用户只需通过简单配置(pattern weinre://id)即可使用即可通过在pc上通过weinre修改网页的DOM结构及其样式,这里的ID只是一个分类,避免一个weinre调试页面出现太多链接
m.jd.com weinre://test-weinre
推荐腾讯的vConsole插件
m.jd.com js:///Users/willhu/work/whistle-test/vconsole.min.js
vConsole: https://github.com/Tencent/vC...
demo: vConsole
文件导入导出在network中右键点击请求列表,可以将请求的数据导出到txt.saz文件,也可导入txt.saz.har文件。
抓包重放在network中可以看到每条请求的详细情况。
打开network ==> 选中请求 ==> 右键选择replay
重构请求
可以自定义请求的URL、请求方法、请求头,请求内容
设置静态规则列表
pattern reqScript://filepath www.jd.com reqScript:///Users/willhu/work/whistle-test/rulelist.txt
rulelist.txt如果文件的第一行为规则的注释,即#开头则任务filepath指定的是规则列表,会加载该列表,并进行二次匹配获取规则
# rules pattern1 operatorURI1 pattern2 operatorURI2 patternN operatorURIN
通过脚本设置规则列表
www.jd.com reqScript://{rulelist.js}
支持两种配置方式,这样就不用查找本机的host文件了
ip pattern 或者 pattern host://ip
例子
# 传统hosts配置 127.0.0.1 www.example.com # 等价于: www.example.com 127.0.0.1 127.0.0.1 a.example.com b.example.com c.example.com # 支持带端口 127.0.0.1:8080 www.example.com # 等价于: www.example.com 127.0.0.1:8080 127.0.0.1:8080 a.example.com b.example.com c.example.com # 支持通过域名获取host,类似DNS的cname host://www.qq.com:8080 www.example.com # 等价于: www.example.com host://www.qq.com:8080 host://www.qq.com:8080 a.example.com b.example.com c.example.com # 支持通过正则表达式匹配 127.0.0.1:8080 /example.com/i # 等价于: /example.com/i 127.0.0.1:8080 127.0.0.1:8080 /example.com/ /test.com/ # 支持路径匹配 127.0.0.1:8080 example.com/test # 等价于: example.com/test 127.0.0.1:8080 127.0.0.1:8080 http://example.com:5555/index.html www.example.com:6666 https://www.test.com/test # 支持精确匹配 127.0.0.1:8080 $example.com/test # 等价于: $example.com/test 127.0.0.1:8080 127.0.0.1:8080 $http://example.com:5555/index.html $www.example.com:6666 $https://www.test.com/test
https://jd.com https://baidu.com/
配置方式如下:
pattern method://newMethod jd.com method://post
修改请求头,配置方式:
pattern reqHeaders://filepath jd.com reqHeaders://{reqHeaders.json}
把指定的内容替换请求内容(GET等请求没有内容没有替换一说),配置方式
pattern reqBody://filepath www.jd.com method://post reqBody://{test-reqBody.html}
把指定的内容添加到请求内容前面(GET等请求没有内容无法添加),配置方式:
pattern reqPrepend://filepath
延迟请求
pattern reqDelay://timeMS www.jd.com reqDelay://3000
设置速度
pattern reqSpeed://kbs www.jd.com reqSpeed://3
设置响应状态码(状态码范围100~999),请求会直接根据设置的状态码返回,不会请求到线上,配置方式:
pattern statusCode://code jd.com statusCode://404
方式同请求头
把指定的内容替换响应内容(304等响应没有内容无法替换),配置方式:
pattern resBody://filepath st.360buyimg.com/m/css/2014/layout/layout2015.css resBody://{myAppend.css}
把指定的内容追加到响应内容后面(304等响应没有内容无法追加),配置方式:
pattern resAppend://filepath st.360buyimg.com/m/css/2014/layout/layout2015.css resAppend://{myAppend.css}
延迟响应
pattern resDelay://timeMS www.jd.com resDelay://3000
设置速度
pattern resSpeed://kbs www.jd.com resSpeed://3插件扩展
有些很少用的功能,及一些跟业务相关的功能,考虑到会导致安装过程比较长或者占用内存空间或者适应范围比较小,whistle没有把这些功能加进去,但提供了插件的方式扩展这些功能。whistle本身就是一个Node模块,只需要按照whistle.xxx的形式命名即可。
编写whistle插件:如何编写插件
官方提供的插件列表:官方插件列表
socket和websocket利用whistle调试socket和webscoket
测试用的文件:whistle-test-files
测试用的rules: rules
整理的有些凌乱,如有不对之处,请指正,谢谢。
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/95046.html
摘要:所有域名下的请求,都会根据响应类型,将处理好的文本注入到响应内容里面,如是请求,和会分别自动加上和标签后追加到内容后面。查看请求响应的详细信息及请求列表的,还有请求匹配到的规则用来重发请求构造请求,可以自定义请求的请求方法请求头请求内容。 系列文章 真机联调常用方式和强大的Fiddlerwhistle真机调试 前言 之前发表过一篇文件关于真机调试的几种方式,但是都各自有些不便的地方,最...
摘要:本文由云社区发表绝大多数程序只考虑了接口正常工作的场景,而用户在使用我们的产品时遇到的各类异常,全都丢在看似的中。在面板,还可以对请求进行暂停延迟等网络异常的模拟。小程序实现最后,留一道思考题。 本文由云+社区发表 绝大多数程序只考虑了接口正常工作的场景,而用户在使用我们的产品时遇到的各类异常,全都丢在看似 ok 的 try catch 中。如果没有做好异常的兼容和兜底处理,会极大的影...
摘要:本文给大家介绍另一种防的方法。第三方请求开始前我们先了解一下第三方请求,什么样的请求被称为第三方请求简单来说就是在一个网页上发起一个不同源的请求,那么我们可以称为第三方请求。这一切都不需要做生命周期的管理,也不用担心会丢失或被中途被篡改。 前言 网站通常会使用 cookie 来记录用户的登录状态,但并非安全,因为 cookie 被允许在第三方网站(也不仅限于第三方)发起的请求中携带,因...
阅读 2944·2023-04-25 19:45
阅读 2657·2021-11-19 09:40
阅读 670·2021-10-14 09:49
阅读 2599·2021-09-30 09:47
阅读 2137·2021-09-26 09:55
阅读 1171·2021-09-22 16:01
阅读 2790·2019-08-30 14:19
阅读 685·2019-08-29 16:44